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