Envoi de notifications par e-mail¶
Pour envoyer une notification par e-mail :
Assurez-vous que les destinataires vérifient leur adresse e-mail.
Appelez une procédure stockée pour envoyer la notification.
Vérifier les adresses e-mail des destinataires de la notification par e-mail¶
Vous pouvez envoyer des notifications par e-mail uniquement aux utilisateurs de Snowflake appartenant au même compte. Ces utilisateurs doivent vérifier leur adresse e-mail via l’une des interfaces suivantes :
Créer une intégration des notifications par e-mail¶
Pour envoyer des notifications par e-mail, utilisez une intégration de notification par e-mail que vous créez à l’aide de la commande CREATE NOTIFICATION INTEGRATION.
Note
Vous devez utiliser un rôle disposant du privilège global CREATE INTEGRATION pour exécuter cette commande.
Par exemple, pour créer une intégration de notification par e-mail nommée my_email_int
, exécutez l’instruction suivante :
CREATE NOTIFICATION INTEGRATION my_email_int
TYPE=EMAIL
ENABLED=TRUE;
Restreindre la liste des adresses électroniques pouvant recevoir des notifications¶
Si vous souhaitez restreindre la liste des adresses e-mail qui peuvent recevoir des notifications par le biais de cette intégration, définissez ALLOWED_RECIPIENTS sur la liste de ces adresses e-mail. Si vous ne définissez pas ALLOWED_RECIPIENTS, l’intégration peut être utilisée pour envoyer des notifications à n’importe quel utilisateur du compte, à condition que l’adresse e-mail ait été vérifiée.
Note
Pour chaque adresse e-mail figurant dans ALLOWED_RECIPIENTS, assurez-vous que l’adresse e-mail a été vérifiée. Si vous spécifiez une adresse e-mail qui n’a pas été vérifiée, la commande CREATE NOTIFICATION INTEGRATION échoue avec une erreur.
Par exemple, pour restreindre l’intégration de la notification de manière à ce que les messages électroniques ne soient envoyés qu’à first.last@example.com
et first2.last2@example.com
, ajoutez ALLOWED_RECIPIENTS à la liste de ces adresses :
CREATE NOTIFICATION INTEGRATION my_email_int
TYPE=EMAIL
ENABLED=TRUE
ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
Pour plus de détails sur la syntaxe de cette commande, voir CREATE NOTIFICATION INTEGRATION (e-mail).
Spécifier une liste de destinataires et d’un objet par défaut¶
Si vous utilisez la procédure stockée SYSTEM$SEND_SNOWFLAKE_NOTIFICATION pour envoyer des notifications par e-mail, vous pouvez configurer l’intégration de notifications avec une liste d’adresses e-mail et une ligne d’objet par défaut à utiliser. Vous pouvez remplacer la liste et la ligne d’objet par défaut lorsque vous appelez la procédure stockée.
Pour spécifier une liste d’adresses e-mail par défaut, définissez la propriété DEFAULT_RECIPIENTS de l’intégration de notification.
Pour spécifier une ligne d’objet par défaut, définissez la propriété DEFAULT_SUBJECT de l’intégration de notification.
Par exemple, supposons que vous souhaitiez mettre en place une intégration de notification par e-mail dans le but suivant :
Vous souhaitez envoyer la plupart des notifications par e-mail à
person_a@example.com
etperson_b@example.com
, mais vous voulez aussi pouvoir envoyer les notifications aux adresses e-mail validées de tous les utilisateurs de votre compte.Vous souhaitez que la plupart des messages aient pour objet « État du service », mais vous voulez pouvoir utiliser un objet différent pour des messages spécifiques.
Pour créer une notification par e-mail à cette fin, exécutez la commande suivante :
CREATE NOTIFICATION INTEGRATION my_email_int
TYPE=EMAIL
ENABLED=TRUE
DEFAULT_RECIPIENTS = ('person_a@example.com','person_b@example.com')
DEFAULT_SUBJECT = 'Service status';
Lors de l’envoi de la notification, vous pouvez modifier la liste des destinataires par défaut et la ligne d’objet par défaut. Voir Remplacer des valeurs par défaut dans l’intégration de la notification par e-mail.
Envoyer des notifications par e-mail¶
Vous pouvez appeler l’une des procédures stockées suivantes pour envoyer une notification par e-mail :
SYSTEM$SEND_SNOWFLAKE_NOTIFICATION
Pour plus de détails, voir Utilisation de SYSTEM$SEND_SNOWFLAKE_NOTIFICATION pour envoyer des notifications.
-
Pour plus de détails, voir Utilisation de SYSTEM$SEND_EMAIL pour envoyer des notifications par e-mail.