ALTER NOTIFICATION INTEGRATION

修改现有通知集成的属性。

另请参阅：

CREATE NOTIFICATION INTEGRATION、DROP INTEGRATION、SHOW INTEGRATIONS

语法

自动数据加载或元数据刷新

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]
Copy

推送通知

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  cloudProviderParamsPush
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]
Copy
其中：
cloudProviderParamsPush (for Amazon Simple Notification Service) ::=
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'
Copy
cloudProviderParamsPush (for Google Pub/Sub) ::=
  GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'
Copy
cloudProviderParamsPush (for Microsoft Azure Event Grid) ::=
  AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_URL>'
  AZURE_TENANT_ID = '<directory_ID>';
Copy

电子邮件通知

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  [ ALLOWED_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_SUBJECT = '<subject_line>' ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> UNSET
  ALLOWED_RECIPIENTS |
  DEFAULT_RECIPIENTS |
  DEFAULT_SUBJECT
  COMMENT
Copy

参数

name

要更改的集成的标识符。如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

SET ...

指定要为表设置的一个或多个属性/参数（用空格、逗号或新行分隔）：

ENABLED = { TRUE | FALSE }

指定是启动集成操作还是暂停集成操作。

  • TRUE：启用集成。

  • FALSE：暂停集成以进行维护。Snowflake 与第三方服务之间的任何集成都无法正常工作。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

指定 标签 名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅 对象和列的标签配额。

ALLOWED_RECIPIENTS=('email_address' [, ... 'email_address'])

（对于 TYPE = EMAIL）用逗号分隔的引用电子邮件地址列表，这些地址可接收来自此集成的通知电子邮件。

您必须指定当前账户中用户的电子邮件地址。这些用户必须 验证其电子邮件地址。

您可以指定的最大电子邮件地址数为 50。

如果省略此参数，则可以向当前账户中经过验证的所有电子邮件地址发送电子邮件通知。

DEFAULT_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )

指定通过此集成发送的邮件的默认收件人列表。使用逗号分隔的带引号的电子邮件地址列表来指定默认收件人。

您必须指定当前账户中用户的电子邮件地址。这些用户必须验证其电子邮件地址。

要替换给定邮件的默认收件人，请在调用 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION 存储过程时使用 EMAIL_INTEGRATION_CONFIG 帮助程序函数。

DEFAULT_SUBJECT = 'subject_line'

指定通过此集成发送的邮件的默认主题行。

主题长度不能超过 256 个字符。

默认：“Snowflake 电子邮件通知”

要替换给定邮件的默认主题行，请在调用 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION 存储过程时使用 EMAIL_INTEGRATION_CONFIG 帮助程序函数。

COMMENT = 'string_literal'

字符串（字面量），用于指定集成注释。

UNSET ...

指定要为 API 集成取消设置的一个或多个属性/参数，这会将它们重置回默认值：

  • ENABLED

  • TAG tag_name [ , tag_name ... ]

  • ALLOWED_RECIPIENTS

  • DEFAULT_RECIPIENTS

  • DEFAULT_SUBJECT

  • COMMENT

推送通知的云提供商参数 (cloudProviderParamsPush)

请参阅 CREATE NOTIFICATION INTEGRATION 的 推送通知的云提供商参数 (cloudProviderParamsPush) 部分中对这些参数的说明。

使用说明

  • 关于元数据：

    注意

    客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

  • 禁用或删除集成可能不会立即生效，因为集成可能会被缓存。建议移除云提供商的集成权限，以便尽快生效。

示例

以下示例启动了已暂停的集成的操作：

ALTER NOTIFICATION INTEGRATION myint SET ENABLED = TRUE;

ALTER NOTIFICATION INTEGRATION myint UNSET COMMENT;
Copy
语言: 中文