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

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

Arguments

'nom_de_la_balise'

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'.

'nom_objet'

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.

'domaine_objet'

Le domaine de l’objet (par exemple TABLE, WAREHOUSE) sous forme de chaîne.

Par exemple, si le domaine est une table, utilisez 'table'.

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                                                |
+-----------------------------------------------------+

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 get_tag('cost_center', 'my_table', 'table');

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

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                                                             |
+----------------------------------------------------------------+