Skip to main content
Essas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

http_allow_database_as_path

Quando habilitada, a interface HTTP reconhece o componente /database/ no caminho da URL e o usa como banco de dados atual. Esta é uma configuração por usuário que controla se uma requisição roteada baseada em caminho é interpretada. O roteamento em si é controlado globalmente pela configuração http_allow_path_requests no nível do servidor (desativada por padrão), que deve ser habilitada para que a interface HTTP encaminhe uma requisição baseada em caminho (como /my_db/my_table.csv) ao manipulador de consultas — essa decisão de roteamento é tomada antes da autenticação da requisição e, portanto, não pode depender de uma configuração por usuário. Quando http_allow_path_requests está desativada, caminhos desconhecidos retornam um 404 simples. Após o roteamento, essa configuração é verificada novamente com base nas configurações efetivas do usuário autenticado, podendo ser habilitada seletivamente por usuário, função ou perfil.

http_allow_filters_as_path

Quando habilitada, a interface HTTP reconhece componentes /name=value/ no caminho (estilo de particionamento Hive) e os converte em filtros combinados com AND. Os operadores >, <, >=, <=, !=, <> também são reconhecidos. Assim como http_allow_database_as_path, esta é uma configuração por usuário; o roteamento de requisições baseadas em caminho é controlado globalmente pela configuração http_allow_path_requests no nível do servidor (o roteamento ocorre antes da autenticação).

http_allow_filters_as_unrecognized_url_parameters

Quando habilitado, qualquer parâmetro de URL que não seja reconhecido como um parâmetro, uma configuração ou um prefixo param_* conhecido é tratado como um filtro e combinado com AND. São aceitas duas formas:
  • Um name=value simples é convertido na igualdade `name` = 'value' (o identificador é delimitado por crases, e o valor é colocado entre aspas como um literal de string).
  • Um operador de comparação (!=, >, <, >=, <=, <>) faz com que o parâmetro seja tratado como uma comparação: ele pode ser separado no parâmetro (?a!=2, ?a>=2) ou escrito inline quando a URL não contém = para separá-lo (?a<>2, ?f(x)>3); nesse caso, o name[=value] recomposto é convertido em uma expressão SQL completa.

http_allow_table_as_file

Quando habilitada, a interface HTTP reconhece o último componente do caminho da URL como um nome de tabela nas formas table, table.format ou table.format.compression. O caminho é interpretado como SELECT * FROM table. Assim como http_allow_database_as_path, esta é uma configuração por usuário; o roteamento de requisições baseadas em caminho é controlado globalmente pela configuração http_allow_path_requests no nível do servidor (o roteamento ocorre antes da autenticação).

http_connection_timeout

Tempo limite de conexão HTTP (em segundos). Valores possíveis:
  • Qualquer número inteiro positivo.
  • 0 - Desativado (tempo limite infinito).

http_make_head_request

A configuração http_make_head_request permite executar uma solicitação HEAD ao ler dados via HTTP para obter informações sobre o arquivo a ser lido, como seu tamanho. Como ela é habilitada por padrão, pode ser desejável desabilitar essa configuração nos casos em que o servidor não oferece suporte a solicitações HEAD.

http_native_compression_disable_checksumming_on_decompress

Ativa ou desativa a verificação de checksum ao descomprimir os dados de HTTP POST do cliente. Usado apenas para o formato de compressão nativo do ClickHouse (não é usado com gzip ou deflate). Para mais informações, leia a descrição da interface HTTP. Valores possíveis:
  • 0 — Desabilitado.
  • 1 — Habilitado.

http_receive_timeout

Tempo limite para recebimento via HTTP (em segundos). Valores possíveis:
  • Qualquer número inteiro positivo (segundos). 0 não representa um tempo limite infinito e pode causar falhas ao estabelecer a conexão (os tempos limites de socket POSIX exigem um intervalo positivo).

http_send_timeout

Tempo limite de envio HTTP (em segundos). Valores possíveis:
  • Qualquer número inteiro positivo (segundos). 0 não representa um tempo limite infinito e pode causar falhas no estabelecimento da conexão (o tempo limite de socket POSIX exige um intervalo positivo).
Aplica-se apenas ao perfil padrão. É necessário reiniciar o servidor para que as alterações entrem em vigor.

http_skip_not_found_url_for_globs

Ignora URLs de globs com erro HTTP_NOT_FOUND

http_wait_end_of_query

Ativa a bufferização da resposta HTTP no servidor.

http_write_exception_in_output_format

Grava a exceção no formato de saída para gerar uma saída válida. Funciona com os formatos JSON e XML.

http_zlib_compression_level

Define o nível de compressão de dados na resposta a uma requisição HTTP se enable_http_compression = 1. Valores possíveis: números de 1 a 12. Níveis acima de 9 exigem a compilação padrão com libdeflate; uma compilação sem libdeflate oferece suporte aos níveis de 1 a 9.
Última modificação em 18 de agosto de 2026