Catégories :: Information Schema , Fonctions de table

TAG_REFERENCES¶

Renvoie une table dans laquelle chaque ligne affiche une association entre une balise et une valeur.

La balise et la valeur associées sont le résultat d’une association directe à un objet ou par l’intermédiaire d’une lignée de balises.

Syntaxe¶

TAG_REFERENCES( '<object_name>' , '<object_domain>' )

Copy

Arguments¶

'object_name'

Nom de l’objet référencé si l’association de balises porte sur l’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¶

Les résultats ne sont renvoyés que pour un rôle qui a accès à l’objet spécifié.

Pour visualiser les références des balises système, utilisez un rôle avec IMPORTED PRIVILEGES sur la base de données partagée SNOWFLAKE.
Lors de l’appel d’une fonction de la table Information Schema, la session doit avoir un schéma INFORMATION_SCHEMA en cours d’utilisation ou la fonction doit être un nom d’objet complet. Pour plus de détails, voir Schéma d’information de Snowflake.

Sortie¶

La fonction renvoie les colonnes suivantes :

Colonne	Type de données	Description
TAG_DATABASE	TEXT	La base de données dans laquelle la balise est définie.
TAG_SCHEMA	TEXT	Le schéma dans lequel la balise est définie.
TAG_NAME	TEXT	Nom de la balise. C’est le `key` dans la paire `key = 'value'` de la balise.
TAG_VALUE	TEXT	La valeur de la balise. C’est le `'value'` dans la paire `key = 'value'` de la balise.
LEVEL	TEXT	Le domaine de l’objet sur lequel la balise est définie.
OBJECT_DATABASE	TEXT	Nom de la base de données de l’objet référencé pour les objets de base de données et de schéma. Si l’objet n’est pas un objet de base de données ou de schéma, la valeur est vide.
OBJECT_SCHEMA	TEXT	Nom du schéma de l’objet référencé (pour les objets de schéma). Si l’objet référencé n’est pas un objet de schéma (par exemple, un entrepôt), cette valeur est vide.
OBJECT_NAME	TEXT	Nom de l’objet de référence si l’association de balises porte sur l’objet.
DOMAIN	TEXT	Domaine de l’objet de référence (par exemple, une table, une vue) si l’association de balises porte sur l’objet. Si l’association de balises est sur une colonne, le domaine est COLUMN.
COLUMN_NAME	TEXT	Nom de la colonne référencée ; non applicable si l’association de balises n’est pas une colonne.

Exemples¶

Récupérer la liste des balises associées à la table my_table :

select *
  from table(my_db.information_schema.tag_references('my_table', 'table'));

Copy

Récupérer la liste des balises associées à la colonne result :

select *
  from table(my_db.information_schema.tag_references('my_table.result', 'COLUMN'));

Copy