Referência da tabela do sistema de marcas governada

Esta página descreve o esquema de tabela do sistema de marcas governada e inclui consultas de exemplo. A tabela contém um registro para cada chave de marca governada em sua conta, incluindo marcas criadas pelo cliente e geradas pelo sistema. Use-o para determinar programaticamente quais marcas em sua conta são governadas.

Caminho da tabela: system.tags.governed_tags

A tabela do sistema de marcas governada contém o instantâneo atual de todas as definições de marca governadas, incluindo as excluídas. Quando uma marca governada é excluída, seu deleted_at carimbo de data/hora é preenchido. Para obter a lista atual de marcas governadas, filtre para linhas onde deleted_at está null. Consulte Obter as marcas governadas para a conta.

Esquema de tabela de marcas governadas

A tabela do sistema de marcas governada usa o seguinte esquema:

A chave primária é account_id combinada com id.

Consultas de exemplo

Substitua os valores de parâmetro por seus próprios antes de executar.

Obter as marcas governadas para a conta

Filtre as marcas excluídas para obter a lista atual de marcas governadas para 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 marcas governadas atuais para a conta.

Identificar quais atribuições de marca são governadas

Junte as marcas governadas com as marcas de coluna no esquema de informações para determinar quais atribuições de marca do Catálogo do Unity usam uma chave de marca 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 marca de coluna inclui is_governed = true quando sua chave de marca corresponde a uma chave de marca governada.