CREATE NOTIFICATION INTEGRATION (saída para um tópico do Amazon SNS)¶

Sintaxe¶

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  ENABLED = { TRUE | FALSE }
  TYPE = QUEUE
  DIRECTION = OUTBOUND
  NOTIFICATION_PROVIDER = AWS_SNS
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'
  [ COMMENT = '<string_literal>' ]

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.

DIRECTION = OUTBOUND

Especifica que o Snowflake produz a notificação enviada ao serviço de mensagens em nuvem.

NOTIFICATION_PROVIDER = AWS_SNS

Especifica o Amazon Simple Notification Service (SNS) como o serviço de enfileiramento de mensagens em nuvem de terceiros.

AWS_SNS_TOPIC_ARN = 'topic_arn'

Amazon Resource Name (ARN) do tópico Amazon SNS (SNS) para as notificações são enviadas.

AWS_SNS_ROLE_ARN = 'iam_role_arn'

ARN da função IAM que tem permissões para publicar mensagens para o tópico SNS.

Nota

O valor de AWS_SNS_ROLE_ARN diferencia maiúsculas de minúsculas. Utilize o valor exato especificado em sua conta AWS.

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:

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¶

• O uso da mesma integração de notificação de saída para vários canais é suportada para notificações por push.

• 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 AWS GovCloud (US).

Exemplos¶

Veja os seguintes tópicos:

• Habilitação de notificações de erro do Snowpipe para o Amazon SNS

• Habilitação de notificações de erro para tarefas usado AWS SNS

• Criação de uma integração de notificação para enviar notificações para tópico do Amazon SNS