Référence de table système pour les tags gouvernés
Cette page décrit le schéma de table du système de tags gouvernés et comprend des exemples de query. La table contient un enregistrement pour chaque clé de tag gouverné dans votre compte, y compris les tags créés par les clients et les tags générés par le système. Utilisez-le pour déterminer par programmation quels tags de votre compte sont gouvernés.
**Chemin de la table** : system.tags.governed_tags
Bêta
Cette table système est en version Bêta.
La table système des tags gouvernés contient l'instantané actuel de toutes les définitions de tags gouvernés, y compris celles supprimées. Lorsqu'un tag gouverné est supprimé, son deleted_at timestamp est renseigné. Pour obtenir la liste actuelle des tags gouvernés, filtrez les lignes où deleted_at est null. Voir Obtenir les tags gouvernés pour le compte.
Schéma de table des tags gouvernés
La table système des tags gouvernés utilise le schéma suivant :
Nom de la colonne | Type de données | Description | Exemple |
|---|---|---|---|
| chaîne | L'ID du compte auquel appartient ce tag gouverné. |
|
| chaîne | L'ID du tag gouverné, qui est utilisé pour la gestion des autorisations. |
|
| chaîne | Le nom de la clé de tag gouverné. |
|
| Horodatage | Le moment où le tag gouverné a été supprimé. |
|
| Horodatage | Date de la dernière modification du tag gouverné. |
|
La clé principale est account_id combinée avec id.
Exemples de requêtes
Remplacez les valeurs des paramètres par les vôtres avant l'exécution.
Obtenir les tags gouvernés pour le compte
Filtrez les tags supprimés pour obtenir la liste actuelle des tags gouvernés pour votre compte :
SELECT
account_id,
id,
tag_key,
change_time
FROM system.tags.governed_tags
WHERE deleted_at IS NULL;
Utilisez le jeu de résultats comme liste canonique des tags gouvernés actuels pour le compte.
Identifiez quelles affectations de tags sont gouvernées
Joignez les tags gouvernés aux tags de colonne dans le schéma d'information pour déterminer quelles affectations de tags Unity Catalog utilisent une clé de tag gouverné :
WITH governed_tags AS (
SELECT account_id, id, tag_key
FROM system.tags.governed_tags
WHERE deleted_at IS NULL
),
assignments AS (
SELECT
catalog_name, schema_name, table_name, column_name, tag_name, tag_value
FROM system.information_schema.column_tags
)
SELECT
a.catalog_name,
a.schema_name,
a.table_name,
a.column_name,
a.tag_name,
a.tag_value,
CASE WHEN g.tag_key IS NOT NULL THEN TRUE ELSE FALSE END AS is_governed
FROM assignments a
LEFT JOIN governed_tags g
ON a.tag_name = g.tag_key;
Chaque affectation de balise de colonne inclut is_governed = true lorsque sa clé de balise correspond à une clé de balise régie.