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

هيّئ نقطة نهاية HTTP أو HTTPS كمصدر قاموس في ClickHouse.

يعتمد العمل مع خادم 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 بشكل عشوائي.