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

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.

'obj_domain'

Le domaine de l’objet (par exemple TABLE, WAREHOUSE) sous forme de chaîne. Si une balise est attribuée à une colonne de table ou de vue, le domaine est COLUMN.

Utilisez l’une des valeurs suivantes :

ACCOUNT | INTEGRATION | ROLE | SHARE | USER | WAREHOUSE | DATABASE | SCHEMA | PROCEDURE | STAGE | STREAM | TABLE | TASK | COLUMN

Notez que la valeur de domaine TABLE doit être utilisée pour tous les objets de type table tels que les vues, les vues matérialisées et les tables externes.

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 system$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                                                             |
+----------------------------------------------------------------+
Revenir au début