> ## 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.

> جدول نظامي يحتوي على إحصاءات مُعايَنة لانتقائية `filter` و`index`، جُمعت من مسارات قراءة `MergeTree` أثناء تنفيذ الاستعلام.

# system.predicate_statistics_log

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

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

## الوصف

يحتوي على إحصاءات الانتقائية المُعايَنة التي جُمعت أثناء القراءة من جداول `MergeTree`. ولا تتم تعبئة هذا الجدول إلا عندما تكون قيمة [`predicate_statistics_sample_rate`](/ar/reference/settings/session-settings/other#predicate_statistics_sample_rate) أكبر من `0`.

**التوافر**

لا يُنشأ `system.predicate_statistics_log` إلا عندما تحتوي تهيئة الخادم على قسم `predicate_statistics_log`. وبعد إنشاء السجل، اضبط `predicate_statistics_sample_rate` على قيمة أكبر من `0` لجمع الصفوف. وبدون قسم السجل، تفشل الاستعلامات على هذا الجدول بالخطأ `UNKNOWN_TABLE`.

```xml theme={null}
<clickhouse>
    <predicate_statistics_log>
        <database>system</database>
        <table>predicate_statistics_log</table>
        <partition_by>toYYYYMM(event_date)</partition_by>
        <flush_interval_milliseconds>7500</flush_interval_milliseconds>
    </predicate_statistics_log>
</clickhouse>
```

استخدم هذا الجدول لفحص مدى انتقائية المسندات التي يحدّدها المستخدم في أعباء العمل الفعلية، ومعرفة عدد الحبيبات المتبقية بعد التصفية بالمفتاح الأساسي أو بفهرس التخطي. وهذه البيانات مخصّصة لتكون مدخلات لتوصيات الفهارس والإسقاطات المستندة إلى أعباء العمل.

## أنماط الصفوف

يمكن أن ينتج الاستعلام الواحد نوعين من الصفوف في `system.predicate_statistics_log`:

* **صفوف التصفية**، وتُصدَر لكل خطوة `prewhere`/تصفية في `MergeTreeSelectProcessor`. وتملأ الأعمدة `predicate_expression` و`input_rows` و`passed_rows` و`filter_selectivity`، بالإضافة إلى أعمدة المسند الكامل `total_input_rows` و`total_passed_rows` و`total_selectivity`. أما الأعمدة المرتبطة بالفهارس فتكون فارغة.
* **صفوف الفهارس**، وتُصدَر لكل خطوة قراءة في `ReadFromMergeTree`. وتملأ المصفوفات `index_names` و`index_types` و`total_granules` و`granules_after` و`index_selectivities`، بمدخل واحد لكل مرحلة فهرسة (المفتاح الأساسي، والتقسيم، وفهارس التخطي). أما الأعمدة المرتبطة بالمسند فتكون فارغة.

تشترك صفوف التصفية وصفوف الفهارس الخاصة بالاستعلام نفسه في القيمتين `query_id` و`table`، لذلك يمكن ضمّها عند الحاجة إلى كليهما.

## أخذ العينات والعبء الإضافي

يُتحكَّم في أخذ العينات بواسطة [`predicate_statistics_sample_rate`](/ar/reference/settings/session-settings/other#predicate_statistics_sample_rate):

* `0` يعطّل الجمع.
* `1` يأخذ عيّنة من كل query.
* `N > 1` يأخذ عيّنة من حوالي `1 / N` من queries، استنادًا إلى قيمة `hash` لـ `query_id`.

تنتج القيم الأقل مزيدًا من البيانات، لكنها تضيف حملًا على CPU في مسار القراءة ومزيدًا من عمليات الكتابة إلى سجل النظام. بعد تمكين هذا الإعداد، استخدم [`SYSTEM FLUSH LOGS`](/ar/reference/statements/system#flush-logs) إذا كنت بحاجة إلى ظهور الصفوف فورًا.

من الآمن تنفيذ 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)) — الطابع الزمني عند كتابة مُدخل السجل هذا.
* `database` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم قاعدة بيانات الجدول الهدف.
* `table` ([LowCardinality(String)](/ar/reference/data-types/lowcardinality)) — اسم الجدول الهدف.
* `query_id` ([String](/ar/reference/data-types/string)) — معرّف الاستعلام للرجوع إلى query\_log.
* `predicate_expression` ([String](/ar/reference/data-types/string)) — تعبير المسند الكامل الذي تتعامل معه خطوة `prewhere`/تصفية هذه (تفريغ ActionsDAG).
* `input_rows` ([UInt64](/ar/reference/data-types/int-uint)) — الصفوف التي تدخل إلى خطوة `prewhere`/تصفية هذه.
* `passed_rows` ([UInt64](/ar/reference/data-types/int-uint)) — الصفوف التي اجتازت خطوة `prewhere`/تصفية هذه.
* `filter_selectivity` ([Float64](/ar/reference/data-types/float)) — انتقائية هذه الخطوة: passed\_rows / input\_rows.
* `total_input_rows` ([UInt64](/ar/reference/data-types/int-uint)) — الصفوف التي تدخل إلى أول خطوة prewhere (إجمالي الصفوف المقروءة من الحبيبات).
* `total_passed_rows` ([UInt64](/ar/reference/data-types/int-uint)) — الصفوف التي اجتازت جميع خطوات prewhere (الصفوف التي تم تمريرها إلى الاستعلام).
* `total_selectivity` ([Float64](/ar/reference/data-types/float)) — انتقائية المسند بالكامل: total\_passed\_rows / total\_input\_rows.
* `index_names` ([Array(LowCardinality(String))](/ar/reference/data-types/array)) — أسماء الفهارس المطبّقة، مثل \['PrimaryKey', 'idx\_bf\_status'] (في صفوف الفهارس فقط).
* `index_types` ([Array(LowCardinality(String))](/ar/reference/data-types/array)) — أنواع الفهارس المطبّقة: PrimaryKey وSkip وMinMax وPartition (في صفوف الفهارس فقط).
* `total_granules` ([Array(UInt64)](/ar/reference/data-types/array)) — الحبيبات الداخلة إلى كل مرحلة فهرسة (في صفوف الفهارس فقط).
* `granules_after` ([Array(UInt64)](/ar/reference/data-types/array)) — الحبيبات المتبقية بعد كل مرحلة فهرسة (في صفوف الفهارس فقط).
* `index_selectivities` ([Array(Float64)](/ar/reference/data-types/array)) — الانتقائية لكل فهرس: granules\_after / total\_granules (في صفوف الفهارس فقط).

## مثال

```sql theme={null}
SET predicate_statistics_sample_rate = 1;

SELECT *
FROM hits
WHERE URL LIKE '%/product/%' AND EventDate >= today() - 7
FORMAT Null;

SYSTEM FLUSH LOGS predicate_statistics_log;

SELECT
    query_id,
    predicate_expression,
    round(filter_selectivity, 3) AS step_selectivity,
    round(total_selectivity, 3) AS query_selectivity,
    index_names,
    index_selectivities
FROM system.predicate_statistics_log
WHERE table = 'hits'
ORDER BY event_time DESC
LIMIT 10;
```

## انظر أيضًا

* [`predicate_statistics_sample_rate`](/ar/reference/settings/session-settings/other#predicate_statistics_sample_rate)
* [system.query\_log](/ar/reference/system-tables/query_log)