system.processes

جدول نظامي يُستخدم لتنفيذ الاستعلام SHOW PROCESSLIST.

الاستعلام في ClickHouse Cloud

تُخزَّن بيانات جدول النظام هذا محليًا على كل عقدة في ClickHouse Cloud. لذلك، يتطلب الحصول على رؤية كاملة لجميع البيانات استخدام الدالة clusterAllReplicas. راجع هنا لمزيد من التفاصيل.

​

الوصف

يُستخدم جدول نظامي هذا لتنفيذ الاستعلام SHOW PROCESSLIST.

​

الأعمدة

• is_initial_query (UInt8) — يحدد ما إذا كان الاستعلام أوليًا. القيم الممكنة: 1 — استعلام أولي (من المستوى الأعلى)، 0 — استعلام فرعي بدأه استعلام آخر، بما في ذلك استعلامات التنفيذ الموزّع والاستعلامات الفرعية الداخلية.
• user (String) — المستخدم الذي أجرى الاستعلام. يُرجى ملاحظة أنه في المعالجة الموزعة، تُرسل الاستعلامات إلى الخوادم البعيدة باسم المستخدم default. يحتوي هذا الحقل على اسم المستخدم الخاص باستعلام معيّن، وليس باسم مستخدم الاستعلام الذي بدأه هذا الاستعلام.
• query_id (String) — معرّف الاستعلام، إن كان محددًا.
• address (IPv6) — عنوان IP الذي أُجري الاستعلام منه. وينطبق الأمر نفسه على المعالجة الموزعة. لتتبّع المصدر الأصلي للاستعلام الموزّع، راجع system.processes على الخادم الذي طلب الاستعلام.
• port (UInt16) — منفذ العميل الذي أُجري الاستعلام منه.
• initial_user (String) — اسم المستخدم الذي شغّل الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
• initial_query_id (String) — معرّف الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
• initial_address (IPv6) — عنوان IP الذي أُطلق منه الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
• initial_port (UInt16) — منفذ العميل الذي أُطلق منه الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
• interface (UInt8) — الواجهة المُستخدمة لإرسال الاستعلام. TCP = 1، HTTP = 2، GRPC = 3، MYSQL = 4، POSTGRESQL = 5، LOCAL = 6، TCP_INTERSERVER = 7.
• os_user (String) — اسم مستخدم نظام التشغيل الذي يشغّل clickhouse-client.
• client_hostname (String) — اسم مضيف جهاز العميل الذي يعمل عليه clickhouse-client أو عميل TCP آخر.
• client_name (String) — اسم clickhouse-client أو عميل TCP آخر.
• client_agent (LowCardinality(String)) — وكيل الشيفرة المعتمد على الذكاء الاصطناعي الذي استدعى العميل (مثل claude-code وcursor) ويُكتشف من متغيرات البيئة. تكون القيمة فارغة إذا لم يُكتشف أي وكيل.
• client_revision (UInt64) — مراجعة clickhouse-client أو عميل TCP آخر.
• client_version_major (UInt64) — الإصدار الرئيسي لـ clickhouse-client أو عميل TCP آخر.
• client_version_minor (UInt64) — الإصدار الثانوي لـ clickhouse-client أو عميل TCP آخر.
• client_version_patch (UInt64) — مكوّن التصحيح في إصدار clickhouse-client أو عميل TCP آخر.
• http_method (UInt8) — أسلوب HTTP الذي بدأ الاستعلام. القيم الممكنة: 0 - أُطلق الاستعلام من واجهة TCP، 1 - استُخدم أسلوب GET، 2 - استُخدم أسلوب POST، 4 - استُخدم أسلوب PUT، 5 - استُخدم أسلوب DELETE، 6 - استُخدم أسلوب HEAD.
• http_user_agent (String) — ترويسة HTTP ‏UserAgent المُمرّرة مع استعلام HTTP.
• http_referer (String) — ترويسة HTTP ‏Referer المُمرّرة مع استعلام HTTP (تحتوي على عنوان كامل أو جزئي للصفحة التي تُجري الاستعلام).
• forwarded_for (String) — ترويسة HTTP ‏X-Forwarded-For المُمرّرة مع استعلام HTTP.
• quota_key (String) — مفتاح الحصة المحدد في إعداد الحصص (انظر keyed).
• distributed_depth (UInt64) — عدد المرات التي أُعيد فيها إرسال الاستعلام داخليًا بين عُقد الخوادم.
• elapsed (Float64) — الوقت بالثواني منذ بدء تنفيذ الطلب.
• is_cancelled (UInt8) — ما إذا كان الاستعلام قد أُلغي.
• is_all_data_sent (UInt8) — ما إذا كانت جميع البيانات قد أُرسلت إلى العميل (أي إن الاستعلام كان قد اكتمل على الخادم).
• read_rows (UInt64) — عدد الصفوف المقروءة من الجدول. في المعالجة الموزعة، يمثل هذا العدد الإجمالي عبر جميع الخوادم البعيدة على الخادم الطالب.
• read_bytes (UInt64) — عدد البايتات غير المضغوطة المقروءة من الجدول. في المعالجة الموزعة، يمثل هذا العدد الإجمالي عبر جميع الخوادم البعيدة على الخادم الطالب.
• total_rows_approx (UInt64) — تقدير العدد الإجمالي للصفوف المطلوب قراءتها. في المعالجة الموزعة، يمثل هذا العدد الإجمالي عبر جميع الخوادم البعيدة على الخادم الطالب. ويمكن تحديثه أثناء معالجة الطلب عند اكتشاف مصادر جديدة لمعالجتها.
• written_rows (UInt64) — عدد الصفوف المكتوبة إلى التخزين.
• written_bytes (UInt64) — عدد البايتات المكتوبة إلى التخزين.
• memory_usage (Int64) — مقدار ذاكرة RAM التي يستخدمها الاستعلام. وقد لا يشمل بعض أنواع الذاكرة المخصصة.
• peak_memory_usage (Int64) — الذروة الحالية لاستخدام الذاكرة.
• query (String) — نص الاستعلام. بالنسبة إلى INSERT، لا يشمل البيانات المراد إدراجها.
• normalized_query_hash (UInt64) — قيمة hash رقمية متطابقة، على سبيل المثال، للاستعلامات التي لا تختلف إلا في قيم القيم الحرفية.
• query_kind (String) — نوع الاستعلام: SELECT أو INSERT، إلخ.
• thread_ids (Array(UInt64)) — قائمة معرّفات جميع سلاسل التنفيذ التي شاركت في هذا الاستعلام.
• peak_threads_usage (UInt64) — الحد الأقصى لعدد سلاسل التنفيذ المتزامنة التي تنفذ الاستعلام.
• ProfileEvents (Map(LowCardinality(String), UInt64)) — أحداث ProfileEvents المحسوبة لهذا الاستعلام.
• Settings (Map(LowCardinality(String), LowCardinality(String))) — قائمة الإعدادات المعدّلة على مستوى المستخدم.
• current_database (String) — اسم قاعدة البيانات الحالية.
• is_internal (UInt8) — يشير إلى ما إذا كان استعلامًا مساعدًا يُنفذ داخليًا.

