Aller au contenu principal
Dernière mise à jour le

Référence de la table système des événements de salle blanche

info

Aperçu

Cette table système est en aperçu public.

La table d'événements de salle blanche enregistre les actions effectuées par vous ou vos collaborateurs sur les salles blanches de votre compte. Ce tableau inclut des données régionales de l'ensemble de votre compte.

Pour plus d'informations sur les clean rooms, consultez Qu'est-ce que Databricks Clean Rooms ?.

**Chemin de la table** : Cette table système est située system.access.clean_room_events à.

Schéma de table système des événements de salle blanche​

La table système des événements en salle blanche utilise le schéma suivant :

Nom de colonne

Type de données

Description

Exemple

account_id

chaîne

L'ID du compte Databricks

7af234db-66d7-4db3 -bbf0-956098224879

metastore_id

chaîne

L'ID du métastore UC.

5a31ba44-bbf4-4174 -bf33-e1fa078e6765

event_id

chaîne

L’ID de l’événement de salle blanche

db52a413-7a0a-4d49 -b742-7ae5f06bc4b2

clean_room_name

chaîne

Nom de la salle blanche associée à l'événement

market-analysis

central_clean_room_id

chaîne

L'ID de la salle blanche centrale

e01b6a78-1336-47e1 -b63d-3e49aa5b627

initiator_global_metastore_id

chaîne

Identifiant du métastore global du collaborateur qui a initié l'événement

aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a

event_time

Horodatage

Timestamp de l'événement.

2023-01-01T01:01:01.123

event_type

chaîne

Le type d'événement. Consultez Logs salle blanche événements.

CLEAN_ROOM_CREATED

clean_room_created_metadata

structure

Les métadonnées du type d'événement CLEAN_ROOM_CREATED

{ "collaborators": [ {"collaborator_global_metastore_id": "aws:us-west-2:ec22936d-cd29-4421-a88a-883fb356776a"}, {"collaborator_global_metastore_id": "azure:westus:3be05a26-5a83-478c-8428-9ef9aa67b5d0"}] }

clean_room_deleted_metadata

structure

Les métadonnées du type d'événement CLEAN_ROOM_DELETED

{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }

run_notebook_started_metadata

structure

Les métadonnées du type d'événement RUN_NOTEBOOK_STARTED

{ "notebook_name": "Market Analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206", "notebook_etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931", "notebook_update_time": "2025-05-04T03:20:35.000Z" }

run_notebook_completed_metadata

structure

Les métadonnées du type d'événement RUN_NOTEBOOK_COMPLETED

Consultez Métadonnées d'exécution de Notebook terminées

clean_room_assets_updated_metadata

structure

Les métadonnées du type d'événement CLEAN_ROOM_ASSETS_UPDATED

{ "added_assets": [{ "data_object_type": "TABLE", "name": "sales", "catalog": "demo"}], "updated_assets":[], "removed_assets": [] }

asset_review_created_metadata

structure

Les métadonnées du type d'événement ASSET_REVIEW_CREATED

Consultez les événements d'examen des asset de salle blanche

output_schema_deleted_metadata

structure

Les métadonnées du type d'événement OUTPUT_SCHEMA_DELETED

{ "name": "output_schema_55555", "owner_global_metastore_id": "aws:us-west-2:555555-55...", "action": "DELETE", "expire_time": "2025-01-14T15:28:19.000Z" }

initiator_collaborator_alias

chaîne

Alias du collaborateur qui a initié l'événement. Pour les salles blanches créées via l'interface utilisateur, la valeur est soit creator soit collaborator. Pour les salles blanches créées via l'API, ce sont les valeurs personnalisées spécifiées lors de la création.

creator

Nom de colonne

Type de données

Description

Exemple

account_id

chaîne

L'ID du compte Databricks

7af234db-66d7-4db3 -bbf0-956098224879

metastore_id

chaîne

L'ID du métastore UC.

5a31ba44-bbf4-4174 -bf33-e1fa078e6765

event_id

chaîne

