تخطيطات القواميس

أنواع تخطيط القاموس

توجد عدة طرق لتخزين القواميس في الذاكرة، ولكل منها مفاضلات بين استخدام CPU وRAM.

التخطيط	الوصف
flat	يخزّن البيانات في مصفوفات مسطّحة مفهرسة حسب المفتاح. وهو أسرع تخطيط، لكن يجب أن تكون المفاتيح من النوع `UInt64` وأن تكون محدودة بالقيمة `max_array_size`.
hashed	يخزّن البيانات في جدول hash. لا يوجد حد لحجم المفتاح، ويدعم أي عدد من العناصر.
sparse_hashed	يشبه `hashed`، لكنه يضحّي ببعض CPU مقابل تقليل استخدام الذاكرة.
complex_key_hashed	يشبه `hashed`، للمفاتيح المركبة.
complex_key_sparse_hashed	يشبه `sparse_hashed`، للمفاتيح المركبة.
hashed_array	تُخزَّن السمات في مصفوفات مع جدول hash يربط المفاتيح بفهارس المصفوفات. وهو فعّال من حيث الذاكرة عند وجود عدد كبير من السمات.
complex_key_hashed_array	يشبه `hashed_array`، للمفاتيح المركبة.
range_hashed	جدول hash مع ranges مرتبة. يدعم عمليات lookup حسب المفتاح + نطاق التاريخ/الوقت.
complex_key_range_hashed	يشبه `range_hashed`، للمفاتيح المركبة.
cache	cache ثابتة الحجم داخل الذاكرة. لا تُخزَّن إلا المفاتيح التي يكثر الوصول إليها.
complex_key_cache	يشبه `cache`، للمفاتيح المركبة.
ssd_cache	يشبه `cache`، لكنه يخزّن البيانات على SSD مع index داخل الذاكرة.
complex_key_ssd_cache	يشبه `ssd_cache`، للمفاتيح المركبة.
direct	لا يستخدم تخزينًا داخل الذاكرة — بل يستعلم المصدر مباشرةً لكل طلب.
complex_key_direct	يشبه `direct`، للمفاتيح المركبة.
ip_trie	بنية trie لإجراء عمليات lookup سريعة على بادئات IP (المعتمدة على CIDR).
hierarchical	يدعم البُنى الهرمية باستخدام مفتاح رقمي يصف علاقات الأصل والفرع.
polygon	عمليات lookup فعّالة للنقطة داخل المضلع (الترميز الجغرافي العكسي).
regexp_tree	يطابق المفاتيح مع شجرة من التعبيرات النمطية.

التخطيطات الموصى بهايوفّر flat وhashed وcomplex_key_hashed أفضل أداء للاستعلامات. لا يُنصح بتخطيطات التخزين المؤقت بسبب احتمال ضعف الأداء وصعوبة ضبط المَعلمات — راجع cache للتفاصيل.

لا تصلح التخطيطات المعتمدة على التخزين المؤقت للإثراء الموثوق وقت الإدراج، لأن عناصرها المُحمَّاة مسبقًا تبقى محلية على كل خادم، وتُفقد عند إعادة تشغيل الخادم أو استبداله. ويزيد التوسع التلقائي في ClickHouse Cloud واستبدال العُقد المُدار من احتمال حدوث ذلك. لذا استخدم بدلًا منها تخطيطًا مُحمَّلًا بالكامل؛ راجع قواميس التخزين المؤقت في مسارات الإدخال.

تحديد تخطيط القاموس

إذا كنت تستخدم قاموسًا مع ClickHouse Cloud، فيُرجى استخدام خيار DDL query لإنشاء قواميسك، وإنشاء قاموسك كمستخدم default. تحقّق أيضًا من قائمة مصادر القواميس المدعومة في دليل التوافق مع Cloud.

يمكنك ضبط تخطيط القاموس باستخدام العبارة LAYOUT ‏(في DDL) أو الإعداد layout في تعريفات ملف التهيئة.

DDL
ملف التهيئة

CREATE DICTIONARY (...)
...
LAYOUT(LAYOUT_TYPE(param value)) -- إعدادات التخطيط
...

<clickhouse>
    <dictionary>
        ...
        <layout>
            <layout_type>
                <!-- إعدادات التخطيط -->
            </layout_type>
        </layout>
        ...
    </dictionary>
</clickhouse>

انظر أيضًا إلى CREATE DICTIONARY للاطّلاع على بنية DDL الكاملة. القواميس التي لا يتضمن تخطيطها الكلمة complex-key* يكون مفتاحها من النوع UInt64، أما قواميس complex-key* فلها مفتاح مركب (معقّد، وبأنواع مختلفة). مثال على مفتاح رقمي (العمود key_column من النوع UInt64):

DDL
ملف التهيئة

CREATE DICTIONARY dict_name (
    key_column UInt64,
    ...
)
PRIMARY KEY key_column

<structure>
    <id>
        <name>key_column</name>
    </id>
    ...
</structure>

مثال على مفتاح مركب (يحتوي المفتاح على عنصر واحد من النوع String):

DDL
ملف التهيئة

CREATE DICTIONARY dict_name (
    country_code String,
    ...
)
PRIMARY KEY country_code

<structure>
    <key>
        <attribute>
            <name>country_code</name>
            <type>String</type>
        </attribute>
    </key>
    ...
</structure>

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

هناك عدة طرق لتحسين أداء القاموس:

استدعِ الدالة المستخدمة للعمل مع القاموس بعد GROUP BY.
علِّم السمات المراد استخراجها بأنها injective. تُعدّ السمة injective إذا كانت المفاتيح المختلفة تقابلها قيم سمات مختلفة. لذلك، عندما يستخدم GROUP BY دالةً تجلب قيمة سمة باستخدام المفتاح، تُستبعد هذه الدالة تلقائيًا من GROUP BY.

ينشئ ClickHouse استثناءً عند حدوث أخطاء في القواميس. ومن أمثلة هذه الأخطاء:

تعذّر تحميل القاموس الجاري الوصول إليه.
حدث خطأ أثناء تنفيذ استعلام على قاموس cached.

يمكنك عرض قائمة القواميس وحالاتها في جدول system.dictionaries.

مرجع SQL

أنواع البيانات

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

بحيرات البيانات

أنواع تخطيط القاموس

تحديد تخطيط القاموس

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

​أنواع تخطيط القاموس

​تحديد تخطيط القاموس

​تحسين أداء القاموس

أنواع تخطيط القاموس

تحديد تخطيط القاموس

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