Informazioni di riferimento sulla tabella di sistema dei tag regolamentati

Questa pagina descrive lo schema della tabella di sistema dei tag regolamentati e include query di esempio. La tabella contiene un record per ogni chiave di tag regolamentata nell'account, inclusi i tag creati dal cliente e generati dal sistema. Usarlo per determinare a livello di codice quali tag nell'account sono regolati.

Percorso tabella: system.tags.governed_tags

La tabella di sistema dei tag regolamentati contiene lo snapshot corrente di tutte le definizioni di tag regolate, incluse quelle eliminate. Quando viene eliminato un tag regolamentato, viene popolato il deleted_at timestamp. Per ottenere l'elenco corrente di tag regolamentati, filtrare le righe in cui deleted_at è null. Vedere Ottenere i tag regolati per l'account.

Schema della tabella dei tag regolamentati

La tabella di sistema dei tag regolamentati usa lo schema seguente:

La chiave primaria viene account_id combinata con id.

Interrogazioni di esempio

Sostituire i valori dei parametri con i propri prima dell'esecuzione.

Ottenere i tag regolati per l'account

Filtrare i tag eliminati per ottenere l'elenco corrente di tag regolamentati per l'account:

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

Usare il set di risultati come elenco canonico dei tag regolati correnti per l'account.

Identificare le assegnazioni di tag regolamentate

Unire i tag regolati con i tag di colonna nello schema delle informazioni per determinare quali assegnazioni di tag del catalogo Unity usano una chiave tag regolamentata:

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;

Ogni assegnazione di tag di colonna include is_governed = true quando la chiave del tag corrisponde a una chiave di tag regolamentata.