Table de référence du système de classification des données

Important

Cette fonctionnalité est disponible en préversion publique.

Cette page présente le schéma de la table de résultats de classification des données et inclut des exemples de requêtes. La table stocke les détections pour les classes de données sensibles au niveau de la colonne dans les catalogues activés dans votre metastore.

Chemin d’accès de la table : system.data_classification.results

Schéma de table de résultats de classification des données

La table système de résultats de classification des données utilise le schéma suivant :

Nom de colonne	Type de données	Descriptif	Example
latest_detected_time	horodatage	Date/heure à laquelle la colonne a été scannée le plus récemment.	2025-06-27T12:34
first_detected_time	horodatage	Heure à laquelle la détection de colonne a été enregistrée pour la première fois.	2025-06-27T12:34
catalog_id	ficelle	ID du catalogue.	3f1a7d6e-9c59-...
table_id	ficelle	ID de la table.	3f1a7d6e-9c59-...
catalog_name	ficelle	Nom du catalogue.	main_catalog
schema_name	ficelle	Nom du schéma.	public
table_name	ficelle	Nom de la table.	sales_data
column_name	ficelle	Nom de colonne.	customer_email
data_type	ficelle	Type de données de la colonne. Les types complexes incluent des définitions complètes de struct.	struct<name:string, age:int>
class_tag	ficelle	Balise pour l'entité détectée ou la clé de balise et sa valeur facultative.	class.us_ssn ou pii: confidential
samples	array<string>	Jusqu’à cinq exemples de valeurs correspondant à la détection.	["a@b.com", ...]
confidence	ficelle	Confiance de la détection. Soit HIGH , soit LOW	HIGH
frequency	flotter	Estimation de la proportion de lignes correspondantes dans l’exemple. Entre 0 et 1.	0.87

Exemples de requêtes

Remplacez les valeurs de paramètre par vos propres valeurs avant d’exécuter.

Obtenir toutes les détections d’une table

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

Obtenez toutes les détections à haute confiance

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

Obtenir le nombre de tables affectées par une classification spécifique

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;

Obtenir le nombre d’utilisateurs qui ont interrogé des tables avec des données sensibles au cours des 30 derniers jours

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