Temiz oda olayları sistem tablosu referansı

Önemli

Bu sistem tablosu Genel Önizlemeiçindedir.

Temiz oda olayları tablosu, sizin veya ortak çalışanlarınızın hesabınızdaki temiz odalar üzerinde gerçekleştirdiği eylemleri kaydeder. Bu tablo, hesabınızdaki bölgesel verileri içerir.

Temiz odalar hakkında daha fazla bilgi için bkz . Azure Databricks Clean Rooms nedir?.

Tablo yolu: Bu sistem tablosu system.access.clean_room_eventskonumunda bulunur.

Temiz oda olayları sistem tablosu şeması

Temiz oda olayları sistem tablosu aşağıdaki şemayı kullanır:

Sütun adı	Veri türü	Açıklama	Örnek
`account_id`	Dize	Databricks hesabının kimliği	`7af234db-66d7-4db3` `-bbf0-956098224879`
`metastore_id`	Dize	UC meta veri deposunun kimliği	`5a31ba44-bbf4-4174` `-bf33-e1fa078e6765`
`event_id`	Dize	Temiz oda olayının ID'si	`db52a413-7a0a-4d49` `-b742-7ae5f06bc4b2`
`clean_room_name`	Dize	Olayla ilişkili temiz odanın adı	`market-analysis`
`central_clean_room_id`	Dize	Merkezi temiz odanın kimlik numarası	`e01b6a78-1336-47e1` `-b63d-3e49aa5b627`
`initiator_global_metastore_id`	Dize	Olayı başlatan ortak çalışanın genel meta veri deposu kimliği	`aws:us-west-2:ec22936d` `-cd29-4421-a88a-883fb356776a`
`event_time`	Tarih damgası	Olayın gerçekleştiği zaman damgası	`2023-01-01T01:01:01.123`
`event_type`	Dize	Olayın türü. Bkz. Günlüğe kaydedilen temiz oda olayları.	`CLEAN_ROOM_CREATED`
`clean_room_created_metadata`	yapı	Olay türünün meta verileri `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`	yapı	Olay türünün meta verileri `CLEAN_ROOM_DELETED`	`{` `"central_clean_room_id": "af0d4563-2267-412c-9d4a` `-8a59c4895c18"` `}`
`run_notebook_started_metadata`	yapı	Olay türünün meta verileri `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`	yapı	Olay türünün meta verileri `RUN_NOTEBOOK_COMPLETED`	Bkz. Tamamlanan not defteri çalışması meta verileri
`clean_room_assets_updated_metadata`	yapı	Olay türünün meta verileri `CLEAN_ROOM_ASSETS_UPDATED`	`{` `"added_assets": [{` `"data_object_type": "TABLE",` `"name": "sales",` `"catalog": "demo"}],` `"updated_assets":[],` `"removed_assets": []` `}`
`asset_review_created_metadata`	yapı	Olay türünün meta verileri `ASSET_REVIEW_CREATED`	Temiz oda varlık inceleme etkinliklerine bakın
`output_schema_deleted_metadata`	yapı	Olay türünün meta verileri `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`	Dize	Etkinliği başlatan ortak çalışanın takma adı. UI aracılığıyla oluşturulan temiz odalar için değer `creator` veya `collaborator`. API aracılığıyla oluşturulan temiz odalar, yaratılırken belirtilen özel değerlerdir.	`creator`

Günlüğe kaydedilen temiz oda olayları

Bu sistem tablosu aşağıdaki olayları günlüğe kaydeder:

