Tabellreferens för clean room events-system

Viktigt!

Den här systemtabellen finns i offentlig förhandsversion. För att få åtkomst till tabellen måste schemat vara aktiverat i din system katalog. Mer information finns i Aktivera systemtabellscheman.

Tabellen med evenemang i det rena rummet innehåller uppgifter om åtgärder som du eller dina medarbetare har vidtagit i rena rum på ditt konto. Den här tabellen innehåller regionala data från hela ditt konto.

Mer information om rena rum finns i Vad är Azure Databricks Clean Rooms?.

Tabellsökväg: Den här systemtabellen finns på system.access.clean_room_events.

Schema för systemtabell för renrumshändelser

Systemtabellen för renrumshändelser använder följande schema:

Kolumnnamn	Datatyp	beskrivning	Exempel
account_id	sträng	ID för Databricks-kontot	7af234db-66d7-4db3 -bbf0-956098224879
metastore_id	sträng	ID:t för Unity Catalog-metaarkivet	5a31ba44-bbf4-4174 -bf33-e1fa078e6765
event_id	sträng	ID:t för händelsen med rent rum	db52a413-7a0a-4d49 -b742-7ae5f06bc4b2
clean_room_name	sträng	Namnet på det rena rum som är associerat med händelsen	market-analysis
central_clean_room_id	sträng	Centrala renrummets ID	e01b6a78-1336-47e1 -b63d-3e49aa5b627
initiator_global_metastore_id	sträng	Globalt metaarkiv-ID för medarbetaren som initierade händelsen	aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a
event_time	tidsstämpel	Tidsstämpel när händelsen ägde rum	2023-01-01T01:01:01.123
event_type	sträng	Typen av händelse. Se Loggade renrumshändelser.	CLEAN_ROOM_CREATED
clean_room_created_metadata	Struktur	Metadata för händelsetypen 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	Struktur	Metadata för händelsetypen CLEAN_ROOM_DELETED	{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }
run_notebook_started_metadata	Struktur	Metadata för händelsetypen RUN_NOTEBOOK_STARTED	{ "notebook_name": "market analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206" }
run_notebook_completed_metadata	Struktur	Metadata för händelsetypen RUN_NOTEBOOK_COMPLETED	Se Slutförda notebook-körningsmetadata
clean_room_assets_updated_metadata	Struktur	Metadata för händelsetypen CLEAN_ROOM_ASSETS_UPDATED	{ "added_assets": [{ "data_object_type": "TABLE", "name": "sales", "catalog": "demo"}], "updated_assets":[], "removed_assets": [] }
delete_output_schema_metadata	struct	Metadata för händelsetypen 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	sträng	Alias för medarbetaren som initierade händelsen. För rena rum som skapats via användargränssnittet är värdet antingen creator eller collaborator. För rena rum som skapats via API är de anpassade värden som anges när de skapas.	creator

Loggade renrumshändelser

Den här systemtabellen loggar följande händelser:

• CLEAN_ROOM_CREATED: Användaren skapar ett nytt rent rum.
• CLEAN_ROOM_DELETED: Användaren tar bort ett rent rum.
• RUN_NOTEBOOK_STARTED: Användaren initierar en notebook-fil som körs i ett rent rum.
• RUN_NOTEBOOK_COMPLETED: En notebook-körning har slutförts. Kontrollera run_notebook_completed_metadata för att avgöra om körningen var lyckad eller inte.
• CLEAN_ROOM_ASSETS_UPDATED: Ett rent rums tillgångar uppdateras. Det kan vara att lägga till, uppdatera eller ta bort tillgångar.
• DELETE_OUTPUT_SCHEMA: Ett utdataschema upphör att gälla och tas bort. Den initiator_global_metastore_id för den här händelsetypen är alltid system eftersom borttagningen sker när utdataschemat upphör att gälla.

För att förhindra duplicerade poster avges endast en post för varje händelse i rena rum där samarbetspartners tillhör samma metaarkiv. För rena rum där medarbetare tillhör separata metaarkiv genereras unika poster för varje medarbetare.

Slutfört metadataschema för notebook-körning

Kolumnen run_notebook_completed_metadata innehåller metadatainformation för RUN_NOTEBOOK_COMPLETED händelser. Om en utdatatabell skapades av notebook-körningen loggas informationen med hjälp av output_schema struktur.

Kolumnen run_notebook_completed_metadata använder följande schema:

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"

Övervaka fakturerbar användning av rent rum

Om du vill veta mer om användning och kostnader för rent rum kan du ansluta den här tabellen till tabellen billing.usage med kolumnen central_clean_room_id. I tabellen billing.usage tillskrivs renrumsanvändning med hjälp av usage_metadata.central_clean_room_id-nyckeln.

Exempelfrågor

Följande exempelfrågor hjälper dig att få insikt i renrumsaktivitet i ditt konto:

• Lista alla händelser från ett angivet rent rum
• Lista alla händelser som initieras av en angiven medarbetare
• Lista alla relevanta medarbetare i de rena rummen
• Lista de långsammaste notebook-körningarna
• Framgångsrik körfrekvens för varje notebook
• Lista alla händelser där en angiven tabell har lagts till för att rensa rum

Visa en lista över alla händelser från ett angivet rent rum

Ersätt :central_clean_room_id med det centrala renrums-ID:t, som finns i det rena rummets informationspanel bredvid central-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

Visa en lista över alla händelser som initierats av en angiven medarbetare

För parametern :initiator_global_metastore_id anger du medarbetarens globala metaarkiv-ID, även kallat delningsidentifierare. För :collaborator_aliasanger du medarbetarens alias. Som standard är de två möjliga aliasen creator för skaparen av det rena rummet och collaborator för den andra parten.

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

Visa en lista över alla relevanta medarbetare i de rena rummen

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'

Lista de långsammaste anteckningsbokssessionerna

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

Framgångsraten för varje anteckningsbok

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

Visa en lista över alla händelser där en angiven tabell lades till i rena rum

För paramtern :table_name_string anger du det angivna tabellnamnet.

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