Envio de notificações por e-mail

Para enviar uma notificação por e-mail:

  1. Certifique-se de que os destinatários pretendidos verifiquem seus endereços de e-mail.

  2. Crie uma integração de notificação.

  3. Chame um procedimento armazenado para enviar a notificação.

Verificar os endereços de e-mail dos destinatários da notificação por e-mail

Você pode enviar notificações por e-mail somente para usuários Snowflake na mesma conta. Esses usuários devem verificar seus endereços de e-mail por meio de uma das seguintes interfaces:

Criar uma integração de notificação por e-mail

Para enviar notificações por e-mail, use uma integração de notificação por e-mail que você cria com o comando CREATE NOTIFICATION INTEGRATION.

Nota

Você deve usar uma função que tenha o privilégio global CREATE INTEGRATION para executar este comando.

Por exemplo, para criar uma integração de notificação por e-mail chamada my_email_int, execute a seguinte instrução:

CREATE NOTIFICATION INTEGRATION my_email_int
  TYPE=EMAIL
  ENABLED=TRUE;
Copy

Nota

All Snowflake customers can send email messages using this feature. Email messages sent from the Notifications System Stored Procedure are processed through Snowflake’s Amazon Web Services (AWS) deployments, using AWS Simple Email Service (SES). The content of an email message sent using AWS may be retained by Snowflake for up to thirty days to manage the delivery of the message. After this period, the message content is deleted.

Restringir a lista de endereços de e-mail que podem receber notificações

Se você quiser restringir a lista de endereços de e-mail que podem receber notificações por meio desta integração, defina ALLOWED_RECIPIENTS como a lista desses endereços de e-mail. Se você não definir ALLOWED_RECIPIENTS, a integração poderá ser usada para enviar notificações a qualquer usuário da conta, desde que o o endereço de e-mail tenha sido verificado.

Nota

Para cada endereço de e-mail em ALLOWED_RECIPIENTS, certifique-se de que o endereço de e-mail tenha sido verificado. Se você especificar um endereço de e-mail que não tenha sido verificado, o comando CREATE NOTIFICATION INTEGRATION falha com um erro.

Por exemplo, para restringir a integração de notificação para que as mensagens de e-mail possam ser enviadas apenas para first.last@example.com e first2.last2@example.com, defina ALLOWED_RECIPIENTS como a lista desses endereços:

CREATE NOTIFICATION INTEGRATION my_email_int
  TYPE=EMAIL
  ENABLED=TRUE
  ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
Copy

Para obter mais detalhes sobre a sintaxe deste comando, consulte CREATE NOTIFICATION INTEGRATION (e-mail).

Especificar uma lista padrão de destinatários e uma linha de assunto padrão

Se você estiver usando o procedimento armazenado SYSTEM$SEND_SNOWFLAKE_NOTIFICATION para enviar notificações por e-mail, você pode configurar a integração de notificações com uma lista padrão de endereços de e-mail e uma linha de assunto padrão a ser usada. Você pode substituir a lista padrão e a linha de assunto ao chamar o procedimento armazenado.

  • Para especificar uma lista padrão de endereços de e-mail, defina a propriedade DEFAULT_RECIPIENTS da integração de notificação.

  • Para especificar uma linha de assunto padrão, defina a propriedade DEFAULT_SUBJECT da integração de notificação.

Por exemplo, suponha que você queira configurar uma integração de notificação por e-mail para a seguinte finalidade:

  • Você deseja enviar a maioria das notificações por e-mail para person_a@example.com e person_b@example.com, mas você também quer ter a possibilidade de enviar notificações aos endereços de e-mail validados de qualquer usuário em sua conta.

  • Você quer que a maioria das mensagens use a linha de assunto “Status do serviço”, mas quer poder usar uma linha de assunto diferente para mensagens específicas.

Para criar uma notificação por e-mail para essa finalidade, execute o seguinte comando:

CREATE NOTIFICATION INTEGRATION my_email_int
  TYPE=EMAIL
  ENABLED=TRUE
  DEFAULT_RECIPIENTS = ('person_a@example.com','person_b@example.com')
  DEFAULT_SUBJECT = 'Service status';
Copy

Ao enviar a notificação, você pode substituir a lista de destinatários padrão e a linha de assunto padrão. Consulte Substituir os valores padrão na integração de notificação por e-mail.

Enviar a notificação por e-mail

Você pode chamar um dos seguintes procedimentos armazenados para enviar uma notificação por e-mail:

Linguagem: Português