Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão http_*

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para reconhecer um nome de banco de dados no caminho da URL de requisições HTTP.

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para reconhecer filtros `name=value` no estilo Hive no caminho da URL de requisições HTTP.

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para tratar parâmetros de URL não reconhecidos como expressões de filtro em requisições HTTP.

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para reconhecer um nome de tabela no caminho da URL de requisições HTTP, com extensões opcionais de formato/compressão.

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

Tipo
Segundos
Padrão
1

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

Tipo
Bool
Padrão
1

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

Tipo
Bool
Padrão
0

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

Tipo
Segundos
Padrão
30
Histórico de versões
VersãoValor padrãoComentário
23.630Consulte http_send_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

Tipo
Segundos
Padrão
30
Histórico de versões
VersãoValor padrãoComentário
23.6303 minutos parece tempo demais. Observe que este é o tempo limite de uma única chamada de gravação na rede, não da operação de upload inteira.

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).

http_skip_not_found_url_for_globs

Tipo
Bool
Padrão
1

Ignora URLs de globs com erro HTTP_NOT_FOUND

http_wait_end_of_query

Tipo
Bool
Padrão
0

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

http_write_exception_in_output_format

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.110Alterado para manter consistência entre os formatos
23.91Gera JSON/XML válido em caso de exceção no HTTP streaming.

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

Tipo
Int64
Padrão
3

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.

Navigation