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

use_async_executor_for_materialized_views

Usa execução assíncrona e potencialmente multithread da consulta da visão materializada, o que pode acelerar o processamento das visões durante o INSERT, mas também pode consumir mais memória.

use_cache_for_count_from_files

Habilita o armazenamento em cache do número de linhas durante a contagem em arquivos nas funções de tabela file/s3/url/hdfs/azureBlobStorage. Habilitado por padrão.

use_client_time_zone

Use o fuso horário do cliente para interpretar valores de string do tipo DateTime, em vez de usar o fuso horário do servidor.

use_compact_format_in_distributed_parts_names

Usa formato compacto para armazenar blocos para INSERT em segundo plano (distributed_foreground_insert) em tabelas com engine Distributed. Valores possíveis:
  • 0 — Usa o formato de diretório user[:password]@host:port#default_database.
  • 1 — Usa o formato de diretório [shard{shard_index}[_replica{replica_index}]].
  • com use_compact_format_in_distributed_parts_names=0, alterações na definição do cluster não serão aplicadas ao INSERT em segundo plano.
  • com use_compact_format_in_distributed_parts_names=1, alterar a ordem dos nós na definição do cluster mudará o shard_index/replica_index, então fique atento.

use_concurrency_control

Respeita o controle de concorrência do servidor (consulte as configurações globais do servidor concurrent_threads_soft_limit_num e concurrent_threads_soft_limit_ratio_to_cores). Se estiver desabilitado, permite usar um número maior de threads mesmo que o servidor esteja sobrecarregado (não recomendado para uso normal e necessário principalmente para testes).

use_constant_folding_in_index_analysis

Substitua constantes no nível da partição no predicado de filtro ao analisar, por parte, a chave primária e os skip indexes. Quando a chave de partição aparece no filtro junto com colunas da chave primária ou de skip index, isso permite que a análise de índices incorpore o valor da partição separadamente em cada parte. Isso é mais útil para filtros disjuntivos cujos ramos visam partições diferentes. Por exemplo, com PARTITION BY a e ORDER BY b:
Para a parte da partição a = 1, a condição é simplificada para b >= 1, enquanto, para as partições a = 2 e a = 3, ela é simplificada para b > 10, de modo que cada parte seja analisada com o predicado que de fato se aplica a ela. Valores possíveis:
  • 0 — Desativado.
  • 1 — Ativado.

use_hash_table_stats_for_join_reordering

Habilita o uso de estatísticas de tabela hash coletadas para estimar a cardinalidade durante a reordenação de junções

use_hedged_requests

Ativa a lógica de hedged requests para consultas remotas. Ela permite estabelecer várias conexões com diferentes réplicas para a consulta. Uma nova conexão é iniciada caso a(s) conexão(ões) existente(s) com a(s) réplica(s) não tenha(m) sido estabelecida(s) dentro de hedged_connection_timeout ou nenhum dado tenha sido recebido dentro de receive_data_timeout. A consulta usa a primeira conexão que envia um pacote Progress não vazio (ou um pacote Data, se allow_changing_replica_until_first_data_packet); as outras conexões são canceladas. Há suporte a consultas com max_parallel_replicas > 1. Ativado por padrão. Valor padrão no Cloud: 0.

use_hive_partitioning

Quando habilitada, o ClickHouse detectará o particionamento no estilo Hive no caminho (/name=value/) em motores de tabela do tipo arquivo File/S3/URL/HDFS/AzureBlobStorage e permitirá usar colunas de partição como colunas virtuais na consulta. Essas colunas virtuais terão os mesmos nomes do caminho particionado, mas começarão com _.

use_join_disjunctions_push_down

Habilita o pushdown das partes das condições de JOIN conectadas por OR para os lados de entrada correspondentes (“pushdown parcial”). Isso permite que os motores de armazenamento apliquem filtros mais cedo, o que pode reduzir a quantidade de dados lidos. A otimização preserva a semântica e é aplicada apenas quando cada ramo OR de nível superior contribui com pelo menos um predicado determinístico para o lado de destino.

use_legacy_to_time

Quando habilitada, permite usar a função toTime legada, que converte uma data com hora em uma determinada data fixa, preservando a hora. Caso contrário, usa a nova função toTime, que converte diferentes tipos de dados para o tipo Time. A função legada antiga também fica sempre acessível como toTimeWithFixedDate.

