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