CREATE NOTIFICATION INTEGRATION (e-mail)

Cria uma nova integração de notificação na conta ou substitui uma integração existente para enviar mensagens de e-mail.

Consulte também:

ALTER NOTIFICATION INTEGRATION (e-mail), DESCRIBE INTEGRATION, DROP INTEGRATION, SHOW INTEGRATIONS

Sintaxe

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  TYPE = EMAIL
  ENABLED = { TRUE | FALSE }
  [ ALLOWED_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_SUBJECT = '<subject_line>' ]
  [ 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 = EMAIL

Especifica que a integração cria uma interface entre o Snowflake e um serviço de e-mail de terceiros.

Parâmetros opcionais

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

(Para TYPE = EMAIL) Uma lista separada por vírgula de endereços de e-mail entre aspas que podem receber e-mails de notificação a partir desta integração.

Você deve especificar os endereços de e-mail dos usuários na conta atual. Estes usuários devem verificar seus endereços de e-mail.

O número máximo de endereços de e-mail que você pode especificar é 50.

Se você omitir esse parâmetro, poderá enviar notificações por e-mail para qualquer endereço de e-mail verificado na conta atual.

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

Especifica a lista de destinatários padrão para mensagens enviadas com esta integração. Use uma lista separada por vírgulas de endereços de e-mail entre aspas para especificar os destinatários padrão.

Você deve especificar os endereços de e-mail dos usuários na conta atual. Estes usuários devem verificar seus endereços de e-mail.

Para substituir os destinatários padrão de uma determinada mensagem, use a função auxiliar EMAIL_INTEGRATION_CONFIG ao chamar o procedimento armazenado SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

DEFAULT_SUBJECT = 'subject_line'

Especifica a linha de assunto padrão para mensagens enviadas com esta integração.

O assunto não pode exceder 256 caracteres.

Padrão: “Notificação por e-mail do Snowflake”

Para substituir a linha de assunto padrão de uma determinada mensagem, use a função auxiliar EMAIL_INTEGRATION_CONFIG ao chamar o procedimento armazenado SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

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

  • 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.

Exemplos

Consulte Envio de notificações por e-mail.

Linguagem: Português