Systemtabellreferens för reglerade taggar

Den här sidan beskriver systemtabellschemat för reglerade taggar och innehåller exempelfrågor. Tabellen innehåller en post för varje styrd taggnyckel i ditt konto, inklusive kundskapade och systemgenererade taggar. Använd den för att programmatiskt avgöra vilka taggar i ditt konto som styrs.

Tabellsökväg: system.tags.governed_tags

Important

Den här systemtabellen finns i Beta.

Systemtabellen för reglerade taggar innehåller den aktuella ögonblicksbilden av alla reglerade taggdefinitioner, inklusive borttagna. När en styrd tagg tas bort fylls tidsstämpeln deleted_at i. Om du vill hämta den aktuella listan över reglerade taggar filtrerar du till rader där deleted_at är null. Se Hämta de reglerade taggarna för kontot.

Tabellschema för reglerade taggar

Systemtabellen för reglerade taggar använder följande schema:

Kolumnnamn Datatyp Description Example
account_id string ID:t för kontot som den här styrda taggen tillhör. 7af234db-66d7-4db3-bbf0-956098224879
id string ID:t för den reglerade taggen, som används för behörighetshantering. ca886134-876c-4671-a38b-332edf48c602
tag_key string Namnet på den reglerade taggnyckeln. system.certification_status
deleted_at timestamp Tiden då den reglerade taggen togs bort. null om taggen inte tas bort. 2025-02-20T23:26:27.655Z
change_time timestamp Den tid då den reglerade taggen senast ändrades. 2025-02-20T23:26:27.655Z

Primärnyckeln kombineras account_id med id.

Exempel på förfrågningar

Ersätt parametervärden med dina egna innan du kör.

Hämta de reglerade taggarna för kontot

Filtrera bort borttagna taggar för att hämta den aktuella listan över reglerade taggar för ditt konto:

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

Använd resultatuppsättningen som den kanoniska listan över aktuella reglerade taggar för kontot.

Identifiera vilka taggtilldelningar som styrs

Anslut de reglerade taggarna med kolumntaggar i informationsschemat för att avgöra vilka Unity Catalog-taggtilldelningar som använder en styrd taggnyckel:

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;

Varje kolumntaggtilldelning inkluderar is_governed = true när dess taggnyckel matchar en styrd taggnyckel.

  • Last updated on