CREATE CONTACT¶

Syntaxe¶

CREATE [ OR REPLACE ] CONTACT [ IF NOT EXISTS ] <name>
  [ {
    USERS = ( '<user-name>' [ , '<user_name>' ... ] )
    | EMAIL_DISTRIBUTION_LIST = '<email>'
    | URL = '<url>'
    } ]
  [ COMMENT = '<string_literal>' ]

Paramètres requis¶

name

Indique le nom du nouveau contact.

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.

Paramètres facultatifs¶

USERS = ( 'user_name' [ , 'user_name' ... ] )

Liste délimitée par des virgules des utilisateurs de Snowflake qui peuvent être contactés, spécifiée par le nom de leurs objets utilisateur.

Si le nom de l’utilisateur est sensible à la casse ou inclut des caractères spéciaux ou des espaces, des guillemets doubles sont nécessaires. Les guillemets doubles doivent être placés entre les guillemets simples. Par exemple, si l’utilisateur est joe@example.com, vous devez spécifier '"joe@example.com"'.

EMAIL_DISTRIBUTION_LIST = 'email'

Une adresse électronique valide, qui peut être une liste de distribution si vous souhaitez que les utilisateurs puissent contacter plusieurs personnes.

URL = 'url'

Une URL qui peut être utilisée pour contacter des personnes au sujet d’un objet.

COMMENT

Une chaîne définie par l’utilisateur. Spécifie un commentaire pour le contact.

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

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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¶

CREATE CONTACT my_contact
  EMAIL_DISTRIBUTION_LIST = 'company_support@example.com';