CLEAN_ROOM_CREATED: Kullanıcı yeni bir temiz oda oluşturur.
CLEAN_ROOM_DELETED: Kullanıcı temiz bir odayı siler.
RUN_NOTEBOOK_STARTED: Kullanıcı temiz bir odada bir not defteri çalıştırması başlatır.
RUN_NOTEBOOK_COMPLETED: Not defteri çalıştırması tamamlandı. Çalıştırmanın başarılı olup olmadığını görmek için run_notebook_completed_metadata'ı kontrol edin.
CLEAN_ROOM_ASSETS_UPDATED: Temiz bir odanın varlıkları güncelleştirilir. Bu, varlıkları ekleme, güncelleştirme veya silme olabilir.
OUTPUT_SCHEMA_DELETED: Çıkış şemasının süresi dolar ve silinir. Bu olay türü için initiator_global_metastore_id her zaman system'dir çünkü silme işlemi, çıktı şemasının süresi dolduğunda gerçekleşir.
ASSET_REVIEW_CREATED: Kullanıcı temiz bir oda öğesini inceler. Bu, kullanıcı adına sistem tarafından oluşturulan incelemeleri içerebilir.

Yinelenen kayıtları önlemek için, ortak çalışanların aynı meta veri deposuna ait olduğu temiz odalardaki her olay için yalnızca bir kayıt yayılır. Ayrı meta depolara ait olan ortak çalışanların bulunduğu temiz alanlar için, her bir ortak çalışan için benzersiz kayıtlar oluşturulur.

Tamamlanan not defteri çalıştırma meta veri şeması

run_notebook_completed_metadata sütunu, RUN_NOTEBOOK_COMPLETED olayları için meta veri bilgilerini içerir. Not defteri çalıştırması tarafından bir çıkış tablosu oluşturulduysa, bilgiler output_schema yapısı kullanılarak kayıt altına alınır.

run_notebook_completed_metadata sütunu aşağıdaki şemayı kullanır:

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"

Temiz oda varlık inceleme etkinlikleri

Sistemler tablosu, tek tek temiz oda varlıkları üzerinde gerçekleştirilen onaylar, reddetmeler ve otomatik onaylar gibi gözden geçirme eylemleriyle ilgili meta verileri kaydeder. Farklı gözden geçirme türleri aşağıdaki yapıları döndürür:

Onay:

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

Reddetme

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

Otomatik onay:

{
  "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",
}

Temiz oda faturalanabilir kullanımını izleyin

Temiz oda kullanımı ve maliyetleri hakkında daha fazla bilgi edinmek için billing.usage sütununu kullanarak bu tabloyu central_clean_room_id tablosuyla birleştirebilirsiniz. billing.usage tablosunda temiz oda kullanımı, usage_metadata.central_clean_room_id anahtarı kullanılarak ilişkilendirilir.

Örnek sorgular

Aşağıdaki örnek sorgular, hesabınızdaki temiz oda etkinliği hakkında içgörü kazanmanıza yardımcı olur:

Belirtilen temiz bir odadan gelen tüm olayları listele
Belirtilen bir ortak çalışan tarafından başlatılan tüm olayları listele
Temiz odaların tüm ilgili ortak çalışanlarını listele
En yavaş not defteri çalışmaları listesini oluştur
Her bir notebook için başarı oranı
Belirtilen bir tablonun temiz odalara eklendiği tüm olayları listele

Belirtilen temiz odadan gelen tüm olayları listeleme

Merkezi temiz oda kimliğini bulabileceğiniz, Merkez Kimlik'i gösteren temiz oda ayrıntılar panelindeki :central_clean_room_id yanındaki ile değiştirin.

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

Belirtilen bir ortak çalışan tarafından başlatılan tüm olayları listeleme

parametresi için :initiator_global_metastore_id ortak çalışanın paylaşım tanımlayıcısı olarak da bilinen genel meta veri deposu kimliğini girin. :collaborator_alias alanına, ortak çalışanın diğer adını girin. Varsayılan olarak, iki olası takma ad temiz odanın oluşturucusu için creator ve diğer taraf için collaborator'dir.

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

Temiz odaların tüm ilgili işbirlikçilerini listele

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'

En yavaş not defteri çalıştırmalarını listele

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

Her not defteri için başarı oranı

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

Belirtilen bir tablonun temiz odalara eklendiği tüm olayları listeleme

:table_name_string parametre için, belirttiğiniz tablo adını girin.

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-06-07