Catégories :

Fonctions de table Account Usage , Fonctions de table

TAG_REFERENCES_WITH_LINEAGE

Renvoie une table dans laquelle chaque ligne affiche une association entre la balise spécifiée et l’objet Snowflake auquel la balise est associée.

La balise associée et l’objet Snowflake sont le résultat à la fois d’une association directe à un objet et d’une lignée de balises.

Syntaxe

TAG_REFERENCES_WITH_LINEAGE( '<name>' )
Copy

Arguments

'name'

Le nom entièrement qualifié de la balise.

Le nom entièrement qualifié doit spécifier la base de données de balises parente et le schéma de balises pour la balise au format suivant :

<base_données_balise>.<schéma_balise>.<nom_balise>

Notes sur l’utilisation

  • Les résultats ne sont renvoyés que pour le 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.

  • Lorsque vous appelez une fonction de table Account Usage, un schéma Account Usage doit être utilisé dans la session. Pour plus de détails, voir Account Usage.

  • Comme pour les vues Account Usage, veuillez tenir compte de la latence lorsque vous appelez cette fonction de table. La latence attendue pour cette fonction de table est similaire à la latence pour la vue TAG_REFERENCES.

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_ID

NUMBER

Identificateur interne / généré par le système pour la balise.

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_ID

NUMBER

Identificateur interne / généré par le système pour l’objet.

OBJECT_NAME

TEXT

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

OBJECT_DELETED

TIMESTAMP_LTZ

Date et heure auxquelles l’objet ou la colonne associé(e) a été détruit(e), ou si l’objet parent est détruit.

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_ID

NUMBER

Identificateur interne / généré par le système pour la colonne.

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 associations de balises pour la balise cost_center :

select *
  from table(snowflake.account_usage.tag_references_with_lineage('my_db.my_schema.cost_center'));
Copy