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

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

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

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

يتضمن معلومات عن [القواميس](/ar/reference/statements/create/dictionary).

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

* `database` ([String](/ar/reference/data-types/index)) — اسم قاعدة البيانات التي تحتوي على القاموس الذي أُنشئ بواسطة DDL query. وتكون سلسلة فارغة للقواميس الأخرى.
* `name` ([String](/ar/reference/data-types/index)) — اسم القاموس.
* `uuid` ([UUID](/ar/reference/data-types/index)) — UUID القاموس.
* `status` ([Enum8('NOT\_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED\_AND\_RELOADING' = 4, 'LOADED\_AND\_RELOADING' = 5, 'NOT\_EXIST' = 6)](/ar/reference/data-types/index)) — حالة القاموس. القيم الممكنة:
  * **NOT\_LOADED** — لم يتم تحميل القاموس لأنه لم يُستخدم
  * **LOADED** — تم تحميل القاموس بنجاح
  * **FAILED** — تعذّر تحميل القاموس نتيجة حدوث خطأ
  * **LOADING** — يجري تحميل القاموس الآن
  * **LOADED\_AND\_RELOADING** — تم تحميل القاموس بنجاح
  * **ويُعاد تحميله الآن (من الأسباب الشائعة: استعلام SYSTEM RELOAD DICTIONARY** —
  * **انتهاء المهلة** —
  * **تغيّر إعداد القاموس)** —
  * **FAILED\_AND\_RELOADING** — تعذّر تحميل القاموس نتيجة حدوث خطأ، ويجري تحميله الآن.
* `origin` ([String](/ar/reference/data-types/index)) — المسار إلى ملف الإعداد الذي يصف القاموس.
* `type` ([String](/ar/reference/data-types/index)) — نوع تخصيص القاموس. تخزين القواميس في الذاكرة.
* `key.names` ([Array(String)](/ar/reference/data-types/index)) — مصفوفة بأسماء المفاتيح التي يوفّرها القاموس.
* `key.types` ([Array(String)](/ar/reference/data-types/index)) — المصفوفة المقابلة لأنواع المفاتيح التي يوفّرها القاموس.
* `attribute.names` ([Array(String)](/ar/reference/data-types/index)) — مصفوفة بأسماء السمات التي يوفّرها القاموس.
* `attribute.types` ([Array(String)](/ar/reference/data-types/index)) — المصفوفة المقابلة لأنواع السمات التي يوفّرها القاموس.
* `bytes_allocated` ([UInt64](/ar/reference/data-types/index)) — مقدار ذاكرة RAM المخصّصة للقاموس.
* `hierarchical_index_bytes_allocated` ([UInt64](/ar/reference/data-types/index)) — مقدار ذاكرة RAM المخصّصة للفهرس الهرمي.
* `query_count` ([UInt64](/ar/reference/data-types/index)) — عدد الاستعلامات منذ تحميل القاموس أو منذ آخر إعادة تشغيل ناجحة.
* `hit_rate` ([Float64](/ar/reference/data-types/index)) — بالنسبة إلى قواميس cache، النسبة المئوية للاستخدامات التي كانت فيها القيمة موجودة في cache.
* `found_rate` ([Float64](/ar/reference/data-types/index)) — النسبة المئوية للاستخدامات التي عُثر فيها على القيمة.
* `element_count` ([UInt64](/ar/reference/data-types/index)) — عدد العناصر المخزّنة في القاموس.
* `load_factor` ([Float64](/ar/reference/data-types/index)) — نسبة الامتلاء في القاموس (وبالنسبة إلى القاموس المُهشَّم، نسبة الامتلاء في hash table).
* `source` ([String](/ar/reference/data-types/index)) — نص يصف مصدر البيانات الخاص بالقاموس.
* `lifetime_min` ([UInt64](/ar/reference/data-types/index)) — الحد الأدنى لمدة بقاء القاموس في الذاكرة، وبعده يحاول ClickHouse إعادة تحميل القاموس (إذا كان `invalidate_query` مضبوطًا، فلا يحدث ذلك إلا إذا كان قد تغيّر). وتُضبط هذه القيمة بالثواني.
* `lifetime_max` ([UInt64](/ar/reference/data-types/index)) — الحد الأقصى لمدة بقاء القاموس في الذاكرة، وبعده يحاول ClickHouse إعادة تحميل القاموس (إذا كان `invalidate_query` مضبوطًا، فلا يحدث ذلك إلا إذا كان قد تغيّر). وتُضبط هذه القيمة بالثواني.
* `loading_start_time` ([DateTime](/ar/reference/data-types/index)) — وقت بدء تحميل القاموس.
* `last_successful_update_time` ([DateTime](/ar/reference/data-types/index)) — وقت انتهاء تحميل القاموس أو تحديثه. يساعد ذلك على مراقبة بعض المشكلات المتعلقة بمصادر القواميس والتحقيق في أسبابها.
* `error_count` ([UInt64](/ar/reference/data-types/index)) — عدد الأخطاء منذ آخر تحميل ناجح. يساعد ذلك على مراقبة بعض المشكلات المتعلقة بمصادر القواميس والتحقيق في أسبابها.
* `loading_duration` ([Float32](/ar/reference/data-types/index)) — مدة تحميل القاموس.
* `last_exception` ([String](/ar/reference/data-types/index)) — نص الخطأ الذي يحدث عند إنشاء القاموس أو إعادة تحميله إذا تعذّر إنشاء القاموس.
* `comment` ([String](/ar/reference/data-types/index)) — نص التعليق الخاص بالقاموس.

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

اضبط القاموس:

```sql theme={null}
CREATE DICTIONARY dictionary_with_comment
(
    id UInt64,
    value String
)
PRIMARY KEY id
SOURCE(CLICKHOUSE(HOST 'localhost' PORT tcpPort() TABLE 'source_table'))
LAYOUT(FLAT())
LIFETIME(MIN 0 MAX 1000)
COMMENT 'The temporary dictionary';
```

تأكد من تحميل القاموس.

```sql theme={null}
SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
```

```text theme={null}
Row 1:
──────
database:                    default
name:                        dictionary_with_comment
uuid:                        4654d460-0d03-433a-8654-d4600d03d33a
status:                      NOT_LOADED
origin:                      4654d460-0d03-433a-8654-d4600d03d33a
type:
key.names:                   ['id']
key.types:                   ['UInt64']
attribute.names:             ['value']
attribute.types:             ['String']
bytes_allocated:             0
query_count:                 0
hit_rate:                    0
found_rate:                  0
element_count:               0
load_factor:                 0
source:
lifetime_min:                0
lifetime_max:                0
loading_start_time:          1970-01-01 00:00:00
last_successful_update_time: 1970-01-01 00:00:00
loading_duration:            0
last_exception:
comment:                     The temporary dictionary
```