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 :

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