use_lightweight_primary_key_index_analysis

Otimiza a análise do índice da chave primária para tabelas MergeTree com chaves primárias longas. Quando habilitada, o tempo de execução da análise do índice depende principalmente da complexidade do filtro da consulta (das colunas-chave que ela realmente usa), e não do comprimento da chave primária — portanto, estender a chave de ordenação adiciona uma sobrecarga insignificante à análise do índice para consultas que filtram apenas algumas de suas colunas. Valores possíveis:
  • 0 — Desabilitada. Todas as colunas da chave primária são processadas durante a análise do índice.
  • 1 — Habilitada.

use_parquet_metadata_cache

Quando ativado, o formato Parquet pode usar o cache de metadados do Parquet. Valores possíveis:
  • 0 - Desabilitado
  • 1 - Habilitado

use_primary_key

Usa a chave primária para podar grânulos durante a execução de consultas em tabelas MergeTree. Valores possíveis:
  • 0 — Desabilitado.
  • 1 — Habilitado.

use_reader_executor

Experimental. Direciona leituras pelo novo pipeline ReaderExecutor em vez da matryoshka legada de buffers de leitura. Recorre ao caminho legado para configurações que o executor ainda não suporta.

use_roaring_bitmap_iceberg_positional_deletes

Usa bitmap roaring para exclusões posicionais do Iceberg.

use_streaming_marks_compression

Ao carregar marcas para partes MergeTree, comprima-as em sua representação em memória, um bloco por vez (streaming), em vez de primeiro materializar todo o array simples de marcas. Isso reduz significativamente o uso máximo de memória durante o carregamento de marcas para partes compactas com muitos subfluxos (por exemplo, tabelas com colunas JSON e write_marks_for_substreams_in_compact_parts habilitado).

use_strict_insert_block_limits

Quando ativada, aplica estritamente os limites mínimo e máximo do tamanho do bloco de inserção. Um bloco é emitido quando:
  • Limiares mínimos (AND): Ambos min_insert_block_size_rows AND min_insert_block_size_bytes são atingidos.
  • Limiares máximos (OR): max_insert_block_size_rows OR max_insert_block_size_bytes é atingido.
Quando desativada, um bloco é emitido quando:
  • Limiares mínimos (OR): min_insert_block_size_rows OR min_insert_block_size_bytes é atingido.
Nota: Se as configurações máximas forem menores que as configurações mínimas, os limites máximos têm precedência e os blocos serão emitidos antes que os limiares mínimos sejam atingidos. Nota: Essa configuração é desativada automaticamente para async inserts, porque async inserts anexam tokens de desduplicação por entrada que são incompatíveis com a divisão de blocos necessária para aplicar limites estritos. Desativada por padrão.

use_structure_from_insertion_table_in_table_functions

Usa a estrutura da tabela de inserção em vez da inferência de esquema com base nos dados. Valores possíveis: 0 - desabilitado, 1 - habilitado, 2 - automático

use_uncompressed_cache

Define se deve usar um cache de blocos não comprimidos. Aceita 0 ou 1. O padrão é 0 (desabilitado). Usar o cache não comprimido (apenas para tabelas da família MergeTree) pode reduzir significativamente a latência e aumentar a taxa de transferência ao trabalhar com um grande número de consultas curtas. Habilite essa configuração para usuários que enviam requisições curtas com frequência. Observe também o parâmetro de configuração uncompressed_cache_size (definido apenas no arquivo de configuração) – o tamanho dos blocos do cache não comprimido. Por padrão, ele é de 8 GiB. O cache não comprimido é preenchido conforme necessário, e os dados menos usados são excluídos automaticamente. Para consultas que leem pelo menos um volume de dados razoavelmente grande (um milhão de linhas ou mais), o cache não comprimido é desabilitado automaticamente para economizar espaço para consultas realmente pequenas. Isso significa que você pode manter a configuração use_uncompressed_cache sempre definida como 1.

use_with_fill_by_sorting_prefix

As colunas com WITH FILL que são precedidas por outras colunas na cláusula ORDER BY formam o prefixo de ordenação. As linhas com valores diferentes no prefixo de ordenação são preenchidas independentemente
Última modificação em 24 de julho de 2026