ajustes de sesión de http_*

Estas configuraciones están disponibles en system.settings y se generan automáticamente a partir del código fuente.

​

http_allow_database_as_path

Si está habilitada, la interfaz HTTP reconoce un componente /database/ en la ruta URL y lo utiliza como base de datos actual. Esta configuración por usuario determina si se interpreta una solicitud enrutada de estilo de ruta. El enrutamiento propiamente dicho se controla globalmente mediante la configuración del servidor http_allow_path_requests (activada de forma predeterminada), que debe habilitarse para que la interfaz HTTP enrute una solicitud de estilo de ruta (como /my_db/my_table.csv) al manejador de consultas; esta decisión de enrutamiento se toma antes de autenticar la solicitud, por lo que no puede depender de una configuración por usuario. Cuando http_allow_path_requests está desactivada, las rutas desconocidas devuelven un simple 404. Tras el enrutamiento, esta configuración se vuelve a comprobar con la configuración efectiva del usuario autenticado, por lo que puede deshabilitarse selectivamente para cada usuario, rol o perfil.

​

http_allow_filters_as_path

Si está habilitada, la interfaz HTTP reconoce componentes /name=value/ en la ruta (estilo de particionamiento Hive) y los traduce en filtros combinados con AND. También reconoce los operadores >, <, >=, <=, !=, <>. Al igual que http_allow_database_as_path, esta es una configuración por usuario; el enrutamiento de las solicitudes de estilo de ruta se controla globalmente mediante la configuración de servidor http_allow_path_requests (el enrutamiento se realiza antes de la autenticación).

​

http_allow_filters_as_unrecognized_url_parameters

Si está habilitada, cualquier parámetro URL que no se reconozca como parámetro, configuración o prefijo param_* conocido se trata como un filtro y se combina mediante AND. Se admiten dos formas:

• Un name=value simple se convierte en la igualdad `name` = 'value' (el identificador se delimita con comillas invertidas y el valor se entrecomilla como un literal de cadena).
• Un operador de comparación (!=, >, <, >=, <=, <>) lo convierte en una comparación: ya sea separado dentro del parámetro (?a!=2, ?a>=2) o escrito en línea cuando la URL no contiene un = por el que separar (?a<>2, ?f(x)>3), en cuyo caso el name[=value] reconstruido se analiza como una expresión SQL completa.

Está deshabilitada de forma predeterminada, a diferencia de las demás configuraciones http_allow_*: se aplica a todas las solicitudes de la interfaz HTTP, incluido el endpoint /?query=..., por lo que, al habilitarla, cualquier parámetro URL no reconocido que añada un Client (un identificador de solicitud, una firma, un parámetro para evitar la caché) se convierte en un filtro de la consulta. En ese caso, un nombre de configuración mal escrito ya no se notifica como UNKNOWN_SETTING, sino que falla con UNKNOWN_IDENTIFIER (o, si el nombre coincide con el de una columna, filtra el resultado sin avisar), y el valor del parámetro pasa a formar parte del texto de la consulta, donde no se enmascara como ocurre con el Request URI en el log.

​

http_allow_table_as_file

Si está habilitada, la interfaz HTTP reconoce el último componente de la ruta URL como un nombre de tabla con el formato table, table.format o table.format.compression. La ruta se interpreta como SELECT * FROM table. Al igual que http_allow_database_as_path, esta configuración es por usuario; el enrutamiento de las solicitudes de estilo de ruta se controla globalmente mediante la configuración de servidor http_allow_path_requests (el enrutamiento se realiza antes de la autenticación).

​

http_connection_timeout

Tiempo de espera de la conexión HTTP (en segundos). Valores posibles:

• Cualquier número entero positivo.
• 0 - Deshabilitado (tiempo de espera infinito).

​

http_make_head_request

La configuración http_make_head_request permite ejecutar una solicitud HEAD al leer datos desde HTTP para obtener información sobre el archivo que se va a leer, como su tamaño. Dado que está habilitada de forma predeterminada, puede ser conveniente desactivar esta configuración cuando el servidor no admita solicitudes HEAD.

​

http_native_compression_disable_checksumming_on_decompress

Habilita o deshabilita la verificación de la suma de comprobación al descomprimir los datos de una solicitud HTTP POST del client. Se usa solo con el formato de compresión nativo de ClickHouse (no se usa con gzip ni deflate). Para obtener más información, lea la descripción de la interfaz HTTP. Valores posibles:

• 0 — Deshabilitado.
• 1 — Habilitado.

​

http_receive_timeout

Tiempo de espera para la recepción de HTTP (en segundos). Valores posibles:

• Cualquier número entero positivo (segundos). 0 no es un tiempo de espera infinito y puede provocar errores al establecer la conexión (los tiempos de espera de los sockets POSIX requieren un intervalo positivo).

​

http_send_timeout

Tiempo de espera de envío HTTP (en segundos). Valores posibles:

• Cualquier entero positivo (segundos). 0 no es un tiempo de espera infinito y puede provocar errores al establecer la conexión (los tiempos de espera de socket POSIX requieren un intervalo positivo).

​

http_skip_not_found_url_for_globs

Omitir las URL de globs con error HTTP_NOT_FOUND

​

http_wait_end_of_query

Habilita el búfer de respuesta HTTP del lado del servidor.

​

http_write_exception_in_output_format

Escribe la excepción en el formato de salida para generar una salida válida. Funciona con los formatos JSON y XML.

​

http_x_clickhouse_format_overrides_output_format

Controla a qué configuración corresponde el encabezado HTTP X-ClickHouse-Format. Si está habilitada (valor predeterminado), el encabezado es un alias de la configuración output_format: actúa como una sobrescritura explícita del formato de respuesta que prevalece sobre la cláusula FORMAT de la consulta y sobre la extensión de archivo en la ruta de la URL. Si está deshabilitada, el encabezado es un alias de la configuración default_format, como ocurría antes de la versión 26.8: solo determina el formato que se usa cuando la consulta no tiene cláusula FORMAT y no se aplica ninguna otra sobrescritura de formato. En ambos casos, el encabezado prevalece sobre el parámetro de URL del mismo nombre (output_format o default_format, respectivamente) y nunca altera la forma en que se analiza el cuerpo de la solicitud de un INSERT. Esta es una configuración de compatibilidad para la interfaz HTTP: el encabezado se procesa antes de analizar la consulta, por lo que debe proporcionarse mediante un parámetro de URL o un perfil de usuario, y no mediante una cláusula SETTINGS dentro de la consulta. Al igual que output_format y default_format, siempre puede modificarse en modo de solo lectura (readonly = 1), por lo que un usuario de solo lectura puede pasarla como parámetro de URL.

​

http_zlib_compression_level

Establece el nivel de compresión de datos en la respuesta a una solicitud HTTP si enable_http_compression = 1. Posibles valores: números del 1 al 12. Los niveles superiores a 9 requieren la compilación predeterminada con libdeflate; una compilación sin libdeflate admite niveles del 1 al 9.