Tabellreferens för clean room events-system

Tabellen med evenemang i det rena rummet registrerar åtgärder som du eller dina medarbetare vidtar i rena rum (offentlig förhandsversion) i ditt konto. Den här tabellen innehåller regionala data från hela ditt konto.

Mer information om rena rum finns i Vad är Azure Databricks Clean Rooms?.

Tabellsökväg: Den här systemtabellen finns på clean_room_events.

Schema för systemtabell för rensa rumshändelser

Systemtabellen för renrumshändelser använder följande schema:

Loggade clean room-händelser

Den här systemtabellen loggar följande händelser:

• CLEAN_ROOM_CREATED: Användaren skapar ett nytt rent rum
• CLEAN_ROOM_DELETED: Användaren tar bort ett rent rum
• RUN_NOTEBOOK_STARTED: Användaren ananvänder en notebook-körning i ett rent rum
• RUN_NOTEBOOK_COMPLETED: En notebook-körning har slutförts. run_notebook_completed_metadata Kontrollera om körningen lyckades eller inte.
• CLEAN_ROOM_ASSETS_UPDATED: Ett rent rums tillgångar uppdateras. Det kan vara att lägga till, uppdatera eller ta bort tillgångar.

Övervaka fakturerbar användning av rent rum

Om du vill veta mer om användning och kostnader för rent rum kan du ansluta den billing.usage här tabellen till tabellen med hjälp av central_clean_room_id kolumnen . I tabellen billing.usage tillskrivs användningen av rent rum med hjälp av usage_metadata.central_clean_room_id nyckeln.

Exempelfrågor

Följande exempelfrågor hjälper dig att få insikt i renrumsaktivitet i ditt konto:

• Visa en lista över alla händelser från ett angivet rent rum
• Visa en lista över alla händelser som initierats av en angiven medarbetare
• Visa en lista över alla relevanta medarbetare i de rena rummen
• Lista de långsammaste notebook-körningarna
• Lyckad körningsfrekvens för varje notebook-fil
• Visa en lista över alla händelser där en angiven tabell lades till i rena rum

Visa en lista över alla händelser från ett angivet rent rum

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

Visa en lista över alla händelser som initierats av en angiven medarbetare

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

Visa en lista över alla relevanta medarbetare i de rena rummen

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'

Lista de långsammaste notebook-körningarna

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

Lyckad körningsfrekvens för varje notebook-fil

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

Visa en lista över alla händelser där en angiven tabell lades till i rena rum

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