Informations de référence sur la table système des étiquettes régies

Cette page décrit le schéma de table système de balises régies et inclut des exemples de requêtes. La table contient un enregistrement pour chaque clé d’étiquette régie dans votre compte, y compris les balises créées par le client et générées par le système. Utilisez-la pour déterminer par programmation les balises dans votre compte qui sont régies.

Chemin d’accès de la table : system.tags.governed_tags

La table système de balises régies contient l’instantané actuel de toutes les définitions de balises régies, y compris celles supprimées. Lorsqu’une balise régie est supprimée, son deleted_at horodatage est rempli. Pour obtenir la liste actuelle des balises régies, filtrez les lignes où deleted_at se trouve null. Consultez Obtenir les balises régies pour le compte.

Schéma de table de balises régies

La table système de balises régies utilise le schéma suivant :

La clé primaire est account_id combinée avec id.

Exemples de requêtes

Remplacez les valeurs de paramètre par vos propres valeurs avant d’exécuter.

Obtenir les balises régies pour le compte

Filtrez les balises supprimées pour obtenir la liste actuelle des balises régies 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 balises régies actuelles pour le compte.

Identifier les affectations d’étiquettes régies

Joignez les balises régies avec les balises de colonne dans le schéma d’informations pour déterminer quelles affectations d’étiquettes du catalogue Unity utilisent une clé de balise régie :

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 attribution d’étiquette de colonne inclut is_governed = true quand sa clé de balise correspond à une clé de balise régie.