مصدر القاموس من ملف قابل للتنفيذ

يعتمد التعامل مع الملفات القابلة للتنفيذ على كيفية تخزين القاموس في الذاكرة. إذا كان القاموس مخزّنًا باستخدام cache وcomplex_key_cache، يطلب ClickHouse المفاتيح المطلوبة عبر إرسال طلب إلى STDIN الخاص بالملف القابل للتنفيذ. بخلاف ذلك، يشغّل ClickHouse الملف القابل للتنفيذ ويتعامل مع مخرجاته على أنها بيانات القاموس. مثال على الإعدادات:

DDL
ملف التهيئة

SOURCE(EXECUTABLE(
    command 'cat /opt/dictionaries/os.tsv'
    format 'TabSeparated'
    implicit_key false
))

<source>
    <executable>
        <command>cat /opt/dictionaries/os.tsv</command>
        <format>TabSeparated</format>
        <implicit_key>false</implicit_key>
    </executable>
</source>

حقول الإعداد:

الإعداد	الوصف
`command`	المسار المطلق إلى الملف القابل للتنفيذ، أو اسم الملف (إذا كان دليل الأمر موجودًا في `PATH`).
`format`	تنسيق الملف. جميع التنسيقات الموضحة في Formats مدعومة.
`command_termination_timeout`	يجب أن يحتوي السكربت القابل للتنفيذ على حلقة رئيسية للقراءة والكتابة. بعد إتلاف القاموس، يُغلق الـ pipe، ويُمنح الملف القابل للتنفيذ مهلة قدرها `command_termination_timeout` ثانية قبل أن يرسل ClickHouse إشارة `SIGTERM` إلى العملية الفرعية. تُحدَّد القيمة بالثواني. القيمة الافتراضية هي `10`. اختياري.
`command_read_timeout`	مهلة قراءة البيانات من `stdout` الخاص بالأمر، بالمللي ثانية. القيمة الافتراضية `10000`. اختياري.
`command_write_timeout`	مهلة كتابة البيانات إلى `stdin` الخاص بالأمر، بالمللي ثانية. القيمة الافتراضية `10000`. اختياري.
`implicit_key`	يمكن لملف المصدر القابل للتنفيذ أن يعيد القيم فقط، ويُحدَّد تطابقها مع المفاتيح المطلوبة ضمنيًا وفقًا لترتيب الصفوف في النتيجة. القيمة الافتراضية هي `false`.
`execute_direct`	إذا كانت `execute_direct` = `1`، فسيُبحث عن `command` داخل مجلد `user_scripts` المحدد بواسطة user_scripts_path. ويمكن تحديد وسائط إضافية للسكربت باستخدام مسافة فاصلة بينها. مثال: `script_name arg1 arg2`. وإذا كانت `execute_direct` = `0`، فسيُمرَّر `command` كوسيط إلى `bin/sh -c`. القيمة الافتراضية هي `0`. اختياري.
`send_chunk_header`	يتحكم في إرسال عدد الصفوف قبل إرسال chunk من البيانات إلى العملية. القيمة الافتراضية هي `false`. اختياري.

لا يمكن تهيئة مصدر القاموس هذا إلا عبر تهيئة XML. وإنشاء القواميس ذات المصدر القابل للتنفيذ عبر DDL معطّل؛ وإلا فسيتمكن مستخدم DB من تنفيذ ملفات ثنائية عشوائية على عقدة ClickHouse.

مرجع SQL

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

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

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

مصدر القاموس من ملف قابل للتنفيذ