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

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: