مرجع جدول نظام محفوظات الاستعلام
هام
يوجد جدول النظام هذا في المعاينة العامة. للوصول إلى الجدول، يجب تمكين المخطط في الكتالوج.system لمزيد من المعلومات، راجع تمكين مخططات جدول النظام.
تتضمن هذه المقالة معلومات حول جدول نظام محفوظات الاستعلام، بما في ذلك مخطط الجدول.
هام
للوصول إلى جدول نظام محفوظات الاستعلام، يجب تمكين query المخطط. للحصول على إرشادات حول تمكين مخططات النظام، راجع تمكين مخططات جدول النظام.
مسار الجدول: يقع جدول النظام هذا في system.query.history.
استخدام جدول محفوظات الاستعلام
يتضمن جدول محفوظات الاستعلام سجلات لكل عبارة SQL يتم تشغيلها باستخدام مستودعات SQL. يتضمن الجدول سجلات على مستوى الحساب من جميع مساحات العمل في نفس المنطقة التي يمكنك الوصول إلى الجدول منها.
بشكل افتراضي، يمكن للمسؤولين فقط الوصول إلى جدول النظام. إذا كنت ترغب في مشاركة بيانات الجدول مع مستخدم أو مجموعة، توصي Databricks بإنشاء طريقة عرض ديناميكية لكل مستخدم أو مجموعة. راجع إنشاء طريقة عرض ديناميكية.
مخطط جدول نظام محفوظات الاستعلام
يستخدم جدول محفوظات الاستعلام المخطط التالي:
| اسم العمود | نوع البيانات | الوصف | مثال |
|---|---|---|---|
account_id |
سلسلة | معرف الحساب. | 11e22ba4-87b9-4cc2-9770-d10b894b7118 |
workspace_id |
سلسلة | معرف مساحة العمل حيث تم تشغيل الاستعلام. | 1234567890123456 |
statement_id |
سلسلة | المعرف الذي يحدد تنفيذ العبارة بشكل فريد. يمكنك استخدام هذا المعرف للعثور على تنفيذ العبارة في واجهة مستخدم محفوظات الاستعلام. | 7a99b43c-b46c-432b-b0a7-814217701909 |
session_id |
سلسلة | معرف جلسة Spark. | 01234567-cr06-a2mp-t0nd-a14ecfb5a9c2 |
execution_status |
سلسلة | حالة إنهاء العبارة. القيم المحتملة هي: - FINISHED: تم التنفيذ بنجاح- FAILED: فشل التنفيذ مع سبب الفشل الموضح في رسالة الخطأ المصاحبة- CANCELED: تم إلغاء التنفيذ |
FINISHED |
compute |
بنية | بنية تمثل نوع مورد الحساب المستخدم لتشغيل العبارة ومعرف المورد حيثما ينطبق ذلك. type ستكون القيمة إما WAREHOUSE أو SERVERLESS_COMPUTE. |
{type: WAREHOUSE,cluster_id: NULL,warehouse_id: ec58ee3772e8d305} |
executed_by_user_id |
سلسلة | معرف المستخدم الذي قام بتشغيل العبارة . | 2967555311742259 |
executed_by |
سلسلة | عنوان البريد الإلكتروني أو اسم المستخدم للمستخدم الذي قام بتشغيل العبارة. | example@databricks.com |
statement_text |
سلسلة | نص عبارة SQL. إذا قمت بتكوين مفاتيح يديرها العميل، statement_text تكون فارغة. |
SELECT 1 |
statement_type |
سلسلة | نوع العبارة. على سبيل المثال: ALTERو COPYوINSERT. |
SELECT |
error_message |
سلسلة | رسالة تصف حالة الخطأ. إذا قمت بتكوين مفاتيح يديرها العميل، error_message تكون فارغة. |
[INSUFFICIENT_PERMISSIONS] Insufficient privileges: User does not have permission SELECT on table 'default.nyctaxi_trips'. |
client_application |
سلسلة | تطبيق العميل الذي قام بتشغيل العبارة . على سبيل المثال: Databricks SQL Editor وTableau وPower BI. يتم اشتقاق هذا الحقل من المعلومات التي توفرها تطبيقات العميل. بينما من المتوقع أن تظل القيم ثابتة بمرور الوقت، لا يمكن ضمان ذلك. | Databricks SQL Editor |
client_driver |
سلسلة | الموصل المستخدم للاتصال ب Azure Databricks لتشغيل العبارة . على سبيل المثال: Databricks SQL Driver for Go, Databricks ODBC Driver, Databricks JDBC Driver. | Databricks JDBC Driver |
total_duration_ms |
عدد صحيح كبير | إجمالي وقت تنفيذ العبارة بالمللي ثانية (باستثناء وقت إحضار النتيجة). | 1 |
waiting_for_compute_duration_ms |
عدد صحيح كبير | الوقت المستغرق في انتظار توفير موارد الحوسبة بالمللي ثانية. | 1 |
waiting_at_capacity_duration_ms |
عدد صحيح كبير | الوقت المستغرق في الانتظار في قائمة الانتظار للحصول على سعة الحوسبة المتوفرة بالمللي ثانية. | 1 |
execution_duration_ms |
عدد صحيح كبير | الوقت المستغرق في تنفيذ العبارة بالمللي ثانية. | 1 |
compilation_duration_ms |
عدد صحيح كبير | الوقت المستغرق في تحميل بيانات التعريف وتحسين العبارة بالمللي ثانية. | 1 |
total_task_duration_ms |
عدد صحيح كبير | مجموع جميع مدد المهام بالمللي ثانية. يمثل هذا الوقت الوقت المدمج الذي استغرقه تشغيل الاستعلام عبر جميع الذاكرات الأساسية لجميع العقد. يمكن أن تكون أطول بكثير من مدة ساعة الحائط إذا تم تنفيذ مهام متعددة بالتوازي. يمكن أن تكون أقصر من مدة ساعة الحائط إذا كانت المهام تنتظر العقد المتوفرة. | 1 |
result_fetch_duration_ms |
عدد صحيح كبير | الوقت المستغرق، بالمللي ثانية، في إحضار نتائج العبارة بعد انتهاء التنفيذ. | 1 |
start_time |
الطابع الزمني | الوقت الذي تلقت فيه Databricks الطلب. يتم تسجيل معلومات المنطقة الزمنية في نهاية القيمة مع +00:00 تمثيل UTC. |
2022-12-05T00:00:00.000+0000 |
end_time |
الطابع الزمني | وقت انتهاء تنفيذ العبارة، باستثناء وقت إحضار النتيجة. يتم تسجيل معلومات المنطقة الزمنية في نهاية القيمة مع +00:00 تمثيل UTC. |
2022-12-05T00:00:00.000+00:00 |
update_time |
الطابع الزمني | الوقت الذي تلقت فيه العبارة آخر تحديث تقدم. يتم تسجيل معلومات المنطقة الزمنية في نهاية القيمة مع +00:00 تمثيل UTC. |
2022-12-05T00:00:00.000+00:00 |
read_partitions |
عدد صحيح كبير | عدد الأقسام المقروءة بعد التقليم. | 1 |
pruned_files |
عدد صحيح كبير | عدد الملفات التي تم تقليمها. | 1 |
read_files |
عدد صحيح كبير | عدد الملفات المقروءة بعد التقليم. | 1 |
read_rows |
عدد صحيح كبير | إجمالي عدد الصفوف المقروءة بواسطة العبارة . | 1 |
produced_rows |
عدد صحيح كبير | إجمالي عدد الصفوف التي تم إرجاعها بواسطة العبارة . | 1 |
read_bytes |
عدد صحيح كبير | الحجم الإجمالي للبيانات المقروءة بواسطة العبارة بالبايت. | 1 |
read_io_cache_percent |
العدد الصحيح | النسبة المئوية لوحدات البايت للبيانات الثابتة المقروءة من ذاكرة التخزين المؤقت IO. | 50 |
from_result_cache |
boolean | TRUE يشير إلى أنه تم جلب نتيجة العبارة من ذاكرة التخزين المؤقت. |
TRUE |
spilled_local_bytes |
عدد صحيح كبير | حجم البيانات، بالبايت، المكتوب مؤقتا على القرص أثناء تنفيذ العبارة. | 1 |
written_bytes |
عدد صحيح كبير | حجم وحدات البايت للبيانات الثابتة المكتوبة إلى تخزين الكائنات السحابية. | 1 |
shuffle_read_bytes |
عدد صحيح كبير | إجمالي كمية البيانات بالبايت المرسلة عبر الشبكة. | 1 |
query_source |
بنية | بنية تحتوي على أزواج قيم المفاتيح التي تمثل كيانا واحدا أو أكثر من كيانات Databricks التي شاركت في تنفيذ هذه العبارة، مثل الوظائف أو دفاتر الملاحظات أو لوحات المعلومات. يسجل هذا الحقل كيانات Databricks فقط. | {job_info: { job_id: 64361233243479 job_run_id: 887406461287882 job_task_key: “job_task_1” job_task_run_id: 110378410199121} |
executed_as |
سلسلة | اسم المستخدم أو كيان الخدمة الذي تم استخدام امتيازه لتشغيل العبارة . | example@databricks.com |
executed_as_user_id |
سلسلة | معرف المستخدم أو كيان الخدمة الذي تم استخدام امتيازه لتشغيل العبارة . | 2967555311742259 |
عرض ملف تعريف الاستعلام لسجل
للانتقال إلى ملف تعريف استعلام استنادا إلى سجل في جدول محفوظات الاستعلام، قم بما يلي:
- حدد سجل الاهتمام، ثم انسخ سجل
statement_id. - قم بالرجوع إلى السجل
workspace_idللتأكد من تسجيل الدخول إلى نفس مساحة العمل مثل السجل. - انقر فوق
محفوظات الاستعلام في الشريط الجانبي لمساحة العمل. - في الحقل معرف العبارة
statement_id، الصق في السجل. - انقر فوق اسم استعلام. تظهر نظرة عامة على مقاييس الاستعلام.
- انقر فوق عرض ملف تعريف الاستعلام.