Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

system.dictionaries

الوصف

يتضمن معلومات عن القواميس.

الأعمدة

  • database (String) — اسم قاعدة البيانات التي تحتوي على القاموس المُنشأ بواسطة استعلام DDL. سلسلة فارغة للقواميس الأخرى.
  • name (String) — اسم القاموس.
  • uuid (UUID) — معرّف UUID للقاموس.
  • status (Enum8('NOT_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED_AND_RELOADING' = 4, 'LOADED_AND_RELOADING' = 5, 'NOT_EXIST' = 6)) — حالة القاموس. القيم الممكنة: NOT_LOADED — القاموس غير محمّل حاليًا في الذاكرة، LOADED — تم تحميل القاموس بنجاح، FAILED — تعذّر تحميل القاموس بسبب خطأ، LOADING — يجري تحميل القاموس الآن، LOADED_AND_RELOADING — تم تحميل القاموس بنجاح ويجري إعادة تحميله الآن (أسباب شائعة: استعلام SYSTEM RELOAD DICTIONARY، timeout، تغيّر إعدادات القاموس)، FAILED_AND_RELOADING — تعذّر تحميل القاموس بسبب خطأ ويجري تحميله الآن.
  • origin (String) — المسار إلى ملف الإعدادات الذي يصف القاموس.
  • type (String) — نوع تخصيص القاموس. تخزين القواميس في الذاكرة.
  • key.names (Array(String)) — مصفوفة بأسماء المفاتيح التي يوفرها القاموس.
  • key.types (Array(String)) — المصفوفة المقابلة لأنواع المفاتيح التي يوفرها القاموس.
  • attribute.names (Array(String)) — مصفوفة بأسماء السمات التي يوفرها القاموس.
  • attribute.types (Array(String)) — المصفوفة المقابلة لأنواع السمات التي يوفرها القاموس.
  • bytes_allocated (UInt64) — مقدار RAM المخصص للقاموس.
  • hierarchical_index_bytes_allocated (UInt64) — مقدار RAM المخصص للفهرس الهرمي.
  • query_count (UInt64) — عدد الاستعلامات منذ تحميل القاموس أو منذ آخر إعادة تشغيل ناجحة.
  • hit_rate (Float64) — بالنسبة إلى قواميس cache، النسبة المئوية للاستخدامات التي كانت القيمة فيها موجودة في cache.
  • found_rate (Float64) — النسبة المئوية للاستخدامات التي عُثر فيها على القيمة.
  • element_count (UInt64) — عدد العناصر المخزنة في القاموس.
  • load_factor (Float64) — نسبة الامتلاء في القاموس (وبالنسبة إلى قاموس hashed، نسبة الامتلاء في جدول hash).
  • source (String) — نص يصف مصدر بيانات القاموس.
  • lifetime_min (UInt64) — الحد الأدنى لعمر القاموس في الذاكرة، وبعده يحاول ClickHouse إعادة تحميل القاموس (إذا تم تعيين invalidate_query، فلا يحدث ذلك إلا إذا تغيّر). يُضبط بالثواني.
  • lifetime_max (UInt64) — الحد الأقصى لعمر القاموس في الذاكرة، وبعده يحاول ClickHouse إعادة تحميل القاموس (إذا تم تعيين invalidate_query، فلا يحدث ذلك إلا إذا تغيّر). يُضبط بالثواني.
  • loading_start_time (DateTime) — وقت بدء تحميل القاموس.
  • last_successful_update_time (DateTime) — وقت انتهاء تحميل القاموس أو تحديثه. يساعد في مراقبة المشكلات المتعلقة بمصادر القواميس والتحقيق في أسبابها.
  • error_count (UInt64) — عدد الأخطاء منذ آخر تحميل ناجح. يساعد في مراقبة المشكلات المتعلقة بمصادر القواميس والتحقيق في أسبابها.
  • loading_duration (Float32) — مدة تحميل القاموس.
  • last_exception (String) — نص الخطأ الذي يحدث عند إنشاء القاموس أو إعادة تحميله إذا تعذّر إنشاؤه.
  • comment (String) — نص التعليق الخاص بالقاموس.

مثال

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

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';

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

SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
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
Navigation