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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.8 | 0 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.8 | 0 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.8 | 0 | Nova 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=valuesimples é 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, oname[=value]recomposto é convertido em uma expressão SQL completa.
http_allow_table_as_file
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.8 | 0 | Nova 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
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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 23.6 | 30 | Consulte http_send_timeout. |
Tempo limite para recebimento via HTTP (em segundos).
Valores possíveis:
- Qualquer número inteiro positivo (segundos).
0nã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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 23.6 | 30 | 3 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).
0nã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
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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.11 | 0 | Alterado para manter consistência entre os formatos |
| 23.9 | 1 | Gera 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
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.