クリーン ルーム イベント システム テーブル リファレンス
重要
このシステム テーブルは パブリック プレビュー にあります。 テーブルにアクセスするには、 system カタログでスキーマを有効にすることが必要です。 詳細については、「システム テーブル スキーマを有効にする」を参照してください。
[クリーン ルーム イベント] テーブルには、自分または共同作業者がアカウントのクリーン ルーム (パブリック プレビュー) で実行したアクションが記録されます。 このテーブルには、自分のアカウント全体からのリージョンに関するデータが含まれます。
クリーン ルームについて詳しくは、「Azure Databricks Clean Rooms とは」をご覧ください。
テーブル パス: このシステム テーブルは、 clean_room_eventsにあります。
クリーン ルーム イベント システム テーブルのスキーマ
クリーン ルーム イベント システム テーブルでは、次のスキーマが使われます。
| 列名 | データ型 | 説明 | 例 |
|---|---|---|---|
account_id |
string | Databricks アカウントの ID | 7af234db-66d7-4db3-bbf0-956098224879 |
metastore_id |
string | Unity Catalog メタストアの ID | 5a31ba44-bbf4-4174-bf33-e1fa078e6765 |
event_id |
string | クリーン ルーム イベントの ID | db52a413-7a0a-4d49-b742-7ae5f06bc4b2 |
clean_room_name |
string | イベントに関連付けられているクリーン ルームの名前 | market-analysis |
central_clean_room_id |
string | 中央クリーン ルームの ID | e01b6a78-1336-47e1-b63d-3e49aa5b627 |
initiator_global_metastore_id |
string | イベントを開始したコラボレーターのグローバル メタストア ID | aws:us-west-2:ec22936d-cd29-4421-a88a-883fb356776a |
event_time |
timestamp | イベントが発生したときのタイムスタンプ | 2023-01-01T01:01:01.123 |
event_type |
string | イベントの種類。 「ログされるクリーン ルーム イベント」をご覧ください。 | 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 のメタデータ |
{"notebook_name": "market analysis","run_id": "TaskRunId-634124444694206","state": "SUCCESS","duration_in_seconds": 156} |
clean_room_assets_updated |
struct | イベントの種類 CLEAN_ROOM_ASSETS_UPDATED のメタデータ |
{"added_assets": [{"data_object_type": "TABLE","name": "sales","catalog": "demo"}],"updated_assets":[],"removed_assets": []} |
ログされるクリーン ルーム イベント
このシステム テーブルには、次のイベントがログされます。
CLEAN_ROOM_CREATED: ユーザーが新しいクリーン ルームを作成したCLEAN_ROOM_DELETED: ユーザーがクリーン ルームを削除したRUN_NOTEBOOK_STARTED: ユーザーがクリーン ルームでノートブックの実行を開始したRUN_NOTEBOOK_COMPLETED: ノートブックの実行が完了した。 実行が成功したかどうかを確認するには、run_notebook_completed_metadataを調べます。CLEAN_ROOM_ASSETS_UPDATED: クリーン ルームの資産が更新された。 これは、資産の追加、更新、または削除です。
クリーン ルームの課金対象使用量を監視
クリーン ルームの使用状況とコストの詳細については、central_clean_room_id列を使用して、このテーブルを billing.usage テーブルと結合ができます。 billing.usageテーブルでは、クリーン ルームの使用状況はusage_metadata.central_clean_room_id キーを使用して帰属しています。
サンプル クエリ
次のサンプル クエリは、アカウントでのクリーン ルーム アクティビティに関する分析情報を得るのに役立ちます。
- 指定したクリーン ルームのすべてのイベントを一覧表示する
- 指定したコラボレーターによって開始されたすべてのイベントを一覧表示する
- クリーン ルームに関連するすべてのコラボレーターを一覧表示する
- 最も遅いノートブックの実行を一覧表示する
- すべてのノートブックの成功した実行の割合
- 指定したテーブルがクリーン ルームに追加されたすべてのイベントを一覧表示する
指定したクリーン ルームのすべてのイベントを一覧表示する
Note
<clean_room_name> を、実際に指定するクリーン ルーム名に置き換えます。
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
指定したコラボレーターによって開始されたすべてのイベントを一覧表示する
Note
<collaborator global metastore ID> を、コラボレーターのグローバル メタストア ID (共有識別子とも呼ばれます) に置き換えます。
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
クリーン ルームに関連するすべてのコラボレーターを一覧表示する
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
指定したテーブルがクリーン ルームに追加されたすべてのイベントを一覧表示する
Note
テーブル名 default.sales を、実際に指定するテーブル名に置き換えます。
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