- Catégories :
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 balisecost_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 :
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.
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 | +----------------------------------------------------------------+