ALTER CONTACT¶

Modifie les propriétés d’un contact existant.

Voir aussi :: CREATE CONTACT, DROP CONTACT, SHOW CONTACTS

Syntaxe¶

ALTER CONTACT [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER CONTACT [ IF EXISTS ] <name> SET
  [ {
    USERS = ( <user_name> [ , <user_name> ... ] )
    | EMAIL_DISTRIBUTION_LIST = '<email>'
    | URL = '<url>'
    } ]
  [ COMMENT = '<string_literal>' ]

Copy

Paramètres¶

name

Spécifie l’identificateur du contact à modifier.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

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

RENAME TO new_name

Modifie le nom du contact en new_name. Le nouvel identificateur doit être unique pour le schéma.

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

Vous pouvez déplacer l’objet vers une autre base de données et/ou un autre schéma tout en renommant éventuellement l’objet. Pour ce faire, spécifiez une valeur new_name qualifiée qui inclut le nouveau nom de la base de données et/ou du schéma sous la forme db_name.schema_name.object_name ou schema_name.object_name, respectivement.

Note

La base de données et/ou le schéma de destination doivent déjà exister. En outre, un objet portant le même nom ne peut pas déjà exister dans le nouvel emplacement ; sinon, l’instruction renvoie une erreur.
Le déplacement d’un objet vers un schéma d’accès géré est interdit sauf si le propriétaire de l’objet (c’est-à-dire le rôle qui a le privilège OWNERSHIP sur l’objet) est également propriétaire du schéma cible.

Lorsqu’un contact est renommé, les autres objets qui y font référence doivent être mis à jour avec le nouveau nom.

SET ...

Permet de définir l’un des paramètres suivants pour le contact :

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.
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 = '<string_literal>': 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 commande SQL doit avoir au moins l’un des privilèges suivants définis au minimum ainsi :

Privilège	Objet	Remarques
MODIFY	Contact
OWNERSHIP	Contact	OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

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.

Exemples¶

ALTER CONTACT my_contact SET EMAIL_DISTRIBUTION_LIST = 'support@example.com';

Copy