Catégories :

Information Schema , Fonctions de table

TAG_REFERENCES_ALL_COLUMNS

Renvoie une table dans laquelle chaque ligne affiche le nom et la valeur de la balise attribuée à une colonne spécifique.

Cette fonction renvoie toutes les balises définies sur chaque colonne d’une table ou d’une vue donnée, que la balise soit directement attribuée à une colonne ou par l’intermédiaire de la lignée de balises.

Syntaxe

TAG_REFERENCES_ALL_COLUMNS( '<object_name>' , '<object_domain>' )
Copy

Arguments

'object_name'

Nom de l’objet référencé si l’association de balises porte sur l’objet.

Cet argument prend en charge les noms des tables et des vues.

'object_domain'

Domaine de l’objet référencé.

Snowflake prend en charge un domaine pour cette fonction : TABLE.

Notez que le domaine TABLE doit est utilisé pour tous les objets qui contiennent des colonnes, même si le nom de l’objet est une vue (c’est-à-dire une vue, une vue matérialisée).

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

Le nom de la base de données contenant la table ou la vue.

OBJECT_SCHEMA

TEXT

Le nom du schéma contenant la table ou la vue.

OBJECT_NAME

TEXT

Le nom de la table ou de la vue.

DOMAIN

TEXT

Cette valeur doit être COLUMN car cette fonction renvoie toutes les balises définies sur toutes les colonnes de la table ou de la vue.

COLUMN_NAME

TEXT

Le nom de la colonne sur laquelle la balise est définie.

Exemples

Récupérer la liste des balises qui sont attribuées à chaque colonne de la table my_table :

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