Schéma :: ACCOUNT_USAGE

Vue TAG_REFERENCES¶

Cette vue Account Usage peut être utilisée pour identifier les associations entre les objets et les balises.

Cette vue n’enregistre que la relation directe entre l’objet et la balise. La lignée de balises n’est pas incluse dans cette vue.

Cette vue est complémentaire à la fonction de table Information Schema TAG_REFERENCES.

Colonnes¶

Nom de la 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. Notez que pour les balises du système, cette valeur est NULL.
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.
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 de l’objet référencé.
OBJECT_NAME	TEXT	Nom de l’objet référencé si l’association de balises porte sur l’objet. Si l’association de balises porte sur une colonne, Snowflake renvoie le nom de la table parente.
OBJECT_DELETED	TIMESTAMP_LTZ	Date et heure auxquelles l’objet associé a été détruit, ou si l’objet parent est détruit. . Pour plus d’informations, voir la section Notes sur l’utilisation (dans cette rubrique).
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. Pour les colonnes, le domaine est COLUMN si l’association de balises est sur une colonne. Pour plus d’informations, voir les domaines pris en charge.
COLUMN_ID	NUMBER	L’identificateur local de la colonne de référence ; non applicable si l’association de balises n’est pas une colonne.
COLUMN_NAME	TEXT	Nom de la colonne référencée ; non applicable si l’association de balises n’est pas une colonne.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 120 minutes (2 heures).
La vue n’affiche que les objets pour lesquels le rôle actuel de la session s’est vu accorder des privilèges d’accès.
La colonne TAG_DATABASE_ID n’est pas incluse dans cette vue. Pour obtenir cette valeur dans le résultat de votre requête, effectuez une opération JOIN avec le Vue TAGS.

Cette colonne ne comprend pas l’horodatage d’une colonne supprimée pour laquelle une ou plusieurs balises ont été définies.

Pour référence, une colonne est supprimée lorsque l’un des événements suivants se produit :
- La colonne est supprimée de la table (c’est-à-dire ALTER TABLE ... DROP COLUMN col_name), ou
- La table parente contenant la colonne est supprimée (c’est-à-dire DROP TABLE name), ou
- Le schéma parent contenant la colonne est supprimé (c’est-à-dire DROP SCHEMA name), ou
- La base de données parente contenant la colonne est supprimée (c’est-à-dire DROP DATABASE name).

Exemples¶

Renvoyer les références des balises pour votre compte Snowflake :

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
order by tag_name, domain, object_id;

Copy

Renvoyez les objets actifs qui ont des associations de balises dans votre compte Snowflake. L’ajout de la clause WHERE spécifiée permet de filtrer les objets qui sont supprimés :

select tag_name, tag_value, domain, object_id
from snowflake.account_usage.tag_references
where object_deleted is null
order by tag_name, domain, object_id;

Copy