共用方式為

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

  • 發行項

重要

此系統數據表位於公開預覽版 。 若要存取資料表，必須在您的 system 目錄中啟用架構。 如需詳細資訊，請參閱 啟用系統資料表架構。

無塵室事件表會記錄您或您帳戶中的協作夥伴在無塵室（公開預覽）上採取的動作。 此資料表包含來自您帳戶的區域數據。

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

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

無塵室事件系統資料表結構

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

欄位名稱 資料類型 描述 範例
account_id 字串 Databricks 帳戶的標識符 7af234db-66d7-4db3

-bbf0-956098224879
metastore_id 字串 Unity Catalog 中繼存放區的識別碼 5a31ba44-bbf4-4174

-bf33-e1fa078e6765
event_id 字串 清理室事件的標識碼 db52a413-7a0a-4d49

-b742-7ae5f06bc4b2
clean_room_name 字串 與事件相關聯的清理室名稱 market-analysis
central_clean_room_id 字串 中央清潔室的標識碼 e01b6a78-1336-47e1

-b63d-3e49aa5b627
initiator_global_metastore_id 字串 起始事件共同作業者的全域中繼存放區標識符 aws:us-west-2:ec22936d

-cd29-4421-a88a-883fb356776a
event_time timestamp 事件發生時的時間戳 2023-01-01T01:01:01.123
event_type 字串 事件的類型。 請參閱 記錄的清理室事件。 CLEAN_ROOM_CREATED
clean_room_created_metadata struct 事件類型的元數據 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 事件類型的元數據 CLEAN_ROOM_DELETED {

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

-8a59c4895c18"

}
run_notebook_started_metadata struct 事件類型的元數據 RUN_NOTEBOOK_STARTED {

"notebook_name": "market analysis",

"notebook_checksum": "7072696E7468656C6C6F776F7264",

"run_id": "TaskRunId-634124444694206"

}
run_notebook_completed_metadata struct 事件類型的元數據 RUN_NOTEBOOK_COMPLETED 請參閱已完成的筆記本執行元數據
clean_room_assets_updated_metadata struct 事件類型的元數據 CLEAN_ROOM_ASSETS_UPDATED {

"added_assets": [{

"data_object_type": "TABLE",

"name": "sales",

"catalog": "demo"}],

"updated_assets":[],

"removed_assets": []

}
delete_output_schema_metadata struct 事件類型的元數據 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 字串 起始事件之共同作業者的別名。 對於透過 UI 建立的無塵室，此值為 creator 或 collaborator。 針對透過 API 建立的無塵室，這些自訂值是在建立時指定的。 creator

記錄的清理室事件

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

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

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

已完成的筆記本運行記錄元數據架構

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"

監視乾淨的會議室計費使用量

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

範例查詢

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

列出來自指定清理室的所有事件

將 :central_clean_room_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)
   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 參數，輸入共同作業者的全域中繼存放區標識碼，也稱為共用標識符。 針對 :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)
   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