CREATE NOTIFICATION INTEGRATION（出站到 Azure 事件网格主题）

在账户中创建新的通知集成或替换现有集成，以便 向 Azure Event Grid 主题发送消息。

备注

目前，该功能仅限于 Microsoft Azure 上托管的 Snowflake 账户。

另请参阅：

ALTER NOTIFICATION INTEGRATION（出站到 Azure 事件网格主题）、DESCRIBE INTEGRATION、DROP INTEGRATION、SHOW INTEGRATIONS

语法

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  ENABLED = { TRUE | FALSE }
  TYPE = QUEUE
  DIRECTION = OUTBOUND
  NOTIFICATION_PROVIDER = AZURE_EVENT_GRID
  AZURE_EVENT_GRID_TOPIC_ENDPOINT = '<event_grid_topic_endpoint>'
  AZURE_TENANT_ID = '<ad_directory_id>';
  [ COMMENT = '<string_literal>' ]
Copy

必填参数

name

字符串，指定集成的标识符（即名称）；在账户中必须是唯一的。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

ENABLED = { TRUE | FALSE }

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

  • TRUE 启用集成。

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

TYPE = QUEUE

指定这是 Snowflake 与第三方云消息队列服务之间的集成。

DIRECTION = OUTBOUND

指定 Snowflake 生成发送到云消息传递服务的通知。

NOTIFICATION_PROVIDER = AZURE_EVENT_GRID

将 Microsoft Azure 事件网格指定为第三方云消息队列服务。

AZURE_EVENT_GRID_TOPIC_ENDPOINT = 'event_grid_topic_endpoint'

Snowflake 将通知推送到的事件网格主题端点。

AZURE_TENANT_ID = 'ad_directory_id'

用于身份管理的 Azure Active Directory 租户的 ID。需要此 ID 才能生成允许 Snowflake 访问事件网格主题的同意 URL。

可选参数

COMMENT = 'string_literal'

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

默认：无值

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

CREATE INTEGRATION

账户

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 推送通知支持对多个管道使用相同的出站通知集成。

  • 关于元数据：

    注意

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

  • CREATE OR REPLACE <object> 语句是原子的。也就是说，当对象被替换时，旧对象将被删除，新对象将在单个事务中创建。

  • 云提供商的政府区域不允许向或从其他商业区域发送事件通知。有关更多信息，请参阅 Azure Government (https://learn.microsoft.com/en-us/azure/azure-government/)。

示例

请参阅以下主题：

语言: 中文