Referenz zur Systemtabellenreferenz für geregelte Tags

Auf dieser Seite werden das unterliegte Kategoriensystemtabellenschema beschrieben und Beispielabfragen enthalten. Die Tabelle enthält einen Datensatz für jeden gesteuerten Tagschlüssel in Ihrem Konto, einschließlich vom Kunden erstellter und vom System generierter Tags. Verwenden Sie sie, um programmgesteuert zu bestimmen, welche Tags in Ihrem Konto geregelt werden.

Tabellenpfad: system.tags.governed_tags

Die governed Tags-Systemtabelle enthält die aktuelle Momentaufnahme aller geregelten Tagdefinitionen, einschließlich gelöschter Tags. Wenn ein geregeltes Tag gelöscht wird, wird der deleted_at Zeitstempel aufgefüllt. Um die aktuelle Liste der geregelten Tags abzurufen, filtern Sie nach Zeilen, in denen deleted_at sich dies befindet null. Siehe Abrufen der geregelten Tags für das Konto.

Governed Tags-Tabellenschema

Die unterliegt Tags-Systemtabelle verwendet das folgende Schema:

Der Primärschlüssel wird account_id mit id.

Beispielabfragen

Ersetzen Sie die Parameterwerte durch eigene Werte, bevor Sie das Programm ausführen.

Abrufen der geregelten Tags für das Konto

Filtern Sie gelöschte Tags, um die aktuelle Liste der geregelten Tags für Ihr Konto abzurufen:

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

Verwenden Sie das Resultset als kanonische Liste der aktuellen geregelten Tags für das Konto.

Identifizieren, welche Tagzuweisungen gesteuert werden

Verbinden Sie die geregelten Tags mit den Spaltentags im Informationsschema, um zu bestimmen, welche Unity-Katalog-Tagzuweisungen einen geregelten Tagschlüssel verwenden:

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;

Jede Spaltentagzuweisung enthält is_governed = true , wenn der Tagschlüssel mit einem geregelten Tagschlüssel übereinstimmt.