مصدر قاموس HTTP(S)

يعتمد العمل مع خادم HTTP(S) على كيفية تخزين القاموس في الذاكرة. إذا كان القاموس مخزّنًا باستخدام cache وcomplex_key_cache، فإن ClickHouse يطلب المفاتيح اللازمة عبر إرسال طلب باستخدام الطريقة POST. مثال على الإعدادات:

DDL
ملف الإعداد

SOURCE(HTTP(
    url 'http://[::1]/os.tsv'
    format 'TabSeparated'
    credentials(user 'user' password 'password')
    headers(header(name 'API-KEY' value 'key'))
))

<source>
    <http>
        <url>http://[::1]/os.tsv</url>
        <format>TabSeparated</format>
        <credentials>
            <user>user</user>
            <password>password</password>
        </credentials>
        <headers>
            <header>
                <name>API-KEY</name>
                <value>key</value>
            </header>
        </headers>
    </http>
</source>

لكي يتمكن ClickHouse من الوصول إلى مورد HTTPS، يجب تهيئة OpenSSL في إعدادات الخادم. حقول الإعداد:

الإعداد	الوصف
`url`	عنوان URL للمصدر.
`format`	تنسيق الملف. جميع التنسيقات الموضّحة في Formats مدعومة.
`credentials`	مصادقة HTTP من نوع Basic. اختياري.
`user`	اسم المستخدم المطلوب للمصادقة.
`password`	كلمة المرور المطلوبة للمصادقة.
`headers`	جميع إدخالات ترويسات HTTP المخصصة المستخدمة في طلب HTTP. اختياري.
`header`	إدخال واحد لترويسة HTTP.
`name`	اسم المعرّف المستخدم للترويسة المُرسلة مع الطلب.
`value`	القيمة المعيّنة لاسم معرّف محدد.

عند إنشاء قاموس باستخدام أمر DDL (CREATE DICTIONARY ...)، يتم التحقق من المضيفات البعيدة الخاصة بقواميس HTTP مقارنةً بمحتوى القسم remote_url_allow_hosts في الإعدادات، وذلك لمنع مستخدمي قاعدة البيانات من الوصول إلى أي خادم HTTP بشكل عشوائي. تُعرض الترويسات، بما في ذلك أسماؤها، على هيئة HEADERS ('[HIDDEN]') في مخرجات SHOW CREATE DICTIONARY وفي system.tables وفي سجلات الاستعلامات، على غرار كلمة المرور تمامًا. وكما في حالة كلمة المرور، يُسجَّل الاستعلام الذي يتعذّر تحليله كما هو، ولا يُطبَّق عليه سوى query_masking_rules. لعرض الترويسات في SHOW CREATE DICTIONARY وsystem.tables، فعّل إعداد الخادم display_secrets_in_show_and_select وإعداد الصيغة format_display_secrets_in_show_and_select؛ كما يجب أن يمتلك المستخدم الامتياز displaySecretsInShowAndSelect. ولا تؤثر هذه الإعدادات في سجلات الاستعلامات.

مرجع SQL

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

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

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