Skip to main content
Эти настройки доступны в system.settings и автоматически сгенерированы на основе исходного файла.

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_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_FOUND

http_wait_end_of_query

Включает буферизацию HTTP-ответа на стороне сервера.

http_write_exception_in_output_format

Записывает исключение в формат вывода, чтобы вывод оставался корректным. Работает с форматами JSON и XML.

http_zlib_compression_level

Задает уровень сжатия данных в ответе на HTTP-запрос, если enable_http_compression = 1. Возможные значения: числа от 1 до 12. Уровни выше 9 требуют сборки по умолчанию с libdeflate; сборка без libdeflate поддерживает уровни от 1 до 9.
Последнее изменение 18 августа 2026 г.