HTTP(S)-источник словаря

Работа с HTTP(S)-сервером зависит от того, как словарь хранится в памяти. Если словарь хранится с использованием cache и complex_key_cache, ClickHouse запрашивает необходимые ключи, отправляя POST-запрос.

Пример настроек:

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-аутентификация. Необязательно.
`user`	Имя пользователя, необходимое для аутентификации.
`password`	Пароль, необходимый для аутентификации.
`headers`	Все пользовательские HTTP-заголовки, используемые в HTTP-запросе. Необязательно.
`header`	Один HTTP-заголовок.
`name`	Имя, используемое для заголовка, отправляемого в запросе.
`value`	Значение, заданное для указанного имени.

При создании словаря с помощью DDL-команды (CREATE DICTIONARY ...) удаленные хосты для HTTP-словарей сверяются с содержимым раздела remote_url_allow_hosts в конфигурации, чтобы пользователи базы данных не могли получать доступ к произвольным HTTP-серверам.