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

Důležité

Tato systémová tabulka je ve verzi Public Preview.

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:

Název sloupce	Datový typ	Popis	Příklad
`account_id`	řetězec	ID účtu Databricks	`7af234db-66d7-4db3` `-bbf0-956098224879`
`metastore_id`	řetězec	ID metastoru UC	`5a31ba44-bbf4-4174` `-bf33-e1fa078e6765`
`event_id`	řetězec	ID události v čisté místnosti	`db52a413-7a0a-4d49` `-b742-7ae5f06bc4b2`
`clean_room_name`	řetězec	Název čisté místnosti přidružené k události	`market-analysis`
`central_clean_room_id`	řetězec	ID centrální čisté místnosti	`e01b6a78-1336-47e1` `-b63d-3e49aa5b627`
`initiator_global_metastore_id`	řetězec	ID globálního metastoru spolupracovníka, který událost zahájil	`aws:us-west-2:ec22936d` `-cd29-4421-a88a-883fb356776a`
`event_time`	časové razítko	Časové razítko, kdy došlo k události	`2023-01-01T01:01:01.123`
`event_type`	řetězec	Typ události. Viz Protokolované události čisté místnosti.	`CLEAN_ROOM_CREATED`
`clean_room_created_metadata`	struktura	Metadata typu události `CLEAN_ROOM_CREATED`	`{` `"collaborators": [` `{"collaborator_global_metastore_id":` `"aws:us-west-2:ec22936d-cd29-4421-a88a-883fb356776a"},` `{"collaborator_global_metastore_id":` `"azure:westus:3be05a26-5a83-478c-8428-9ef9aa67b5d0"}]` `}`
`clean_room_deleted_metadata`	struktura	Metadata typu události `CLEAN_ROOM_DELETED`	`{` `"central_clean_room_id": "af0d4563-2267-412c-9d4a` `-8a59c4895c18"` `}`
`run_notebook_started_metadata`	struktura	Metadata typu události `RUN_NOTEBOOK_STARTED`	`{` `"notebook_name": "Market Analysis",` `"notebook_checksum": "7072696E7468656C6C6F776F7264",` `"run_id": "TaskRunId-634124444694206",` `"notebook_etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",` `"notebook_update_time": "2025-05-04T03:20:35.000Z"` `}`
`run_notebook_completed_metadata`	struktura	Metadata typu události `RUN_NOTEBOOK_COMPLETED`	Podívejte se na metadata dokončeného spuštění poznámkového bloku
`clean_room_assets_updated_metadata`	struktura	Metadata typu události `CLEAN_ROOM_ASSETS_UPDATED`	`{` `"added_assets": [{` `"data_object_type": "TABLE",` `"name": "sales",` `"catalog": "demo"}],` `"updated_assets":[],` `"removed_assets": []` `}`
`asset_review_created_metadata`	struktura	Metadata typu události `ASSET_REVIEW_CREATED`	Podívejte se na události kontroly prostředků čisté místnosti
`output_schema_deleted_metadata`	struktura	Metadata typu události `OUTPUT_SCHEMA_DELETED`	`{` `"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`	řetězec	Alias spolupracovníka, který událost zahájil Pro čisté místnosti vytvořené prostřednictvím uživatelského rozhraní je hodnota buď `creator`, nebo `collaborator`. V případě čistých místností vytvořených prostřednictvím rozhraní API se jedná o vlastní hodnoty zadané při vytváření.	`creator`

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: Obnovují se prostředky čisté místnosti. Může se jednat o přidání, aktualizaci nebo odstranění aktiv.
OUTPUT_SCHEMA_DELETED: 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.
ASSET_REVIEW_CREATED: Uživatel zkontroluje vybavení čistého prostoru. Může se jednat o systémem generované recenze jménem uživatele.

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"

Události kontroly prostředků čisté místnosti

Systémová tabulka zaznamenává metadata o akcích kontroly, jako jsou schválení, zamítnutí a automatické schvalování prováděné u jednotlivých prostředků čisté místnosti. Různé typy revizí vrací následující struktury:

Schválení:

{
  "asset_name": "Market Analysis",
  "data_object_type": "NOTEBOOK_FILE",
 "notebook_metadata: {
    “etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",
  }
  "review_state": "APPROVED",
  "review_subreason": null,
  "auto_approval_rule_id": null,
}

Odmítnutí:

{
  "asset_name": "Market Analysis",
  "data_object_type": "NOTEBOOK_FILE",
 "notebook_metadata: {
    “etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",
  }
  "review_state": "REJECTED",
  "review_subreason": null,
  "auto_approval_rule_id": null,
}

Automatické schválení:

{
  "asset_name": "Market Analysis",
  "data_object_type": "NOTEBOOK_FILE",
 "notebook_metadata: {
    “etag": "f2429adc02d548bacc11db6c8891ec2548d38b4798a80810fbc8be784af22931",
  }
  "review_state": "APPROVED",
  "review_subreason": "AUTO_APPROVED",
  "auto_approval_rule_id": "d0ec563f-6d58-4f38-99c0-376b779e3747",
}

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 ID centrální čisté místnosti :central_clean_room_id, které najdete na panelu podrobností čisté místnosti vedle Centrální 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)
   WHEN event_type = 'OUTPUT_SCHEMA_DELETED' THEN to_json(output_schema_deleted_metadata)
   WHEN event_type = 'ASSET_REVIEW_CREATED' THEN to_json(asset_review_created_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 metastoru spolupracovníka, které je také známé jako identifikátor sdílení. Zadejte :collaborator_aliasalias 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)
   WHEN event_type = 'OUTPUT_SCHEMA_DELETED' THEN to_json(output_schema_deleted_metadata)
   WHEN event_type = 'ASSET_REVIEW_CREATED' THEN to_json(asset_review_created_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

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-04-22