http_allow_database_as_path
Если включено, HTTP-интерфейс распознаёт компонент/database/ в пути URL и использует его в качестве текущей базы данных.
Это настройка для отдельного пользователя, определяющая, будет ли интерпретироваться маршрутизируемый запрос с путём в URL. Сама маршрутизация глобально регулируется настройкой конфигурации уровня сервера http_allow_path_requests (по умолчанию включена). Её необходимо включить, чтобы HTTP-интерфейс вообще направлял запрос с путём в URL (например, /my_db/my_table.csv) обработчику запросов: решение о маршрутизации принимается до аутентификации запроса, поэтому оно не может зависеть от настройки для отдельного пользователя. Если http_allow_path_requests отключена, неизвестные пути возвращают обычный ответ 404. После маршрутизации эта настройка повторно проверяется с учётом действующих настроек аутентифицированного пользователя, поэтому её можно выборочно отключать для отдельных пользователей, ролей или профилей.
http_allow_filters_as_path
Если включено, HTTP-интерфейс распознаёт компоненты/name=value/ в пути (в стиле партиционирования Hive) и преобразует их в фильтры, объединённые с помощью AND. Также распознаются операторы >, <, >=, <=, !=, <>.
Как и http_allow_database_as_path, это настройка для отдельного пользователя; маршрутизация запросов с путём в URL глобально регулируется настройкой конфигурации уровня сервера http_allow_path_requests (маршрутизация выполняется до аутентификации).
http_allow_filters_as_unrecognized_url_parameters
Если включено, любой URL-параметр, не распознанный как известный параметр, настройка или параметр с префиксомparam_*, обрабатывается как фильтр и объединяется с другими с помощью AND. Поддерживаются две формы:
- Обычный
name=valueпреобразуется в проверку на равенство`name` = 'value'(идентификатор заключается в обратные кавычки, а значение — в одинарные кавычки как строковый литерал). - Оператор сравнения (
!=,>,<,>=,<=,<>) превращает его в сравнение: он может быть разделён между именем и значением параметра (?a!=2,?a>=2) или записан непосредственно, если в URL нет=для разделения (?a<>2,?f(x)>3); в этом случае восстановленноеname[=value]разбирается как полное SQL-выражение.
http_allow_*, эта настройка по умолчанию отключена. Она действует для каждого запроса HTTP-интерфейса, включая конечную точку /?query=..., поэтому после её включения любой нераспознанный URL-параметр, который добавляет клиент (идентификатор запроса, подпись, параметр для обхода кэша), становится фильтром запроса. Опечатка в имени настройки в этом случае приводит уже не к ошибке UNKNOWN_SETTING, а к ошибке UNKNOWN_IDENTIFIER (а если имя совпадёт с именем столбца, результат будет незаметно отфильтрован). Кроме того, значение параметра попадает в текст запроса и не маскируется там, в отличие от Request URI в журнале.
http_allow_table_as_file
Если включено, HTTP-интерфейс распознаёт последний компонент пути URL как имя таблицы в формеtable, table.format или table.format.compression. Путь интерпретируется как SELECT * FROM table.
Как и http_allow_database_as_path, это настройка для отдельного пользователя; маршрутизация запросов с путём в URL глобально контролируется настройкой конфигурации уровня сервера http_allow_path_requests (маршрутизация выполняется до аутентификации).
http_connection_timeout
Тайм-аут HTTP-соединения (в секундах). Возможные значения:- Любое положительное целое число.
- 0 — отключено (бесконечный тайм-аут).
http_make_head_request
Настройкаhttp_make_head_request позволяет выполнять запрос HEAD при чтении данных по HTTP, чтобы получить сведения о файле, например его размер. Поскольку она включена по умолчанию, если сервер не поддерживает запросы HEAD, эту настройку может быть целесообразно отключить.
http_native_compression_disable_checksumming_on_decompress
Включает или отключает проверку контрольной суммы при распаковке данных HTTP POST, полученных от клиента. Используется только для собственного формата сжатия ClickHouse (не используется сgzip или deflate).
Для получения дополнительной информации см. описание HTTP-интерфейса.
Возможные значения:
- 0 — Отключено.
- 1 — Включено.
http_receive_timeout
Тайм-аут получения данных по HTTP (в секундах). Возможные значения:- Любое положительное целое число (в секундах).
0не является бесконечным тайм-аутом и может привести к сбоям при установке соединения (для тайм-аутов POSIX-сокетов требуется положительный интервал).
http_send_timeout
Тайм-аут отправки по HTTP (в секундах). Возможные значения:- Любое положительное целое число (в секундах).
0не является бесконечным тайм-аутом и может привести к сбоям при установлении соединения (тайм-ауты POSIX-сокетов требуют положительного интервала).
Применяется только к профилю default. Для применения изменений требуется перезагрузка сервера.
http_skip_not_found_url_for_globs
Пропускать URL-адреса, заданные глоб-шаблонами, при ошибке HTTP_NOT_FOUNDhttp_wait_end_of_query
Включает буферизацию HTTP-ответа на стороне сервера.http_write_exception_in_output_format
Записывает исключение в формат вывода, чтобы вывод оставался корректным. Работает с форматами JSON и XML.http_x_clickhouse_format_overrides_output_format
Определяет, какой настройке соответствует HTTP-заголовокX-ClickHouse-Format.
Если настройка включена (по умолчанию), заголовок является псевдонимом настройки output_format: он явно переопределяет формат ответа и имеет приоритет как над предложением FORMAT в запросе, так и над расширением файла в пути URL.
Если настройка отключена, заголовок является псевдонимом настройки default_format, как было до версии 26.8: он лишь задаёт формат, который используется, если в запросе нет предложения FORMAT и не применяется никакое другое переопределение формата.
В обоих случаях заголовок переопределяет одноимённый параметр URL (output_format или default_format соответственно) и никак не влияет на разбор тела запроса INSERT.
Это настройка совместимости для HTTP-интерфейса: заголовок обрабатывается до разбора запроса, поэтому настройку необходимо передавать через параметр URL или профиль пользователя, а не через предложение SETTINGS внутри запроса. Как и сами output_format и default_format, её можно изменить даже в режиме только для чтения (readonly = 1), поэтому пользователь с правом только на чтение может передать её как параметр URL.
http_zlib_compression_level
Задает уровень сжатия данных в ответе на HTTP-запрос, если enable_http_compression = 1. Возможные значения: числа от 1 до 12. Уровни выше9 требуют сборки по умолчанию с libdeflate; сборка без libdeflate поддерживает уровни от 1 до 9.