> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> جدول نظام يتضمن معلومات عن الخيوط التي تنفّذ الاستعلامات، مثل اسم الخيط، ووقت بدء الخيط، ومدة معالجة الاستعلام.

# system.query_thread_log

<Info>
  **الاستعلام في ClickHouse Cloud**

  تُخزَّن بيانات جدول النظام هذا محليًا على كل عقدة في ClickHouse Cloud. لذلك، يتطلب الحصول على رؤية كاملة لجميع البيانات استخدام الدالة `clusterAllReplicas`. راجع [هنا](/ar/reference/system-tables/overview#system-tables-in-clickhouse-cloud) لمزيد من التفاصيل.
</Info>

## الوصف

يحتوي هذا الجدول على معلومات عن خيوط تنفّذ الاستعلامات، مثل اسم الخيط، ووقت بدء الخيط، ومدة معالجة الاستعلام.

لبدء التسجيل:

1. اضبط المَعلمات في قسم [query\_thread\_log](/ar/reference/settings/server-settings/settings/query#query_thread_log).
2. عيّن [log\_query\_threads](/ar/reference/settings/session-settings/log-query#log_query_threads) إلى 1.

تُحدَّد فترة تفريغ البيانات في المَعلمة `flush_interval_milliseconds` ضمن قسم إعدادات الخادم [query\_thread\_log](/ar/reference/settings/server-settings/settings/query#query_thread_log). ولإجبار النظام على التفريغ، استخدم الاستعلام [SYSTEM FLUSH LOGS](/ar/reference/statements/system#flush-logs).

لا يحذف ClickHouse البيانات من الجدول تلقائيًا. راجع [المقدمة](/ar/reference/system-tables/overview#system-tables-introduction) لمزيد من التفاصيل.

يمكنك استخدام الإعداد [log\_queries\_probability](/ar/reference/settings/session-settings/log-queries#log_queries_probability) لتقليل عدد الاستعلامات المسجَّلة في جدول `query_thread_log`.

من الآمن تنفيذ TRUNCATE على هذا الجدول أو حذفه في أي وقت.

## الأعمدة

* `hostname` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم مضيف الخادم الذي ينفّذ الاستعلام.
* `clickhouse_version` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — إصدار خادم ClickHouse الذي أنتج الصف.
* `system_processor` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — معمارية المعالج لخادم ClickHouse الذي أنتج الصف.
* `event_date` ([Date](/ar/reference/data-types/date)) — التاريخ الذي أنهى فيه خيط التنفيذ تنفيذ الاستعلام.
* `event_time` ([DateTime](/ar/reference/data-types/datetime)) — التاريخ والوقت اللذان أنهى فيهما خيط التنفيذ تنفيذ الاستعلام.
* `event_time_microseconds` ([DateTime64(6)](/ar/reference/data-types/datetime64)) — التاريخ والوقت اللذان أنهى فيهما خيط التنفيذ تنفيذ الاستعلام بدقة الميكروثانية.
* `query_start_time` ([DateTime](/ar/reference/data-types/datetime)) — وقت بدء تنفيذ الاستعلام.
* `query_start_time_microseconds` ([DateTime64(6)](/ar/reference/data-types/datetime64)) — وقت بدء تنفيذ الاستعلام بدقة الميكروثانية.
* `query_duration_ms` ([UInt64](/ar/reference/data-types/int-uint)) — مدة تنفيذ الاستعلام.
* `read_rows` ([UInt64](/ar/reference/data-types/int-uint)) — عدد الصفوف المقروءة.
* `read_bytes` ([UInt64](/ar/reference/data-types/int-uint)) — عدد البايتات المقروءة.
* `written_rows` ([UInt64](/ar/reference/data-types/int-uint)) — في استعلامات INSERT، عدد الصفوف المكتوبة. وفي الاستعلامات الأخرى، تكون قيمة العمود 0.
* `written_bytes` ([UInt64](/ar/reference/data-types/int-uint)) — في استعلامات INSERT، عدد البايتات المكتوبة. وفي الاستعلامات الأخرى، تكون قيمة العمود 0.
* `memory_usage` ([Int64](/ar/reference/data-types/int-uint)) — الفرق بين مقدار الذاكرة المخصّصة والمحرّرة في سياق خيط التنفيذ هذا.
* `peak_memory_usage` ([Int64](/ar/reference/data-types/int-uint)) — الحد الأقصى للفرق بين مقدار الذاكرة المخصّصة والمحرّرة في سياق خيط التنفيذ هذا.
* `thread_name` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم خيط التنفيذ.
* `thread_id` ([UInt64](/ar/reference/data-types/int-uint)) — المعرّف الداخلي لخيط التنفيذ.
* `master_thread_id` ([UInt64](/ar/reference/data-types/int-uint)) — المعرّف الأولي على مستوى نظام التشغيل لخيط التنفيذ الأولي.
* `current_database` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم قاعدة البيانات الحالية.
* `query` ([String](/ar/reference/data-types/string)) — سلسلة الاستعلام.
* `normalized_query_hash` ([UInt64](/ar/reference/data-types/int-uint)) — قيمة hash للاستعلام المُطبَّع، بعد إزالة الثوابت وما إلى ذلك.
* `is_initial_query` ([UInt8](/ar/reference/data-types/int-uint)) — ما إذا كان الاستعلام أوليًا. القيم الممكنة: 1 — استعلام أولي (على المستوى الأعلى)، 0 — استعلام فرعي بدأه استعلام آخر، بما في ذلك استعلامات التنفيذ الموزّع والاستعلامات الفرعية الداخلية.
* `connection_address` ([IPv6](/ar/reference/data-types/ipv6)) — عنوان IP للعميل الذي أُنشئ منه الاتصال. عند الاتصال عبر وكيل، سيكون هذا عنوان الوكيل.
* `connection_port` ([UInt16](/ar/reference/data-types/int-uint)) — منفذ العميل الذي أُنشئ منه الاتصال. عند الاتصال عبر وكيل، سيكون هذا منفذ الوكيل.
* `user` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم المستخدم الذي بدأ الاستعلام الحالي.
* `query_id` ([String](/ar/reference/data-types/string)) — معرّف الاستعلام.
* `address` ([IPv6](/ar/reference/data-types/ipv6)) — عنوان IP الذي استُخدم لإجراء الاستعلام. عند الاتصال عبر وكيل وتعيين `auth_use_forwarded_address`، سيكون هذا عنوان العميل بدلًا من عنوان الوكيل.
* `port` ([UInt16](/ar/reference/data-types/int-uint)) — منفذ العميل المستخدم لإجراء الاستعلام. عند الاتصال عبر وكيل وتعيين `auth_use_forwarded_address`، سيكون هذا منفذ العميل بدلًا من منفذ الوكيل.
* `initial_user` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم المستخدم الذي شغّل الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
* `initial_query_id` ([String](/ar/reference/data-types/string)) — معرّف الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
* `initial_address` ([IPv6](/ar/reference/data-types/ipv6)) — عنوان IP الذي انطلق منه الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
* `initial_port` ([UInt16](/ar/reference/data-types/int-uint)) — منفذ العميل الذي انطلق منه الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
* `initial_query_start_time` ([DateTime](/ar/reference/data-types/datetime)) — وقت بدء الاستعلام الأولي ضمن سلسلة الاستعلام نفسها.
* `initial_query_start_time_microseconds` ([DateTime64(6)](/ar/reference/data-types/datetime64)) — وقت بدء الاستعلام الأولي ضمن سلسلة الاستعلام نفسها، بدقة الميكروثانية.
* `authenticated_user` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم المستخدم الذي تمت المصادقة عليه في الجلسة.
* `interface` ([Enum8('Unknown' = 0, 'TCP' = 1, 'HTTP' = 2, 'gRPC' = 3, 'MySQL' = 4, 'PostgreSQL' = 5, 'Local' = 6, 'TCP\_Interserver' = 7, 'Prometheus' = 8, 'Background' = 9, 'ArrowFlight' = 10)](/ar/reference/data-types/enum)) — الواجهة التي بدأ منها الاستعلام، وفقًا لما يبلّغ عنه العميل. تكون القيمة `Unknown` إذا لم تكن الواجهة المُبلَّغ عنها من الواجهات التي يتعرّف عليها هذا الخادم.
* `is_secure` ([UInt8](/ar/reference/data-types/int-uint)) — علامة توضّح ما إذا كان الاتصال آمنًا.
* `os_user` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم مستخدم نظام التشغيل الذي يشغّل clickhouse-client.
* `client_hostname` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم مضيف جهاز العميل الذي يعمل عليه clickhouse-client أو أي عميل TCP آخر.
* `client_name` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم clickhouse-client أو أي عميل TCP آخر.
* `client_agent` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — وكيل البرمجة بالذكاء الاصطناعي الذي استدعى العميل (مثل `claude-code` و`cursor`) ويُكتشف من متغيرات البيئة. تكون القيمة فارغة إذا لم يُكتشف أي وكيل.
* `client_revision` ([UInt32](/ar/reference/data-types/int-uint)) — رقم المراجعة لـ clickhouse-client أو أي عميل TCP آخر.
* `client_version_major` ([UInt32](/ar/reference/data-types/int-uint)) — الإصدار الرئيسي لـ clickhouse-client أو أي عميل TCP آخر.
* `client_version_minor` ([UInt32](/ar/reference/data-types/int-uint)) — الإصدار الثانوي لـ clickhouse-client أو أي عميل TCP آخر.
* `client_version_patch` ([UInt32](/ar/reference/data-types/int-uint)) — مكوّن التصحيح من إصدار clickhouse-client أو أي عميل TCP آخر.
* `script_query_number` ([UInt32](/ar/reference/data-types/int-uint)) — رقم استعلام تسلسلي ضمن برنامج نصي متعدد الاستعلامات.
* `script_line_number` ([UInt32](/ar/reference/data-types/int-uint)) — رقم السطر في برنامج نصي متعدد الاستعلامات الذي يبدأ عنده الاستعلام الحالي.
* `http_method` ([Enum8('UNKNOWN' = 0, 'GET' = 1, 'POST' = 2, 'OPTIONS' = 3, 'PUT' = 4, 'DELETE' = 5, 'HEAD' = 6)](/ar/reference/data-types/enum)) — طريقة HTTP التي بدأ بها الاستعلام. تكون `UNKNOWN` إذا لم يصل الاستعلام عبر HTTP، أو إذا كانت الطريقة المُبلَّغ عنها غير معروفة لهذا الخادم.
* `http_user_agent` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — ترويسة UserAgent المُمرَّرة في طلب HTTP.
* `http_referer` ([String](/ar/reference/data-types/string)) — ترويسة HTTP ‏`Referer` المُمرَّرة في طلب HTTP (وتحتوي على عنوان كامل أو جزئي للصفحة التي تُجري الاستعلام).
* `forwarded_for` ([String](/ar/reference/data-types/string)) — ترويسة HTTP ‏`X-Forwarded-For` المُمرَّرة في طلب HTTP.
* `quota_key` ([String](/ar/reference/data-types/string)) — 'مفتاح الحصة' المحدد في إعداد quotas.
* `distributed_depth` ([UInt64](/ar/reference/data-types/int-uint)) — عدد المرات التي جرى فيها تمرير الاستعلام بين الخوادم.
* `revision` ([UInt32](/ar/reference/data-types/int-uint)) — مراجعة ClickHouse.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/ar/reference/data-types/map)) — أحداث ProfileEvents التي تقيس مقاييس مختلفة لخيط التنفيذ هذا. يمكن العثور على وصفها في الجدول system.events.

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

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

## مثال

```sql theme={null}
 SELECT * FROM system.query_thread_log LIMIT 1 \G
```

```text theme={null}
Row 1:
──────
hostname:                      clickhouse.eu-central1.internal
event_date:                    2020-09-11
event_time:                    2020-09-11 10:08:17
event_time_microseconds:       2020-09-11 10:08:17.134042
query_start_time:              2020-09-11 10:08:17
query_start_time_microseconds: 2020-09-11 10:08:17.063150
query_duration_ms:             70
read_rows:                     0
read_bytes:                    0
written_rows:                  1
written_bytes:                 12
memory_usage:                  4300844
peak_memory_usage:             4300844
thread_name:                   TCPHandler
thread_id:                     638133
master_thread_id:              638133
query:                         INSERT INTO test1 VALUES
is_initial_query:              1
user:                          default
query_id:                      50a320fd-85a8-49b8-8761-98a86bcbacef
address:                       ::ffff:127.0.0.1
port:                          33452
initial_user:                  default
initial_query_id:              50a320fd-85a8-49b8-8761-98a86bcbacef
initial_address:               ::ffff:127.0.0.1
initial_port:                  33452
interface:                     TCP
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:                   UNKNOWN
http_user_agent:
quota_key:
revision:                      54440
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
```

## انظر أيضًا

* [system.query\_log](/ar/reference/system-tables/query_log) — وصف لجدول النظام `query_log` الذي يحتوي على معلومات عامة عن تنفيذ الاستعلامات.
* [system.query\_views\_log](/ar/reference/system-tables/query_views_log) — يحتوي هذا الجدول على معلومات عن كل عرض يُنفَّذ أثناء الاستعلام.