Catégories :

Utilisateur et sécurité DDL

ALTER TAG

Modifie les propriétés d’une balise existante, y compris le renommage de la balise.

Toutes les modifications apportées à la balise entrent en vigueur lors de l’exécution de la prochaine requête SQL qui utilise la balise.

Voir aussi :

Spécification de valeurs de balises , Vue TAGS

Syntaxe

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

ALTER TAG [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER TAG [ IF EXISTS ] <name> UNSET COMMENT

Spécification des valeurs autorisées

ALTER TAG [ IF EXISTS ] <name> { ADD | DROP } ALLOWED_VALUES '<val_1>' [ , '<val_2>' , [ ... ] ]

ALTER TAG <name> UNSET ALLOWED_VALUES

Paramètres

nom

Identificateur pour la balise. Affectez la valeur de la chaîne de balises à un objet en utilisant une instruction CREATE <objet> ou une instruction ALTER <objet>.

La valeur de 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 (p. ex. « Mon objet »). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus de détails, voir Exigences relatives à l’identificateur

RENAME TO nouveau_nom

Spécifie le nouvel identificateur de la balise ; doit être unique pour votre schéma. Le nouvel identificateur ne peut pas être utilisé si l’identificateur est déjà en place pour une politique différente (par exemple, une politique de masquage).

Pour plus de détails, voir Exigences relatives à l’identificateur.

ALLOWED_VALUES 'val_1' [ , 'val_2' , [ ... ] ]

Spécifie une liste, séparée par des virgules, des valeurs de chaîne possibles qui peuvent être affectées à la balise lorsque celle-ci est définie sur un objet à l’aide de la commande CREATE <objet> ou ALTER <objet> correspondante.

Le nombre maximum de valeurs de balises dans cette liste est 20.

Valeur par défaut : NULL (toutes les valeurs de chaîne sont autorisées, y compris une valeur de chaîne vide [c’est-à-dire ' ']).

COMMENT = 'littéral_chaine'

Spécifie un commentaire pour la balise.

Par défaut : aucune valeur

UNSET

Spécifie une (ou plusieurs) propriété(s) et/ou paramètres à désactiver pour la balise, qui les réinitialise aux valeurs par défaut :

  • COMMENT

  • ALLOWED_VALUES

Notes sur l’utilisation

  • Pour plus d’informations sur l’autorisation de la balise DDL, voir les privilèges requis.

  • 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

Renommez la balise cost_center en cost_center_na, où na spécifie l’Amérique du Nord.

alter tag cost_center rename to cost_center_na;