Partager via

Informations de référence sur la table système des événements de salle blanche

  • Article

Important

Cette table système est en préversion publique. Pour accéder à la table, le schéma doit être activé dans votre catalogue system. Pour plus d’informations, consultez Activer les schémas de table système.

La table d’événements de salle propre enregistre les actions effectuées par vous ou vos collaborateurs sur des salles propres (préversion publique) dans votre compte. Ce tableau inclut les données régionales de votre compte.

Pour plus d’informations sur les salles blanches, consultez Présentation des salles blanches Azure Databricks.

Chemin d’accès de la table : cette table système se trouve à l’emplacement clean_room_events.

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

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

Nom de la colonne Type de données Description Exemple :
account_id string L’ID du compte Azure Databricks 7af234db-66d7-4db3

-bbf0-956098224879
metastore_id string ID du metastore Unity Catalog 5a31ba44-bbf4-4174

-bf33-e1fa078e6765
event_id string L’ID de l’événement de salle blanche db52a413-7a0a-4d49

-b742-7ae5f06bc4b2
clean_room_name string Nom de la salle blanche associée à l’événement market-analysis
central_clean_room_id string L’ID de la salle blanche centrale e01b6a78-1336-47e1

-b63d-3e49aa5b627
initiator_global_metastore_id string ID de metastore global du collaborateur qui a lancé l’événement aws:us-west-2:ec22936d

-cd29-4421-a88a-883fb356776a
event_time timestamp Horodatage du moment où l’événement a eu lieu 2023-01-01T01:01:01.123
event_type string le type de l'événement ; Consultez Événements de salle blanche journalisés. CLEAN_ROOM_CREATED
clean_room_created_metadata struct 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:wesus:”3be05a26-5a83-478c-8428-9ef9aa67b5d0"}]

}
clean_room_deleted_metadata struct Métadonnées du type d’événement CLEAN_ROOM_DELETED {

"central_clean_room_id": "af0d4563-2267-412c-9d4a

-8a59c4895c18"

}
run_notebook_started_metadata struct Métadonnées du type d’événement RUN_NOTEBOOK_STARTED {

"notebook_name": "market analysis",

"notebook_checksum": "7072696E7468656C6C6F776F7264",

"run_id": "TaskRunId-634124444694206"

}
run_notebook_completed_metadata struct Métadonnées du type d’événement RUN_NOTEBOOK_COMPLETED {

"notebook_name": "market analysis",

"run_id": "TaskRunId-634124444694206",

"state": "SUCCESS",

"duration_in_seconds": 156

}
clean_room_assets_updated struct 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": []

}

Événements de salle blanche journalisés

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

  • CLEAN_ROOM_CREATED : l’utilisateur crée une salle blanche
  • CLEAN_ROOM_DELETED : l’utilisateur supprime une salle blanche
  • RUN_NOTEBOOK_STARTED : l’utilisateur initie un notebook exécuté dans une salle blanche
  • RUN_NOTEBOOK_COMPLETED : une exécution de notebook est terminée. Vérifiez le run_notebook_completed_metadata pour voir l’exécution a réussi ou non.
  • CLEAN_ROOM_ASSETS_UPDATED : les ressources d’une salle blanche sont mises à jour. Cela peut être l’ajout, la mise à jour ou la suppression de ressources.

Surveiller l’utilisation facturable de la salle blanche

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

Exemples de requêtes

Les exemples de requêtes suivants vous aident à obtenir des informations sur l’activité de salle blanche dans votre compte :

Répertorier tous les événements d’une salle blanche spécifiée

Remarque

Remplacez <clean_room_name> par le nom de votre salle blanche spécifiée.

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)
   ELSE ""
 END AS event_metadata
 FROM system.access.clean_room_events
 WHERE clean_room_name = '<clean_room_name>'
ORDER BY event_time DESC

Répertorier tous les événements initiés par un collaborateur spécifié

Remarque

Remplacez <collaborator global metastore ID> par l’ID du metastore global du collaborateur, également appelé identificateur de partage.

SELECT
 clean_room_name, 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)
   ELSE ""
 END AS event_metadata
 FROM system.access.clean_room_events
 WHERE initiator_global_metastore_id = '<collaborator global metastore ID>'
 ORDER BY clean_room_name, event_time DESC

Répertorier tous les collaborateurs pertinents des salles blanches

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'

Répertorier les exécutions de notebook les plus lentes

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 de réussite des exécutions pour chaque notebook

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

Répertorier tous les événements dans lesquels une table spécifiée a été ajoutée aux salles blanches

Remarque

Remplacez le nom de la table default.sales par le nom de table spécifié.

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 = 'default.sales')
ORDER BY clean_room_name, event_time DESC