L’ID de l’événement de salle blanche

db52a413-7a0a-4d49 -b742-7ae5f06bc4b2

clean_room_name

chaîne

Nom de la salle blanche associée à l'événement

market-analysis

central_clean_room_id

chaîne

L'ID de la salle blanche centrale

e01b6a78-1336-47e1 -b63d-3e49aa5b627

initiator_global_metastore_id

chaîne

Identifiant du métastore global du collaborateur qui a initié l'événement

aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a

event_time

Horodatage

Timestamp de l'événement.

2023-01-01T01:01:01.123

event_type

chaîne

Le type d'événement. Consultez Logs salle blanche événements.

CLEAN_ROOM_CREATED

clean_room_created_metadata

structure

Les métadonnées du type d'événement CLEAN_ROOM_CREATED

{ "collaborators": [ {"collaborator_global_metastore_id": "aws:us-west-2:ec22936d-cd29-4421-a88a-883fb356776a"}, {"collaborator_global_metastore_id": "azure:westus:3be05a26-5a83-478c-8428-9ef9aa67b5d0"}] }

clean_room_deleted_metadata

structure

Les métadonnées du type d'événement CLEAN_ROOM_DELETED

{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }

run_notebook_started_metadata

structure

Les métadonnées du type d'événement RUN_NOTEBOOK_STARTED

{ "notebook_name": "Market Analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206", "notebook_etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931", "notebook_update_time": "2025-05-04T03:20:35.000Z" }

run_notebook_completed_metadata

structure

Les métadonnées du type d'événement RUN_NOTEBOOK_COMPLETED

Consultez Métadonnées d'exécution de Notebook terminées

clean_room_assets_updated_metadata

structure

Les métadonnées du type d'événement CLEAN_ROOM_ASSETS_UPDATED

{ "added_assets": [{ "data_object_type": "TABLE", "name": "sales", "catalog": "demo"}], "updated_assets":[], "removed_assets": [] }

asset_review_created_metadata

structure

Les métadonnées du type d'événement ASSET_REVIEW_CREATED

Consultez les événements d'examen des asset de salle blanche

output_schema_deleted_metadata

structure

Les métadonnées du type d'événement OUTPUT_SCHEMA_DELETED

{ "name": "output_schema_55555", "owner_global_metastore_id": "aws:us-west-2:555555-55...", "action": "DELETE", "expire_time": "2025-01-14T15:28:19.000Z" }

initiator_collaborator_alias

chaîne

Alias du collaborateur qui a initié l'événement. Pour les salles blanches créées via l'interface utilisateur, la valeur est soit creator soit collaborator. Pour les salles blanches créées via l'API, ce sont les valeurs personnalisées spécifiées lors de la création.

creator

Événements de salle blanche enregistrés​

Cette table système Logs les événements suivants :

  • CLEAN_ROOM_CREATEDCréer une nouvelle salle blanche.
  • CLEAN_ROOM_DELETED: L’utilisateur supprime une salle blanche.
  • RUN_NOTEBOOK_STARTED: L'utilisateur lance l'exécution d'un Notebook dans une salle blanche.
  • RUN_NOTEBOOK_COMPLETED: Un notebook est terminé. Vérifiez le run_notebook_completed_metadata pour voir si l'exécution a été réussie ou non.
  • CLEAN_ROOM_ASSETS_UPDATED: Les actifs d'une salle blanche sont mis à jour. Il peut s'agir d'ajouter, de mettre à jour ou de supprimer des assets.
  • OUTPUT_SCHEMA_DELETED: Un schéma de sortie expire et est supprimé. initiator_global_metastore_id pour ce type d'événement est toujours system car la suppression se produit à l'expiration du schéma de sortie.
  • ASSET_REVIEW_CREATEDL'utilisateur examine un asset de salle blanche. Cela peut inclure des avis générés par le système pour le compte de l’utilisateur.

