CREATE NOTIFICATION INTEGRATION (entrada de um tópico do Azure Event Grid)

Cria uma nova integração de notificação na conta ou substitui uma integração existente para receber mensagens de um tópico do Azure Event Grid.

Consulte também:

ALTER NOTIFICATION INTEGRATION (entrada de um tópico do Azure Event Grid), DESCRIBE INTEGRATION, DROP INTEGRATION, SHOW INTEGRATIONS

Sintaxe

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  ENABLED = { TRUE | FALSE }
  TYPE = QUEUE
  NOTIFICATION_PROVIDER = AZURE_STORAGE_QUEUE
  AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_url>'
  AZURE_TENANT_ID = '<ad_directory_id>';
  [ COMMENT = '<string_literal>' ]
Copy

Parâmetros obrigatórios

name

Cadeia de caracteres que especifica o identificador (ou seja, nome) para a integração; deve ser única em sua conta.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

ENABLED = { TRUE | FALSE }

Especifica se deve iniciar a operação da integração ou suspendê-la.

  • TRUE permite a integração.

  • FALSE desabilita a integração para manutenção. Qualquer integração entre o Snowflake e um serviço de terceiro não funciona.

TYPE = QUEUE

Especifica que esta é uma integração entre o Snowflake e um serviço de enfileiramento de mensagens em nuvem de terceiros.

NOTIFICATION_PROVIDER = AZURE_STORAGE_QUEUE

Especifica o Microsoft Azure Event Grid como o serviço de enfileiramento de mensagens em nuvem de terceiros.

AZURE_STORAGE_QUEUE_PRIMARY_URI = 'queue_url

Especifica a URL da fila para a fila do Armazenamento de Filas do Azure criada para as notificações do Event Grid. Use um URL no seguinte formato:

https://storage_queue_account.queue.core.windows.net/storage_queue_name

Nota

Uma única integração de notificação oferece suporte para uma única fila de armazenamento do Azure. A referência à mesma fila de armazenamento em múltiplas integrações de notificação pode resultar na ausência de dados nas tabelas de destino porque as notificações de eventos são divididas entre as integrações de notificação.

AZURE_TENANT_ID = 'ad_directory_id'

Especifica a ID do locatário do Azure Active Directory utilizado para a gestão da identidade. Este ID é necessário para gerar o URL de consentimento que concede ao Snowflake acesso à assinatura da notificação do Event Grid.

Parâmetros opcionais

COMMENT = 'string_literal'

Cadeia de caracteres (literal) que especifica um comentário da integração.

Padrão: sem valor

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio

Objeto

Notas

CREATE INTEGRATION

Conta

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

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Não há suporte para a criação de uma única integração de notificação para várias filas do Armazenamento do Microsoft Azure.

    Quando você cria um novo canal usando uma integração de notificação com o mesmo URL da fila de outra integração de notificação, a criação do canal falha com um erro:

    Notification queue already in use with another integration.

  • O uso da mesma fila do Armazenamento do Microsoft Azure para múltiplas integrações de notificação de entrada não é compatível para cargas de dados automatizadas ou atualizações de metadados.

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

  • As regiões governamentais dos provedores de nuvem não permitem o envio de notificações de eventos de ou para outras regiões comerciais. Para obter mais informações, consulte Azure Government.

Exemplos

Veja os seguintes tópicos:

Linguagem: Português