Megosztás a következőn keresztül:

Clean room events system table reference

  • Cikk

Fontos

Ez a rendszertábla nyilvános előzetes verzióban érhető el. A táblázat eléréséhez engedélyezni kell a sémát a system katalógusban. További információ: Rendszertábla-sémák engedélyezése.

A tisztaszoba eseménytáblája rögzíti az Ön vagy közreműködői által a fiók tiszta helyiségeiben (nyilvános előzetes verzió) végrehajtott műveleteket. Ez a táblázat regionális adatokat tartalmaz a teljes fiókból.

A tiszta szobákról további információt az Azure Databricks Tiszta szobák című témakörben talál.

Táblázat elérési útja: Ez a rendszertábla a következő helyen clean_room_eventstalálható: .

Tiszta helyiségesemények rendszertáblázatának sémája

A tisztaszobás események rendszertáblája a következő sémát használja:

Oszlop neve Adattípus Leírás Példa
account_id húr A Databricks-fiók azonosítója 7af234db-66d7-4db3

-bbf0-956098224879
metastore_id húr A Unity Catalog> metaadattár azonosítója 5a31ba44-bbf4-4174

-bf33-e1fa078e6765
event_id húr A tisztaszoba esemény azonosítója db52a413-7a0a-4d49

-b742-7ae5f06bc4b2
clean_room_name húr Az eseményhez társított tiszta helyiség neve market-analysis
central_clean_room_id húr A központi tisztaszoba azonosítója e01b6a78-1336-47e1

-b63d-3e49aa5b627
initiator_global_metastore_id húr Az eseményt kezdeményező közreműködő globális metaadattár-azonosítója aws:us-west-2:ec22936d

-cd29-4421-a88a-883fb356776a
event_time időbélyeg Időbélyeg az esemény bekövetkezésekor 2023-01-01T01:01:01.123
event_type húr Az esemény típusa. Lásd: Naplózott tisztaszoba-események. CLEAN_ROOM_CREATED
clean_room_created_metadata Struct Az eseménytípus metaadatai 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 Az eseménytípus metaadatai CLEAN_ROOM_DELETED {

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

-8a59c4895c18"

}
run_notebook_started_metadata Struct Az eseménytípus metaadatai RUN_NOTEBOOK_STARTED {

"notebook_name": "market analysis",

"notebook_checksum": "7072696E7468656C6C6F776F7264",

"run_id": "TaskRunId-634124444694206"

}
run_notebook_completed_metadata Struct Az eseménytípus metaadatai RUN_NOTEBOOK_COMPLETED {

"notebook_name": "market analysis",

"run_id": "TaskRunId-634124444694206",

"state": "SUCCESS",

"duration_in_seconds": 156

}
clean_room_assets_updated Struct Az eseménytípus metaadatai CLEAN_ROOM_ASSETS_UPDATED {

"added_assets": [{

"data_object_type": "TABLE",

"name": "sales",

"catalog": "demo"}],

"updated_assets":[],

"removed_assets": []

}

Naplózott tisztaszoba-események

Ez a rendszertábla a következő eseményeket naplózza:

  • CLEAN_ROOM_CREATED: A felhasználó új tiszta helyiséget hoz létre
  • CLEAN_ROOM_DELETED: A felhasználó töröl egy tiszta helyiséget
  • RUN_NOTEBOOK_STARTED: A felhasználó egy tiszta szobában futtatott jegyzetfüzetet initass
  • RUN_NOTEBOOK_COMPLETED: A jegyzetfüzet futtatása befejeződött. Ellenőrizze, run_notebook_completed_metadata hogy a futtatás sikeres volt-e.
  • CLEAN_ROOM_ASSETS_UPDATED: A tiszta helyiség eszközei frissülnek. Ez lehet objektumok hozzáadása, frissítése vagy törlése.

Tiszta helyiség számlázható használatának monitorozása

Ha többet szeretne megtudni a tiszta helyiség használatáról és költségeiről, az oszlop használatával összekapcsolhatja ezt a táblázatot a billing.usage central_clean_room_id táblával. A táblázatban a billing.usage tiszta helyiség használatának attribútuma a usage_metadata.central_clean_room_id kulcs használatával történik.

Minta lekérdezések

Az alábbi minta lekérdezések segítségével betekintést nyerhet a fiók tiszta helyiségeinek tevékenységébe:

Adott tiszta helyiség összes eseményének listázása

Feljegyzés

Cserélje le <clean_room_name> a megadott tiszta helyiség nevére.

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

Egy adott közreműködő által kezdeményezett összes esemény listázása

Feljegyzés

Cserélje le <collaborator global metastore ID> a közreműködő globális metaadattár-azonosítójára, más néven a megosztási azonosítóra.

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

A tiszta helyiségek összes érintett közreműködőjének listázása

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'

A leglassabb jegyzetfüzetfuttatások listázása

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

Sikeres futtatási arány minden jegyzetfüzethez

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

Az összes olyan esemény listázása, amelyben egy megadott tábla lett hozzáadva a tiszta szobákhoz

Feljegyzés

Cserélje le a tábla nevét default.sales a megadott táblanévre.

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