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 tabelafile/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_columns_cache
Define se o cache de colunas deve ser usado. Aceita 0 ou 1. O valor padrão é 0 (desabilitado). O cache de colunas armazena colunas desserializadas de tabelasMergeTree, evitando repetir a descompressão e a desserialização de dados acessados com frequência. Isso pode reduzir significativamente a latência de consultas repetidas sobre os mesmos dados. O cache é indexado pelo UUID da tabela, pelo nome da parte de dados, pelo nome da coluna e por um segmento de grânulos consecutivos com cerca de 65536 linhas.
Como as entradas são indexadas pelo UUID da tabela, o cache só fica ativo para tabelas em bancos de dados que atribuem UUIDs, como Atomic, Replicated e Shared (o motor de banco de dados padrão no ClickHouse Cloud); tabelas MergeTree em bancos de dados legados Ordinary têm um UUID nulo e ignoram essa configuração sem emitir avisos.
Atualmente, o cache se aplica apenas a partes no formato wide: os dados em partes compactas não são lidos do cache de colunas nem gravados nele. Portanto, a aceleração de uma leitura depende do formato da parte.
Uma entrada contém um intervalo contíguo de grânulos de um único segmento: um grânulo só entra no cache depois de ter sido lido da primeira à última linha; as leituras são atendidas pelo cache grânulo por grânulo; e os intervalos gravados por leituras diferentes são mesclados. Assim, leituras que dividem uma parte em diferentes intervalos de marcas compartilham as entradas.
use_concurrency_control
Respeita o controle de concorrência do servidor (consulte as configurações globais do servidorconcurrent_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, comPARTITION BY a e ORDER BY b:
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çõesuse_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 dehedged_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_indexes_refiner_in_read_pools
Aplica, nos próprios pools de leitura MergeTree, índices avaliados no momento da leitura de dados: intervalos de marcas totalmente filtrados por skip indexes (consulteuse_skip_indexes_on_data_read) ou pelo índice de projeção (consulte optimize_use_projection_filtering) são descartados antes da criação de uma tarefa de leitura, em vez de serem ignorados grânulo a grânulo durante a leitura.
No pool de leitura com pré-busca, os intervalos descartados nunca são pré-carregados, mas os limites das tarefas e a admissão para pré-busca por filesystem_prefetch_max_memory_usage / filesystem_prefetches_limit ainda são definidos antes da filtragem. Portanto, com filtros altamente seletivos, as tarefas restantes podem ser menores que o tamanho de tarefa pretendido, e a admissão pode ser conservadora.
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, o nometoTime refere-se à função toTime legada,
que converte uma data com hora em uma determinada data fixa, preservando a hora.
Caso contrário, o nome refere-se à nova função toTime,
que converte valores de diferentes tipos para o tipo Time.
A função legada também fica sempre acessível como toTimeWithFixedDate, independentemente desta configuração.
Enquanto esta configuração estiver habilitada, use CAST(x AS Time) ou x::Time para converter para o tipo Time.
use_lightweight_primary_key_index_analysis
Otimiza a análise do índice da chave primária para tabelasMergeTree 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 pipelineReaderExecutor 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 ewrite_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.
- Limiares mínimos (OR): min_insert_block_size_rows OR min_insert_block_size_bytes é atingido.
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áticouse_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çãouse_uncompressed_cache sempre definida como 1.