Naslaginformatie over de systeemtabel voor cleanroom-gebeurtenissen

Belangrijk

Deze systeemtabel bevindt zich in Openbare Preview. Voor toegang tot de tabel moet het schema zijn ingeschakeld in uw system catalogus. Zie Systeemtabelschema's inschakelenvoor meer informatie.

De tabel met clean room-gebeurtenissen registreert acties die u of uw medewerkers hebben uitgevoerd in clean rooms (openbare preview) in uw account. Deze tabel bevat regionale gegevens uit uw account.

Zie Wat is Azure Databricks Clean Rooms? voor meer informatie over schone ruimten.

tabelpad: deze systeemtabel bevindt zich op system.access.clean_room_events.

Schema van systeemtabel voor clean room events

De clean room events-systeemtabel heeft het volgende schema:

Kolomnaam	Gegevenstype	Beschrijving	Voorbeeld
account_id	tekenreeks	De id van het Databricks-account	7af234db-66d7-4db3 -bbf0-956098224879
metastore_id	tekenreeks	De id van de Unity Catalog-metastore	5a31ba44-bbf4-4174 -bf33-e1fa078e6765
event_id	tekenreeks	De id van de clean room-gebeurtenis	db52a413-7a0a-4d49 -b742-7ae5f06bc4b2
clean_room_name	tekenreeks	Naam van de schone ruimte die is gekoppeld aan de gebeurtenis	market-analysis
central_clean_room_id	tekenreeks	De id van centrale schone kamer	e01b6a78-1336-47e1 -b63d-3e49aa5b627
initiator_global_metastore_id	tekenreeks	Globale metastore-id van de samenwerker die de gebeurtenis heeft gestart	aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a
event_time	timestamp	Tijdstempel toen de gebeurtenis plaatsvond	2023-01-01T01:01:01.123
event_type	tekenreeks	Het type gebeurtenis. Zie Logged clean room events.	CLEAN_ROOM_CREATED
clean_room_created_metadata	Struct	De metagegevens van het gebeurtenistype 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	De metagegevens van het gebeurtenistype CLEAN_ROOM_DELETED	{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }
run_notebook_started_metadata	Struct	De metagegevens van het gebeurtenistype RUN_NOTEBOOK_STARTED	{ "notebook_name": "market analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206" }
run_notebook_completed_metadata	Struct	De metagegevens van het gebeurtenistype RUN_NOTEBOOK_COMPLETED	Zie voltooide notebookuitvoermetagegevens
clean_room_assets_updated_metadata	Struct	De metagegevens van het gebeurtenistype CLEAN_ROOM_ASSETS_UPDATED	{ "added_assets": [{ "data_object_type": "TABLE", "name": "sales", "catalog": "demo"}], "updated_assets":[], "removed_assets": [] }
delete_output_schema_metadata	Struct	De metagegevens van het gebeurtenistype 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	tekenreeks	Alias van de samenwerker die de gebeurtenis heeft gestart. Voor schone ruimten die zijn gemaakt via de gebruikersinterface, is de waarde creator of collaborator. Voor schone ruimten die zijn gemaakt via DE API, zijn dit de aangepaste waarden die zijn opgegeven bij het maken.	creator

Vastgelegde gebeurtenissen voor schone vergaderruimten

In deze systeemtabel worden de volgende gebeurtenissen geregistreerd:

• CLEAN_ROOM_CREATED: Gebruiker maakt een nieuwe schone ruimte.
• CLEAN_ROOM_DELETED: Gebruiker verwijdert een schone ruimte.
• RUN_NOTEBOOK_STARTED: Gebruiker initieert een notebookuitvoering in een schone ruimte.
• RUN_NOTEBOOK_COMPLETED: Er is een uitvoering van een notebook voltooid. Controleer de run_notebook_completed_metadata om te zien of de uitvoering is geslaagd of niet.
• CLEAN_ROOM_ASSETS_UPDATED: De assets van een schone ruimte worden bijgewerkt. Dit kan het toevoegen, bijwerken of verwijderen van assets zijn.
• DELETE_OUTPUT_SCHEMA: een uitvoerschema verloopt en wordt verwijderd. De initiator_global_metastore_id van dit type gebeurtenis is altijd system omdat het verwijderen gebeurt wanneer het uitvoerschema verloopt.

Om dubbele records te voorkomen, wordt er slechts één record verzonden voor elke gebeurtenis in clean rooms waar de medewerkers deel uitmaken van dezelfde metastore. Voor schone ruimten waar medewerkers deel uitmaken van afzonderlijke metastores, worden unieke records uitgegeven voor elke medewerker.

Voltooid metagegevensschema voor notebookuitvoering

De kolom run_notebook_completed_metadata bevat metagegevensinformatie voor RUN_NOTEBOOK_COMPLETED gebeurtenissen. Als een -uitvoertabel door het uitvoeren van het notebook is gemaakt, wordt de informatie vastgelegd met behulp van struct output_schema.

In de kolom run_notebook_completed_metadata wordt het volgende schema gebruikt:

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"

Controleer het factureerbare gebruik van de schone ruimte

Voor meer informatie over het gebruik en de kosten van een schone ruimte kunt u deze tabel samenvoegen met de billing.usage tabel met behulp van de kolom central_clean_room_id. In de billing.usage tabel wordt het schone kamergebruik toegeschreven met behulp van de usage_metadata.central_clean_room_id sleutel.

Voorbeeldquery's

Met de volgende voorbeeldquery's krijgt u inzicht in de activiteiten van de clean room in uw account:

• Alle gebeurtenissen uit een opgegeven clean room weergeven
• alle gebeurtenissen weergeven die zijn geïnitieerd door een opgegeven samenwerker
• Alle relevante samenwerkers van de cleanrooms
• De traagste notebook-uitvoeringen weergeven
• Succesuitvoeringspercentage voor elk notebook
• Alle gebeurtenissen weergeven waarin een opgegeven tabel is toegevoegd aan schone ruimten

Alle gebeurtenissen uit een opgegeven schone ruimte weergeven

Vervang :central_clean_room_id door de centrale clean room ID, die te vinden is in het detailpaneel van de schone ruimte naast 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

Alle gebeurtenissen weergeven die zijn geïnitieerd door een opgegeven samenwerker

Voer voor de parameter :initiator_global_metastore_id de wereldwijde metastore-id van de samenwerker in, ook wel bekend als de deelidentifier. Voer voor :collaborator_aliasde alias van de samenwerker in. Standaard zijn de twee mogelijke aliassen creator voor de maker van de schone ruimte en collaborator voor de andere partij.

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

Alle relevante samenwerkingspartners van de cleanrooms vermelden

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'

De traagste notebookuitvoeringen weergeven

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

Succesuitvoeringspercentage voor elk notebook

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

Een lijst weergeven van alle gebeurtenissen waarin een opgegeven tabel is toegevoegd aan schone ruimten

Voer de opgegeven tabelnaam in voor de :table_name_string paramter.

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