Compartilhar via

Referência da tabela do sistema de classificação de dados

Importante

Esse recurso está em Visualização Pública.

Esta página descreve o esquema da tabela de resultados de classificação de dados e inclui consultas de exemplo. A tabela armazena detecções para classes de dados confidenciais no nível da coluna entre catálogos habilitados em seu metastore.

Caminho da tabela: system.data_classification.results

Esquema da tabela de resultados da classificação de dados

A tabela do sistema de resultados de classificação de dados usa o seguinte esquema:

Nome da coluna Tipo de dados Description Example
latest_detected_time carimbo de data/hora No momento em que a coluna foi mais recentemente digitalizada. 2025-06-27T12:34
first_detected_time carimbo de data/hora Hora em que a detecção de coluna foi registrada pela primeira vez. 2025-06-27T12:34
catalog_id cadeia ID do catálogo. 3f1a7d6e-9c59-...
table_id cadeia Identificador da tabela. 3f1a7d6e-9c59-...
catalog_name cadeia Nome do catálogo. main_catalog
schema_name cadeia Nome do esquema. public
table_name cadeia Nome da tabela. sales_data
column_name cadeia Nome da coluna. customer_email
data_type cadeia Tipo de dados da coluna. Tipos complexos incluem definições de struct completas. struct<name:string, age:int>
class_tag cadeia Marca para a entidade detectada ou chave da tag e valor opcional. class.us_ssn ou pii: confidential
samples array<string> Até cinco valores de exemplo que corresponderam à detecção. ["a@b.com", ...]
confidence cadeia Confiança da detecção. Ou HIGH ou LOW HIGH
frequency derivar Estimativa da proporção de linhas correspondentes no exemplo. Entre 0 e 1. 0.87

Consultas de exemplo

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

Obter todas as detecções de uma tabela de dados

SELECT *
FROM system.data_classification.results
WHERE
  catalog_name = "c"
  AND schema_name = "s"
  AND table_name = "t";

Obter todas as detecções de alta confiança

SELECT *
FROM system.data_classification.results
WHERE
  catalog_name = "c"
  AND schema_name = "s"
  AND table_name = "t"
  AND confidence = "HIGH";

Obter o número de tabelas afetadas por uma classificação específica

SELECT
  class_tag,
  COUNT(DISTINCT catalog_name, schema_name, table_name) AS num_tables
FROM
  system.data_classification.results
WHERE
  class_tag IS NOT NULL
GROUP BY class_tag;

Obter o número de usuários que consultaram tabelas com dados confidenciais nos últimos 30 dias

WITH table_accesses AS (
  SELECT
    IFNULL(
      request_params.full_name_arg,
      CONCAT(request_params.catalog_name, '.', request_params.schema_name, '.', request_params.name)
    ) AS table_full_name,
    COUNT(DISTINCT user_identity.email) AS num_users
  FROM
    system.access.audit
  WHERE
    action_name IN ("createTable", "getTable", "updateTable", "deleteTable")
    AND (
      -- For performance, limit the blast radius of the audit log query to only the current catalog
      request_params.catalog_name = :catalog_name OR
      request_params.full_name_arg LIKE :catalog_name || '%'
    )
    AND event_time >= DATE_SUB(current_date(), 30)
  GROUP BY table_full_name
),
sensitive_tables AS (
  SELECT
    DISTINCT CONCAT(catalog_name, '.', schema_name, '.', table_name) AS table_full_name
  FROM
    system.data_classification.results
  WHERE class_tag IS NOT NULL
)

SELECT
  st.table_full_name,
  ta.num_users
FROM
  sensitive_tables st
  JOIN table_accesses ta
  ON st.table_full_name = ta.table_full_name
  • Last updated on