Informazioni di riferimento sulla tabella di sistema degli eventi della sala pulita

Importante

Questa tabella di sistema si trova in versione di anteprima pubblica. Per accedere alla tabella, lo schema deve essere abilitato nel catalogo system. Per ulteriori informazioni, vedere Abilitazione degli schemi delle tabelle di sistema.

La tabella degli eventi della sala pulita registra le azioni eseguite dall'utente o dai collaboratori nelle stanze pulite (anteprima pubblica) nell'account. Questa tabella include i dati regionali dal tuo account.

Per altre informazioni sulle stanze pulite, vedere Che cos'è Azure Databricks Clean Rooms?.

percorso tabella: questa tabella di sistema si trova in system.access.clean_room_events.

Schema della tabella di sistema degli eventi della sala pulita

La tabella di sistema degli eventi della sala pulita usa lo schema seguente:

Nome colonna	Tipo di dati	Descrizione	Esempio
account_id	string	ID dell'account Databricks	7af234db-66d7-4db3 -bbf0-956098224879
metastore_id	string	ID del metastore del catalogo Unity	5a31ba44-bbf4-4174 -bf33-e1fa078e6765
event_id	string	ID dell'evento della sala pulita	db52a413-7a0a-4d49 -b742-7ae5f06bc4b2
clean_room_name	string	Nome della stanza pulita associata all'evento	market-analysis
central_clean_room_id	string	ID della stanza pulita centrale	e01b6a78-1336-47e1 -b63d-3e49aa5b627
initiator_global_metastore_id	string	ID metastore globale del collaboratore che ha avviato l'evento	aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a
event_time	timestamp	Timestamp quando si è verificato l'evento	2023-01-01T01:01:01.123
event_type	string	Tipo di evento. Vedere Eventi della sala pulita registrati.	CLEAN_ROOM_CREATED
clean_room_created_metadata	struct	Metadati del tipo di evento 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	Metadati del tipo di evento CLEAN_ROOM_DELETED	{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }
run_notebook_started_metadata	struct	Metadati del tipo di evento RUN_NOTEBOOK_STARTED	{ "notebook_name": "market analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206" }
run_notebook_completed_metadata	struct	Metadati del tipo di evento RUN_NOTEBOOK_COMPLETED	Vedi i metadati dell'esecuzione del notebook completato
clean_room_assets_updated_metadata	struct	Metadati del tipo di evento CLEAN_ROOM_ASSETS_UPDATED	{ "added_assets": [{ "data_object_type": "TABLE", "name": "sales", "catalog": "demo"}], "updated_assets":[], "removed_assets": [] }
delete_output_schema_metadata	struct	Metadati del tipo di evento DELETE_OUTPUT_SCHEMA	{ "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	string	Alias del collaboratore che ha avviato l'evento. Per le stanze pulite create tramite l'interfaccia utente, il valore è creator o collaborator. Per le stanze pulite create tramite API, sono i valori personalizzati specificati durante la creazione.	creator

Eventi registrati della sala pulita

Questa tabella di sistema registra gli eventi seguenti:

• CLEAN_ROOM_CREATED: l'utente crea una nuova stanza pulita.
• CLEAN_ROOM_DELETED: l'utente elimina una stanza pulita.
• RUN_NOTEBOOK_STARTED: l'utente avvia l'esecuzione di un notebook in una stanza pulita.
• RUN_NOTEBOOK_COMPLETED: l'esecuzione di un notebook è stata completata. Controllare il run_notebook_completed_metadata per verificare se l'esecuzione è riuscita o meno.
• CLEAN_ROOM_ASSETS_UPDATED: gli asset di una stanza pulita vengono aggiornati. Questo potrebbe essere l'aggiunta, l'aggiornamento o l'eliminazione di asset.
• DELETE_OUTPUT_SCHEMA: uno schema di output scade e viene eliminato. Il initiator_global_metastore_id per questo tipo di evento è sempre system perché l'eliminazione si verifica alla scadenza dello schema di output.

Per evitare record duplicati, viene emesso un solo record per ogni evento nelle stanze pulite in cui i collaboratori appartengono allo stesso metastore. Per le camere bianche in cui i collaboratori appartengono a metastore separati, vengono generati record univoci per ogni collaboratore.

Schema dei metadati di esecuzione del notebook completato

La colonna run_notebook_completed_metadata contiene informazioni sui metadati per gli eventi RUN_NOTEBOOK_COMPLETED. Se una tabella di output è stata creata durante l'esecuzione del notebook, le informazioni vengono registrate utilizzando la struttura output_schema.

La colonna run_notebook_completed_metadata usa lo schema seguente:

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"

Monitorare l'utilizzo fatturabile della sala pulita

Per altre informazioni sull'utilizzo e sui costi della sala pulita, è possibile unire questa tabella alla tabella billing.usage usando la colonna central_clean_room_id. Nella tabella billing.usage l'utilizzo della stanza pulita viene attribuito usando la chiave usage_metadata.central_clean_room_id.

Query di esempio

Le query di esempio seguenti consentono di ottenere informazioni dettagliate sull'attività della stanza pulita nell'account:

• Elenca tutti gli eventi da una camera bianca specificata
• Elenca tutti gli eventi avviati da un collaboratore specificato
• Elencare tutti i collaboratori rilevanti delle camere pulite
• Elenca le esecuzioni di notebook più lente
• Frequenza di esecuzione riuscita per ogni notebook
• Elenca tutti gli eventi in cui è stata aggiunta una tabella specificata alle stanze pulite

Elencare tutti gli eventi da una stanza pulita specificata

Sostituire :central_clean_room_id con l'ID della stanza pulita centrale, disponibile nel pannello dei dettagli della stanza pulita accanto a ID centrale.

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 central_clean_room_id = :central_clean_room_id
ORDER BY event_time DESC

Elencare tutti gli eventi avviati da un collaboratore specificato

Per il parametro :initiator_global_metastore_id immettere l'ID metastore globale del collaboratore, noto anche come identificatore di condivisione. Per :collaborator_aliasimmettere l'alias del collaboratore. Per impostazione predefinita, i due alias possibili sono creator per l'autore della stanza pulita e collaborator per l'altra parte.

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)
   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

Elencare tutti i collaboratori pertinenti delle camere pulite

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'

Elenca le esecuzioni più lente del notebook

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

Frequenza di esecuzione riuscita per ogni 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

Elenca tutti gli eventi in cui è stata aggiunta una tabella specificata alle camere bianche

Per il parametro :table_name_string immettere il nome della tabella specificato.

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