CREATE NOTIFICATION INTEGRATION (e-mail)

Crée une intégration de notification dans le compte ou remplace une intégration existante pour envoyer des messages par e-mail.

Voir aussi :

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

Syntaxe

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

Paramètres requis

name

Chaîne spécifiant l’identificateur (c’est-à-dire le nom) de l’intégration ; elle doit être unique sur votre compte.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

ENABLED = { TRUE | FALSE }

Spécifie s’il faut initier le fonctionnement de l’intégration ou le suspendre.

  • TRUE permet l’intégration.

  • FALSE désactive l’intégration de la maintenance. Toute intégration entre Snowflake et un service tiers échoue.

TYPE = EMAIL

Spécifie que l’intégration crée une interface entre Snowflake et un service de messagerie électronique tiers.

Paramètres facultatifs

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

(Pour TYPE = EMAIL) Une liste, séparée par des virgules, d’adresses e-mail mises entre guillemets qui peuvent recevoir des e-mails de notification de cette intégration.

Vous devez spécifier des adresses e-mail d’utilisateurs du compte actuel. Ces utilisateurs doivent vérifier leurs adresses e-mail.

Le nombre maximum d’adresses e-mail que vous pouvez spécifier est 50.

Si vous omettez ce paramètre, vous pouvez envoyer des notifications par e-mail à n’importe quelle adresse e-mail vérifiée dans le compte actuel.

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

Spécifie la liste des destinataires par défaut des messages envoyés avec cette intégration. Utilisez une liste d’adresses e-mail citées séparées par des virgules pour spécifier les destinataires par défaut.

Vous devez spécifier des adresses e-mail d’utilisateurs du compte actuel. Ces utilisateurs doivent vérifier leurs adresses e-mail.

Pour remplacer les destinataires par défaut d’un message donné, utilisez la fonction d’aide EMAIL_INTEGRATION_CONFIG lorsque vous appelez la procédure stockée SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

DEFAULT_SUBJECT = 'subject_line'

Spécifie la ligne d’objet par défaut des messages envoyés avec cette intégration.

L’objet ne peut pas comporter plus de 256 caractères.

Par défaut : « Notification par e-mail Snowflake »

Pour remplacer la ligne d’objet par défaut d’un message donné, utilisez la fonction d’aide EMAIL_INTEGRATION_CONFIG lorsque vous appelez la procédure stockée SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

COMMENT = 'string_literal'

Chaîne (littéral) qui spécifie un commentaire pour l’intégration.

Par défaut : aucune valeur

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège

Objet

Remarques

CREATE INTEGRATION

Compte

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation

  • Concernant les métadonnées :

    Attention

    Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

  • Les instructions CREATE OR REPLACE <objet> sont atomiques. En d’autres termes, lorsqu’un objet est remplacé, l’ancien objet est supprimé et le nouvel objet est créé dans une seule transaction.

Exemples

Voir Envoi de notifications par e-mail.

Langage: Français