Referencia de tabla del sistema de etiquetas controladas

En esta página se describe el esquema de tabla del sistema de etiquetas reguladas e incluye consultas de ejemplo. La tabla contiene un registro para cada clave de etiqueta regulada en su cuenta, incluidas las etiquetas creadas por el cliente y generadas por el sistema. Úselo para determinar mediante programación qué etiquetas de su cuenta se rigen.

Ruta de acceso de tabla: system.tags.governed_tags

La tabla del sistema de etiquetas reguladas contiene la instantánea actual de todas las definiciones de etiquetas reguladas, incluidas las eliminadas. Cuando se elimina una etiqueta regulada, se rellena su deleted_at marca de tiempo. Para obtener la lista actual de etiquetas reguladas, filtre por las filas donde deleted_at es null. Consulte Obtención de las etiquetas reguladas para la cuenta.

Esquema de tabla de etiquetas reguladas

La tabla del sistema de etiquetas reguladas usa el esquema siguiente:

La clave principal se account_id combina con id.

Consultas de ejemplo

Reemplace los valores de parámetro por los suyos propios antes de ejecutarse.

Obtención de las etiquetas reguladas de la cuenta

Filtre las etiquetas eliminadas para obtener la lista actual de etiquetas reguladas para su cuenta:

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

Use el conjunto de resultados como la lista canónica de etiquetas reguladas actuales para la cuenta.

Identificar qué asignaciones de etiquetas se rigen

Una las etiquetas reguladas con las etiquetas de columna del esquema de información para determinar qué asignaciones de etiquetas de Catálogo de Unity usan una clave de etiqueta regulada:

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 asignación de etiquetas de columna incluye is_governed = true cuando su clave de etiqueta coincide con una clave de etiqueta regulada.