Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

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

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva configuración para reconocer un nombre de base de datos en la ruta URL de las solicitudes HTTP.

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 (desactivada 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 habilitarse selectivamente para cada usuario, rol o perfil.

http_allow_filters_as_path

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva configuración para reconocer filtros `name=value` de estilo Hive en la ruta URL de las solicitudes HTTP.

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

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva configuración para tratar los parámetros URL no reconocidos como expresiones de filtro en solicitudes HTTP.

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.

http_allow_table_as_file

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.80Nueva configuración para reconocer un nombre de tabla en la ruta URL de las solicitudes HTTP, con extensiones opcionales de formato/compresión.

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

Tipo
Seconds
Predeterminado
1

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

Tipo
Bool
Predeterminado
1

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

Tipo
Bool
Predeterminado
0

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

Tipo
Seconds
Predeterminado
30
Historial de versiones
VersiónValor predeterminadoComentario
23.630Consulte http_send_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

Tipo
Seconds
Predeterminado
30
Historial de versiones
VersiónValor predeterminadoComentario
23.6303 minutos parecen exageradamente largos. Ten en cuenta que este es el tiempo de espera para una sola llamada de escritura de red, no para toda la operación de carga.

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

Tipo
Bool
Predeterminado
1

Omitir las URL de globs con error HTTP_NOT_FOUND

http_wait_end_of_query

Tipo
Bool
Predeterminado
0

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

http_write_exception_in_output_format

Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.110Se cambió para mantener la coherencia entre formatos
23.91Genera JSON/XML válidos cuando se produce una excepción en HTTP streaming.

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

http_zlib_compression_level

Tipo
Int64
Predeterminado
3

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.

Navigation