Set up docs MCPЭти настройки доступны в system.settings и автоматически сгенерированы на основе исходного файла.
http_allow_database_as_path
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.8 | 0 | Новая настройка для распознавания имени базы данных в пути URL HTTP-запросов. |
Если включено, 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
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.8 | 0 | Новая настройка для распознавания в пути URL HTTP-запросов фильтров `name=value` в стиле партиционирования Hive. |
Если включено, HTTP-интерфейс распознаёт компоненты /name=value/ в пути (в стиле партиционирования Hive) и преобразует их в фильтры, объединённые с помощью AND. Также распознаются операторы >, <, >=, <=, !=, <>.
Как и http_allow_database_as_path, это настройка для отдельного пользователя; маршрутизация запросов с путём в URL глобально регулируется настройкой конфигурации уровня сервера http_allow_path_requests (маршрутизация выполняется до аутентификации).
http_allow_filters_as_unrecognized_url_parameters
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.8 | 0 | Новая настройка для обработки нераспознанных URL-параметров как выражений фильтра в HTTP-запросах. |
Если включено, любой 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
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.8 | 0 | Новая настройка для распознавания имени таблицы в пути URL HTTP-запросов с необязательными расширениями формата/сжатия. |
Если включено, 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
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 23.6 | 30 | См. http_send_timeout. |
Тайм-аут получения данных по HTTP (в секундах).
Возможные значения:
- Любое положительное целое число (в секундах).
0не является бесконечным тайм-аутом и может привести к сбоям при установке соединения (для тайм-аутов POSIX-сокетов требуется положительный интервал).
http_send_timeout
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 23.6 | 30 | 3 минуты — неоправданно много. Обратите внимание, что это тайм-аут для одного вызова записи в сеть, а не для всей операции загрузки. |
Тайм-аут отправки по HTTP (в секундах).
Возможные значения:
- Любое положительное целое число (в секундах).
0не является бесконечным тайм-аутом и может привести к сбоям при установлении соединения (тайм-ауты POSIX-сокетов требуют положительного интервала).
http_skip_not_found_url_for_globs
Пропускать URL-адреса, заданные глоб-шаблонами, при ошибке HTTP_NOT_FOUND
http_wait_end_of_query
Включает буферизацию HTTP-ответа на стороне сервера.
http_write_exception_in_output_format
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.11 | 0 | Изменено для единообразия между форматами |
| 23.9 | 1 | Формирует корректный JSON/XML при исключении во время потоковой передачи по HTTP. |
Записывает исключение в формат вывода, чтобы вывод оставался корректным. Работает с форматами JSON и XML.
http_zlib_compression_level
Задает уровень сжатия данных в ответе на HTTP-запрос, если enable_http_compression = 1.
Возможные значения: числа от 1 до 12. Уровни выше 9 требуют сборки по умолчанию с libdeflate; сборка без libdeflate поддерживает уровни от 1 до 9.