Naslaginformatie over systeemtabel met beheerde tags

Op deze pagina wordt het schema van de systeemtabel met beheerde tags beschreven en worden voorbeeldquery's opgenomen. De tabel bevat een record voor elke beheerde tagsleutel in uw account, inclusief door de klant gemaakte en door het systeem gegenereerde tags. Gebruik dit programma om programmatisch te bepalen welke tags in uw account worden beheerd.

Tabelpad: system.tags.governed_tags

De systeemtabel met beheerde tags bevat de huidige momentopname van alle beheerde tagdefinities, inclusief verwijderde tags. Wanneer een beheerde tag wordt verwijderd, wordt het deleted_at tijdstempel ingevuld. Als u de huidige lijst met beheerde tags wilt ophalen, filtert u op rijen waar deleted_at zich bevindt null. Zie De beheerde tags voor het account ophalen.

Schema van tabel met beheerde tags

De systeemtabel met beheerde tags maakt gebruik van het volgende schema:

De primaire sleutel wordt account_id gecombineerd met id.

Voorbeeldvragen

Vervang parameterwaarden door uw eigen waarden voordat u deze uitvoert.

De beheerde tags voor het account ophalen

Filter verwijderde tags uit om de huidige lijst met beheerde tags voor uw account op te halen:

SELECT
  account_id,
  id,
  tag_key,
  change_time
FROM system.tags.governed_tags
WHERE deleted_at IS NULL;

Gebruik de resultatenset als de canonieke lijst met huidige beheerde tags voor het account.

Bepalen welke tagtoewijzingen worden beheerd

Voeg de beheerde tags toe met de kolomtags in het informatieschema om te bepalen welke Unity Catalog-tagtoewijzingen een beheerde tagsleutel gebruiken:

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;

Elke kolomtagtoewijzing bevat is_governed = true wanneer de tagsleutel overeenkomt met een beheerde tagsleutel.