مرجع جدول نظام أحداث الغرف النظيفة

يسجل جدول أحداث الغرف النظيفة الإجراءات التي اتخذتها أنت أو المتعاونون معك على غرف نظيفة (معاينة عامة) في حسابك. يتضمن هذا الجدول بيانات إقليمية من جميع أنحاء حسابك.

لمزيد من المعلومات حول الغرف النظيفة، راجع ما هي الغرف النظيفة في Azure Databricks؟.

مسار الجدول: يقع جدول النظام هذا في clean_room_events.

مخطط جدول نظام أحداث الغرف النظيفة

يستخدم جدول نظام أحداث الغرفة النظيفة المخطط التالي:

أحداث الغرفة النظيفة المسجلة

يسجل جدول النظام هذا الأحداث التالية:

• CLEAN_ROOM_CREATED: يقوم المستخدم بإنشاء غرفة نظيفة جديدة
• CLEAN_ROOM_DELETED: يحذف المستخدم غرفة نظيفة
• RUN_NOTEBOOK_STARTED: يقوم المستخدم بتحريك دفتر ملاحظات يعمل في غرفة نظيفة
• RUN_NOTEBOOK_COMPLETED: اكتمل تشغيل دفتر الملاحظات. run_notebook_completed_metadata تحقق لمعرفة ما إذا كان التشغيل ناجحا أم لا.
• CLEAN_ROOM_ASSETS_UPDATED: يتم تحديث أصول الغرفة النظيفة. قد يؤدي ذلك إلى إضافة الأصول أو تحديثها أو حذفها.

مراقبة الاستخدام القابل للفوترة للغرفة النظيفة

لمعرفة المزيد حول استخدام الغرفة النظيفة والتكاليف، يمكنك الانضمام إلى هذا الجدول مع billing.usage الجدول باستخدام central_clean_room_id العمود. في billing.usage الجدول، يتم إسناد استخدام الغرفة النظيفة usage_metadata.central_clean_room_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 clean_room_name = '<clean_room_name>'
ORDER BY event_time DESC

سرد كافة الأحداث التي بدأها متعاون محدد

SELECT
 clean_room_name, 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 = '<collaborator global metastore ID>'
 ORDER BY clean_room_name, event_time DESC

سرد جميع المتعاونين ذوي الصلة في الغرف النظيفة

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'

سرد أبطأ عمليات تشغيل دفتر الملاحظات

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

معدل تشغيل النجاح لكل دفتر ملاحظات

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

سرد جميع الأحداث التي تمت فيها إضافة جدول محدد إلى الغرف النظيفة

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 = 'default.sales')
ORDER BY clean_room_name, event_time DESC