Referência da tabela do sistema de etiquetas governadas

Esta página descreve o esquema de tabelas do sistema de etiquetas governadas e inclui consultas de exemplo. A tabela contém um registo para cada chave de etiqueta governada na sua conta, incluindo etiquetas criadas pelo cliente e geradas pelo sistema. Usa-o para determinar programaticamente quais as etiquetas na tua conta que são governadas.

Caminho da tabela: system.tags.governed_tags

A tabela do sistema de etiquetas governadas contém o instantâneo atual de todas as definições de etiquetas governadas, incluindo as eliminadas. Quando uma etiqueta governada é eliminada, o seu deleted_at carimbo temporal é preenchido. Para obter a lista atual de etiquetas governadas, filtre para linhas onde deleted_at é null. Vê Obter as etiquetas governadas da conta.

Esquema de tabelas de etiquetas governadas

A tabela do sistema de etiquetas governadas utiliza o seguinte esquema:

A tonalidade primária é account_id combinada com id.

Exemplos de consultas

Substitua os valores dos parâmetros pelos seus próprios valores antes de executar.

Obtenha as etiquetas governadas para a conta

Filtre as etiquetas eliminadas para obter a lista atual de etiquetas governadas para a sua conta:

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

Use o conjunto de resultados como a lista canónica de etiquetas governadas atualmente para a conta.

Identificar quais as atribuições de etiquetas que são regidas

Junte as etiquetas governadas às etiquetas coluna no esquema de informação para determinar quais as atribuições de etiquetas do Catálogo Unity que utilizam uma chave de etiquetas governada:

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;

Cada atribuição de etiqueta de coluna inclui is_governed = true quando a sua chave de etiquetas corresponde a uma chave de etiqueta governada.