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