> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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>

<div id="description">
  ## الوصف
</div>

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

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

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

تُحدَّد فترة تفريغ البيانات في المَعلمة `flush_interval_milliseconds` ضمن قسم إعدادات الخادم [query\_thread\_log](/ar/reference/settings/server-settings/settings#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_probability)) لتقليل عدد الاستعلامات المسجَّلة في جدول `query_thread_log`.

<div id="columns">
  ## الأعمدة
</div>

* `hostname` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم مضيف الخادم الذي ينفّذ الاستعلام.
* `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` ([UInt8](/ar/reference/data-types/int-uint)) — الواجهة التي بدأ منها الاستعلام. القيم الممكنة: 1 — TCP، 2 — HTTP.
* `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` ([UInt8](/ar/reference/data-types/int-uint)) — طريقة HTTP التي بدأ بها الاستعلام. القيم الممكنة: 0 — انطلق الاستعلام من واجهة TCP، 1 — استُخدمت طريقة GET، 2 — استُخدمت طريقة POST.
* `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)`.

<div id="example">
  ## مثال
</div>

```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:                     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:
revision:                      54440
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
```

<div id="see-also">
  ## انظر أيضًا
</div>

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