Pour éviter les enregistrements en double, un seul enregistrement est émis pour chaque événement dans les salles blanches où les collaborateurs appartiennent au même metastore. Pour les salles blanches où les collaborateurs appartiennent à des métastores distincts, des enregistrements uniques sont émis pour chaque collaborateur.

Schéma des métadonnées d'exécution de notebook terminé​

La colonne run_notebook_completed_metadata contient des informations de métadonnées pour RUN_NOTEBOOK_COMPLETED événements. Si une table de sortie a été créée par l'exécution du notebook, l'information est enregistrée à l'aide de la structure output_schema.

La colonne run_notebook_completed_metadata utilise le schéma suivant :

notebook_name: "example_notebook"
run_id: "TaskRunId-55555129818570"
state: "SUCCESS"
duration_in_seconds: 120
output_schema:
  name: "output_schema_123450129818570"
  owner_global_metastore_id: "aws:us-west-2:55555e-55bc-55a5-55ab-555d5ec16013"
  action: "CREATE"
  expire_time: "2025-01-14T15:28:19.000Z"
  assets_added:
    0:
    name: "important_data"
    data_object_type: "TABLE"

Événements d'examen d'asset de salle blanche​

La table des systèmes enregistre les métadonnées relatives aux actions d’examen telles que les approbations, les rejets et les approbations automatiques effectuées sur les actifs individuels de salle blanche. Les différents types d’examen renvoient les structs suivants :

Approbation :

JSON
{
  "asset_name": "Market Analysis",
  "data_object_type": "NOTEBOOK_FILE",
 "notebook_metadata: {
    “etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",
  }
  "review_state": "APPROVED",
  "review_subreason": null,
  "auto_approval_rule_id": null,
}

Rejet :

JSON
{
  "asset_name": "Market Analysis",
  "data_object_type": "NOTEBOOK_FILE",
 "notebook_metadata: {
    “etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",
  }
  "review_state": "REJECTED",
  "review_subreason": null,
  "auto_approval_rule_id": null,
}

Auto-approbation :

JSON
{
  "asset_name": "Market Analysis",
  "data_object_type": "NOTEBOOK_FILE",
 "notebook_metadata: {
    “etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",
  }
  "review_state": "APPROVED",
  "review_subreason": "AUTO_APPROVED",
  "auto_approval_rule_id": "d0ec563f-6d58-4f38-99c0-376b779e3747",
}

Surveiller l'utilisation facturable des salles blanches​

Pour en savoir plus sur l'utilisation et les coûts de la salle blanche, vous pouvez joindre cette table à la table billing.usage à l'aide de la colonne central_clean_room_id. Dans la table billing.usage, l'utilisation de la salle blanche est attribuée à l'aide de la clé usage_metadata.central_clean_room_id.

Exemples de query​

Les exemples de query suivants vous aident à obtenir des insights sur l’activité de salle blanche dans votre compte :

Lister tous les événements d'une salle blanche spécifiée​

Remplacez :central_clean_room_id par l'ID de la salle blanche centrale, que vous trouverez dans le panneau des détails de la salle blanche, à côté de Central Id .

SQL
SELECT
 event_time, initiator_global_metastore_id, event_type,
 CASE
   WHEN event_type = 'CLEAN_ROOM_CREATED' THEN to_json(clean_room_created_metadata)
   WHEN event_type = 'CLEAN_ROOM_DELETED' THEN to_json(clean_room_deleted_metadata)
   WHEN event_type = 'RUN_NOTEBOOK_STARTED' THEN to_json(run_notebook_started_metadata)
   WHEN event_type = 'RUN_NOTEBOOK_COMPLETED' THEN to_json(run_notebook_completed_metadata)
   WHEN event_type = 'CLEAN_ROOM_ASSETS_UPDATED' THEN to_json(clean_room_assets_updated_metadata)
   WHEN event_type = 'OUTPUT_SCHEMA_DELETED' THEN to_json(output_schema_deleted_metadata)
   WHEN event_type = 'ASSET_REVIEW_CREATED' THEN to_json(asset_review_created_metadata)
   ELSE ""
 END AS event_metadata
 FROM system.access.clean_room_events
 WHERE central_clean_room_id = :central_clean_room_id
