Referenční tabulka událostí systému čistých místností

Tabulka událostí čistých prostor zaznamenává akce, které jste provedli vy nebo vaši spolupracovníci v rámci vašeho účtu. Tato tabulka obsahuje regionální data z celého vašeho účtu.

Další informace o čistých pokojích najdete v tématu Co je Azure Databricks Clean Rooms?.

cesta k tabulce: Tato systémová tabulka se nachází v system.access.clean_room_events.

Schéma tabulky systémových událostí čistých místností

Systémová tabulka událostí čistých místností používá následující schéma:

Zaznamenané události v čisté místnosti

Tato systémová tabulka protokoluje následující události:

• CLEAN_ROOM_CREATED: Uživatel vytvoří novou čistou místnost.
• CLEAN_ROOM_DELETED: Uživatel odstraní čistou místnost.
• RUN_NOTEBOOK_STARTED: Uživatel zahájí spuštění poznámkového bloku v čisté místnosti.
• RUN_NOTEBOOK_COMPLETED: Je dokončené spuštění poznámkového bloku. Zkontrolujte run_notebook_completed_metadata, abyste ověřili, zda spuštění proběhlo úspěšně nebo ne.
• CLEAN_ROOM_ASSETS_UPDATED: Aktualizovali se aktiva čisté místnosti. Může se jednat o přidání, aktualizaci nebo odstranění aktiv.
• DELETE_OUTPUT_SCHEMA: Platnost výstupního schématu vyprší a je odstraněno. initiator_global_metastore_id pro tento typ události je vždy system, protože k odstranění dochází, když vyprší platnost výstupního schématu.

Aby se zabránilo duplicitním záznamům, vygeneruje se pro každou událost v čistých místnostech, kde spolupracovníci patří do stejného metastoru, pouze jeden záznam. V případě čistých místností, kde spolupracovníci patří do samostatných metastorů, se pro každého spolupracovníka vygenerují jedinečné záznamy.

Dokončené metadatové schéma běhu poznámkového bloku

Sloupec run_notebook_completed_metadata obsahuje informace o metadatech pro události RUN_NOTEBOOK_COMPLETED. Pokud výstupní tabulka byla vytvořena spuštěním poznámkového bloku, informace se protokolují pomocí struktury output_schema.

Sloupec run_notebook_completed_metadata používá následující schéma:

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"

Monitorování fakturovatelného využití čisté místnosti

Další informace o využití čistých místností a nákladech získáte tak, že tuto tabulku spojíte s tabulkou billing.usage pomocí sloupce central_clean_room_id. V tabulce billing.usage je využití čisté místnosti určeno pomocí klíče usage_metadata.central_clean_room_id.

Vzorové dotazy

Následující ukázkové dotazy vám pomůžou získat přehled o aktivitě čisté místnosti ve vašem účtu:

• Zobrazit seznam všech událostí ze zadané čisté místnosti
• Zobrazit seznam všech událostí iniciovaných zadaným spolupracovníkem
• Vyjmenujte všechny relevantní spolupracovníky čistých místností
• Seznam nejpomalejších běhů notebooku
• Míra úspěšnosti spuštění pro každý poznámkový blok
• Seznam všech událostí, ve kterých byla zadaná tabulka přidána do čistých prostor

Výpis všech událostí ze zadané čisté místnosti

Nahraďte :central_clean_room_id centrálním ID čisté místnosti, které naleznete na panelu s podrobnostmi vedle 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

Zobrazení seznamu všech událostí iniciovaných zadaným spolupracovníkem

Jako parametr :initiator_global_metastore_id zadejte globální ID datového metastoru spolupracovníka, které je rovněž označováno jako identifikátor sdílení. Do :collaborator_aliaszadejte alias spolupracovníka. Ve výchozím nastavení jsou dva možné aliasy creator pro tvůrce čisté místnosti a collaborator pro druhou stranu.

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

Zobrazit seznam všech relevantních spolupracovníků čistých místností

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'

Seznam nejpomalejších běhů notebooku

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

Míra úspěšnosti spuštění pro každý poznámkový blok

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

Zobrazí seznam všech událostí, ve kterých byla zadaná tabulka přidána do čistých místností.

Jako :table_name_string parametru zadejte zadaný název tabulky.

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