Catégories :

Fonctions système

SYSTEM$GET_TAG_ON_CURRENT_TABLE

Renvoie la valeur de la chaîne de balise attribuée à la table en fonction de la balise spécifiée ou NULL si aucune balise n’est attribuée à la table spécifiée.

Utilisez cette fonction dans les conditions de la politique de masquage ou dans les conditions de la politique d’accès aux lignes.

Syntaxe

SYSTEM$GET_TAG_ON_CURRENT_TABLE( '<tag_name>' )
Copy

Arguments

'tag_name'

Identificateur pour la balise sous forme de chaîne.

Par exemple, si la balise est nommée cost_center, utilisez 'cost_center' comme argument.

Notes sur l’utilisation

  • Actuellement, cette fonction ne peut être utilisée que dans une condition de politique de masquage ou de politique d’accès aux lignes pour évaluer dynamiquement la valeur de la chaîne de balises définie sur une table.

    Snowflake renvoie une erreur lors de l’utilisation de la fonction dans une requête SELECT, une vue, une vue matérialisée ou une fonction définie par l’utilisateur (UDF).

  • Notez que cette fonction s’applique à tous les objets de type table (par exemple, les vues).

  • La balise doit exister lors de l’appel de cette fonction système, sinon Snowflake renvoie le message d’erreur suivant :

    Tag '<tag_name>' does not exist or not authorized.
    
    Copy

Exemples

Pour un exemple contextuel de l’utilisation de cette fonction, voir Exemple 3 : Protéger une table en fonction de la valeur de la chaîne de balises de la table.