ORDER BY event_time DESC

Lister tous les événements initiés par un collaborateur spécifié​

Pour le paramètre :initiator_global_metastore_id, saisissez l'ID global de métastore du collaborateur, également appelé identifiant de partage. Pour :collaborator_alias, saisissez l'alias du collaborateur. Par default, les deux alias possibles sont creator pour le créateur de la salle blanche et collaborator pour l'autre partie.

SQL
SELECT
 clean_room_name, central_clean_room_id, event_type, event_time,
 CASE
   WHEN event_type = 'CLEAN_ROOM_CREATED' THEN to_json(clean_room_created_metadata)
   WHEN event_type = 'CLEAN_ROOM_DELETED' THEN to_json(clean_room_deleted_metadata)
   WHEN event_type = 'RUN_NOTEBOOK_STARTED' THEN to_json(run_notebook_started_metadata)
   WHEN event_type = 'RUN_NOTEBOOK_COMPLETED' THEN to_json(run_notebook_completed_metadata)
   WHEN event_type = 'CLEAN_ROOM_ASSETS_UPDATED' THEN to_json(clean_room_assets_updated_metadata)
   WHEN event_type = 'OUTPUT_SCHEMA_DELETED' THEN to_json(output_schema_deleted_metadata)
   WHEN event_type = 'ASSET_REVIEW_CREATED' THEN to_json(asset_review_created_metadata)
   ELSE ""
 END AS event_metadata
 FROM system.access.clean_room_events
 WHERE initiator_global_metastore_id = :initiator_global_metastore_id AND (initiator_collaborator_alias = :collaborator_alias OR initiator_collaborator_alias IS NULL)
 ORDER BY clean_room_name, event_time DESC

Listez tous les collaborateurs pertinents des salles blanches​

SQL
SELECT DISTINCT explode(transform(clean_room_created_metadata.collaborators, x -> x.collaborator_global_metastore_id)) AS collaborator
FROM system.access.clean_room_events
WHERE event_type = 'CLEAN_ROOM_CREATED'

Lister les exécutions de Notebook les plus lentes​

SQL
SELECT
 clean_room_name,
 run_notebook_completed_metadata.notebook_name AS notebook_name,
 run_notebook_completed_metadata.duration_in_seconds AS duration_in_seconds,
 run_notebook_completed_metadata.run_id AS run_id
FROM system.access.clean_room_events
WHERE event_type = 'RUN_NOTEBOOK_COMPLETED'
 AND run_notebook_completed_metadata.state = 'SUCCESS'
 AND run_notebook_completed_metadata.duration_in_seconds IS NOT NULL
ORDER BY duration_in_seconds DESC

Taux d'exécution réussie pour chaque notebook​

SQL
SELECT
 clean_room_name,
 run_notebook_completed_metadata.notebook_name AS notebook_name,
 ROUND(COUNT(CASE WHEN run_notebook_completed_metadata.state = 'SUCCESS' THEN 1 END) * 1.0 / COUNT(*) * 100) AS success_rate
FROM system.access.clean_room_events
WHERE event_type = 'RUN_NOTEBOOK_COMPLETED'
GROUP BY clean_room_name, notebook_name
ORDER BY clean_room_name, notebook_name

Listez tous les événements où une table spécifiée a été ajoutée aux salles blanches​

Pour le paramètre :table_name_string, saisissez le nom de table spécifié.

SQL
SELECT
  clean_room_name,
  initiator_global_metastore_id,
  event_time,
  clean_room_assets_updated_metadata
FROM
  system.access.clean_room_events
WHERE
  event_type = 'CLEAN_ROOM_ASSETS_UPDATED'
  AND exists(
    clean_room_assets_updated_metadata.added_assets,
    item -> item.data_object_type = 'TABLE'
    AND item.name = :table_name_string
  )
ORDER BY
  clean_room_name,
  event_time DESC
Sur cette page