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

min_absolute_delay_to_close

Atraso absoluto mínimo para encerrar, parar de atender requisições e não retornar Ok durante a verificação de status.

min_columns_to_activate_adaptive_write_buffer

Permite reduzir o uso de memória em tabelas com muitas colunas ao usar buffers de gravação adaptativos. O valor é comparado ao número de streams que uma parte wide grava, que pode exceder significativamente o número de colunas: um Map com muitos buckets ou um Array ou Tuple profundamente aninhado grava muitos streams para uma única coluna, e um buffer de gravação é alocado por stream. Valores possíveis:
  • 0 - desabilitado
  • 1 - sempre habilitado

min_compress_block_size

Tamanho mínimo dos blocos de dados não comprimidos necessário para a compressão ao gravar a próxima mark. Você também pode especificar essa configuração nas configurações globais (consulte a configuração min_compress_block_size ). O valor especificado quando a tabela é criada substitui o valor global dessa configuração.

min_index_granularity_bytes

Tamanho mínimo permitido dos grânulos de dados, em bytes. Serve como proteção contra a criação acidental de tabelas com index_granularity_bytes muito baixo.

min_marks_to_honor_max_concurrent_queries

O número mínimo de marcas lidas pela consulta para que a configuração max_concurrent_queries seja aplicada.
As consultas ainda serão limitadas por outras configurações de max_concurrent_queries.
Valores possíveis:
  • Inteiro positivo.
  • 0 — Desabilitado (o limite de max_concurrent_queries não se aplica a nenhuma consulta).
Exemplo

min_merge_bytes_to_use_direct_io

O volume mínimo de dados da operação de mesclagem necessário para usar acesso de E/S direta ao disco de armazenamento. Ao fazer a mesclagem de partes de dados, o ClickHouse calcula o volume total de armazenamento de todos os dados que serão mesclados. Se o volume exceder min_merge_bytes_to_use_direct_io bytes, o ClickHouse lê e grava os dados no disco de armazenamento usando a interface de E/S direta (opção O_DIRECT). Se min_merge_bytes_to_use_direct_io = 0, a E/S direta será desabilitada.

min_partition_age_to_force_merge_seconds

Faz o merge das partes de uma partição quando todas elas forem mais antigas que este valor, ou seja, quando a partição não recebe mais inserts. Diferentemente de min_age_to_force_merge_seconds com min_age_to_force_merge_on_partition_only, a partição não precisa caber em um único merge: cada merge continua respeitando max_bytes_to_merge_at_max_space_in_pool. Funciona com os selectors de mesclagem Simple e StochasticSimple. A idade comparada aqui é a da parte mais nova da partição (now - modification_time, minimizada entre suas partes), de modo que a regra só é armada depois que todas as partes ultrapassam esse valor de idade. Qualquer parte nova a redefine: um insert, uma mutation e também cada merge que a própria configuração atribui, já que a parte resultante do merge é nova. Portanto, o forçamento é desarmado assim que um merge forçado é concluído e só é rearmado depois que esse valor decorre novamente sem novas partes, de modo que uma partição que precisa de vários merges é compactada em rodadas sucessivas espaçadas por esse intervalo, e não em uma única passagem contínua. O forçamento funciona exatamente como min_age_to_force_merge_seconds: ele dispensa a exigência de proporção de tamanho que normalmente impede a atribuição de um merge desbalanceado e também dispensa o piso min_parts_to_merge_at_once, de modo que um merge forçado pode abranger menos partes do que esse piso exige. Nenhuma outra heurística é desativada: merge_selector_window_size continua limitando quais partes são examinadas, e merge_selector_enable_heuristic_to_remove_small_parts_at_right continua removendo uma parte pequena ao final de um intervalo selecionado de três partes ou mais. Qualquer uma delas que precise ser desativada para um determinado workload deve ser desativada explicitamente por meio de sua própria configuração. Com os selectors de mesclagem Simple e StochasticSimple, esta configuração não pode ser combinada com min_age_to_force_merge_seconds em conjunto com min_age_to_force_merge_on_partition_only. Esse par faz o merge de uma partição inteira de uma só vez, e somente um merge desse tipo é marcado como final — é justamente isso que permite a um ReplacingMergeTree executar CLEANUP; forçar merges regulares pela idade da partição o impediria. Use o par para partições que cabem em um único merge e esta configuração para as que não cabem. Os demais selectors ignoram esta configuração, portanto a combinação é aceita com eles. Valores possíveis:
  • Inteiro positivo.

min_parts_to_merge_at_once

Quantidade mínima de partes de dados que o selector de mesclagem pode selecionar para mesclar de uma só vez (configuração de nível avançado; não altere se você não entende o que ela faz). 0 - desabilitado. Funciona para os selectors de mesclagem Simple e StochasticSimple.

min_replicated_logs_to_keep

Mantém aproximadamente esse número dos registros mais recentes no log do ZooKeeper, mesmo que estejam obsoletos. Isso não afeta o funcionamento das tabelas: é usado apenas para diagnosticar o log do ZooKeeper antes da limpeza. Valores possíveis:
  • Qualquer inteiro positivo.
Última modificação em 26 de setembro de 2026