SYSTEM$GET_TAG¶

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 :

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