Catégories :: Fonctions système

SYSTEM$GET_TAG¶

Renvoie la valeur de balise associée à l’objet ou à la colonne Snowflake spécifié(e). Renvoie NULL si une balise n’est pas définie sur l’objet ou la colonne Snowflake spécifié(e).

Syntaxe¶

SYSTEM$GET_TAG( '<tag_name>' , '<obj_name>' , '<obj_domain>' )

Copy

Arguments¶

'tag_name'

Le nom de la balise sous forme de chaîne.

Le nom est le key de la paire clé-valeur de la balise. Par exemple, dans la balise cost_center = 'sales', cost_center est le nom de la clé de la balise. Pour cet argument, utilisez 'cost_center'.

'obj_name'

Le nom de l’objet sous forme de chaîne.

Par exemple, si le nom d’une table est my_table, utilisez 'my_table' comme nom de l’objet.

Pour spécifier une colonne, utilisez le format <nom_table>.<nom_colonne>. Par exemple, my_table.revenue.

Pour plus d’informations, voir Identificateurs d’objet.

'object_domain'

Domaine de l’objet de référence (par exemple, une table ou une vue) si l’association de balises porte sur l’objet. Pour les colonnes, le domaine est COLUMN si l’association de balises est sur une colonne.

Utilisez l’une des valeurs suivantes :

'ACCOUNT'

'ALERT'

'COLUMN'

'DATABASE'

'DATABASE ROLE'

'FUNCTION'

'INTEGRATION'

'NETWORK POLICY'

'PROCEDURE'

'ROLE'

'SCHEMA'

'SHARE'

'STAGE'

'STREAM'

'TABLE' : utilisez cette option pour tous les objets de type table tels que les vues, les vues matérialisées et les tables externes.

'TASK'

'USER'

'WAREHOUSE'

Notes sur l’utilisation¶

L’utilisation de cette fonction nécessite :
- Les privilèges pour exécuter une opération DESCRIBE <objet> sur le nom d’objet spécifié.
- USAGE sur la base de données et le schéma dans lesquels la balise existe.
  
  Pour plus d’informations, voir Privilèges de balise et résumé des DDL.
- IMPORTED PRIVILEGES sur la base de données SNOWFLAKE partagée si vous spécifiez une balise système.

Exemples¶

Retourne NULL si une balise n’est pas associée à l’objet spécifié :

select system$get_tag('cost_center', 'my_table', 'table');

+-----------------------------------------------------+
| SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE')  |
+-----------------------------------------------------+
| NULL                                                |
+-----------------------------------------------------+

Copy

Renvoie la valeur de la balise pour la table spécifiée. La valeur de la balise est le composant de chaîne de la paire key = 'value' de la balise :

select system$get_tag('cost_center', 'my_table', 'table');

-----------------------------------------------------+
| SYSTEM$GET_TAG('COST_CENTER', 'MY_TABLE', 'TABLE') |
+----------------------------------------------------+
| sales                                              |
+----------------------------------------------------+

Copy

Renvoie la valeur de la balise pour la colonne spécifiée :

select system$get_tag('fiscal_quarter', 'my_table.revenue', 'column');

+----------------------------------------------------------------+
| SYSTEM$GET_TAG('FISCAL_QUARTER', 'MY_TABLE.REVENUE', 'COLUMN') |
+----------------------------------------------------------------+
| Q1                                                             |
+----------------------------------------------------------------+

Copy