الأسماء المستعارة:

• ProfileEvents.Names — اسم مستعار لـ mapKeys(ProfileEvents).
• ProfileEvents.Values — اسم مستعار لـ mapValues(ProfileEvents).
• Settings.Names — اسم مستعار لـ mapKeys(Settings).
• Settings.Values — اسم مستعار لـ mapValues(Settings).

SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;

Row 1:
──────
is_initial_query:     1
user:                 default
query_id:             35a360fa-3743-441d-8e1f-228c938268da
address:              ::ffff:172.23.0.1
port:                 47588
initial_user:         default
initial_query_id:     35a360fa-3743-441d-8e1f-228c938268da
initial_address:      ::ffff:172.23.0.1
initial_port:         47588
interface:            1
os_user:              bharatnc
client_hostname:      tower
client_name:          ClickHouse
client_revision:      54437
client_version_major: 20
client_version_minor: 7
client_version_patch: 2
http_method:          0
http_user_agent:
quota_key:
elapsed:              0.000582537
is_cancelled:         0
is_all_data_sent:     0
read_rows:            0
read_bytes:           0
total_rows_approx:    0
written_rows:         0
written_bytes:        0
memory_usage:         0
peak_memory_usage:    0
query:                SELECT * from system.processes LIMIT 10 FORMAT Vertical;
thread_ids:           [67]
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
Settings:             {'background_pool_size':'32','load_balancing':'random','allow_suspicious_low_cardinality_types':'1','distributed_aggregation_memory_efficient':'1','skip_unavailable_shards':'1','log_queries':'1','max_bytes_before_external_group_by':'20000000000','max_bytes_before_external_sort':'20000000000','allow_introspection_functions':'1'}

1 rows in set. Elapsed: 0.002 sec.