清理室事件系統數據表參考

無塵室事件表會記錄您或您帳戶中的協作者對無塵室所採取的動作。 此資料表包含來自您帳戶的區域數據。

如需清理室的詳細資訊，請參閱 什麼是 Azure Databricks Clean Rooms？。

資料表路徑：此系統資料表位於 system.access.clean_room_events。

潔淨室事件系統資料表架構

清理室事件系統資料表會使用下列架構：

記錄的清理室事件

此系統資料表會記錄下列事件：

• CLEAN_ROOM_CREATED：使用者會建立新的乾淨的房間。
• CLEAN_ROOM_DELETED：使用者刪除乾淨的房間。
• RUN_NOTEBOOK_STARTED：使用者在無塵室中啟動筆記本運行。
• RUN_NOTEBOOK_COMPLETED：筆記本程序執行已完成。 請檢查 run_notebook_completed_metadata，以查看執行是否成功。
• CLEAN_ROOM_ASSETS_UPDATED：清理室的資產已更新。 這可能是新增、更新或刪除資產。
• OUTPUT_SCHEMA_DELETED：輸出架構過期且已刪除。 此事件類型的 initiator_global_metastore_id 一律 system，因為輸出架構到期時就會刪除。
• ASSET_REVIEW_CREATED：使用者檢閱無塵室資產。 這可以包含代表使用者由系統產生的評論。

若要防止重複紀錄，在乾淨室內並且共同作業者屬於相同中繼存放區的情況下，每項事件將只產生一筆紀錄。 對於合作夥伴所屬於個別數據中繼儲存庫的清潔室，會針對每個合作夥伴發出唯一的記錄。

已完成的筆記本執行結果元數據架構

run_notebook_completed_metadata 數據行包含 RUN_NOTEBOOK_COMPLETED 事件的元數據資訊。 如果由筆記本執行所產生的 輸出數據表，則會使用 output_schema 結構來記錄該資訊。

run_notebook_completed_metadata 欄使用下列模式：

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"

無塵室資產審查活動

系統數據表會記錄有關檢閱動作的元數據，例如對個別清理室資產執行的核准、拒絕和自動核准。 不同的檢閱類型會傳回下列結構：

批准：

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

拒絕：

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

自動核准：

{
  "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",
}

監測潔淨室的計費使用次數

若要深入瞭解無塵室的使用量和成本，您可以使用 billing.usage 欄將此表與 central_clean_room_id 表聯結。 在 billing.usage 表格中，無塵室的用途是透過 usage_metadata.central_clean_room_id 鍵來表示的。

範例查詢

下列範例查詢可協助您深入了解帳戶中的清理室活動：

• 從指定的乾淨房間列出所有事件
• 列出指定共同作業者所起始的所有事件
• 列出無塵室的所有相關合作夥伴
• 列出運行最慢的筆記本
• 每個筆記本的成功執行率
• 列出所有將指定資料表新增至資料清理室的事件

列出來自指定無塵室的所有事件

將 :central_clean_room_id 替換為中央無塵室ID，您可以在中央ID旁的無塵室的詳細資料面板中找到。

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

列出指定共同作業者所起始的所有事件

針對 :initiator_global_metastore_id 參數，輸入共同作業者的全域 Metastore 識別碼，也稱為共用識別碼。 針對 :collaborator_alias，輸入共同作業者的別名。 根據預設, creator 是為清潔室建立者的可能別名，而 collaborator 是為另一方的可能別名。

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

列出潔淨室的所有相關合作人員

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'

列出最慢的筆記本運行次數

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

每個筆記本的成功執行運行率

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

列出所有將指定表新增至潔淨室的事件

針對 :table_name_string 參數，輸入指定的數據表名稱。

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