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.

shared_merge_tree_activate_coordinated_merges_tasks

Ativa o reescalonamento das tarefas de merges coordenadas. Isso pode ser útil mesmo quando shared_merge_tree_enable_coordinated_merges=0, pois preencherá as estatísticas do coordenador de merges e ajudará em partidas a frio.

shared_merge_tree_blobs_list_inline_file_max_bytes

Armazena diretamente no arquivo blobs.list consolidado arquivos de uma parte de lista de blobs com, no máximo, esta quantidade de bytes (por exemplo, count.txt, metadata_version.txt, índices minmax), em vez de em um blob separado no armazenamento de objetos, economizando uma gravação e uma leitura de blob para cada arquivo pequeno. 0 desativa o armazenamento inline. Tem efeito apenas para partes que usam o armazenamento de lista de blobs (consulte shared_merge_tree_use_blobs_list_for_parts). Disponível apenas no ClickHouse Cloud.

shared_merge_tree_create_per_replica_metadata_nodes

Habilita a criação de nós /metadata e /columns para cada réplica no ZooKeeper. Disponível apenas no ClickHouse Cloud

shared_merge_tree_disable_merges_and_mutations_assignment

Interrompe a atribuição de merges no shared merge tree. Disponível apenas no ClickHouse Cloud

shared_merge_tree_empty_partition_lifetime

Por quantos segundos a partição ficará armazenada no Keeper se não contiver partes.

shared_merge_tree_enable_automatic_empty_partitions_cleanup

Habilita a limpeza das entradas do Keeper de partições vazias.

shared_merge_tree_enable_coordinated_merges

Ativa a estratégia de merges coordenados

shared_merge_tree_enable_keeper_parts_extra_data

Permite gravar atributos em partes virtuais e fazer o commit de blocos no Keeper

shared_merge_tree_enable_outdated_parts_check

Ativa a verificação de partes desatualizadas. Disponível apenas no ClickHouse Cloud

shared_merge_tree_idle_parts_update_seconds

Intervalo, em segundos, para atualização de partes sem acionamento pelo watch do ZooKeeper na shared merge tree. Disponível apenas no ClickHouse Cloud

shared_merge_tree_inactive_replica_cutoff_seconds

Por quanto tempo uma réplica inativa ainda é considerada pela limpeza em segundo plano (OutdatedPartsQuorumThread): enquanto uma réplica estiver inativa por menos segundos do que esse valor, ela ainda impede a remoção de partes desatualizadas e a truncação de mutações concluídas. Um valor de 0 significa usar o padrão de dois timeouts de sessão do ZooKeeper. Disponível somente no ClickHouse Cloud

shared_merge_tree_initial_parts_update_backoff_ms

Backoff inicial para a atualização das partes. Disponível apenas no ClickHouse Cloud

shared_merge_tree_interserver_http_connection_timeout_ms

Timeouts de conexão HTTP entre servidores. Disponível apenas no ClickHouse Cloud

shared_merge_tree_interserver_http_timeout_ms

Limites de tempo para comunicação HTTP interserver. Disponível apenas no ClickHouse Cloud

shared_merge_tree_leader_update_period_random_add_seconds

Adiciona um valor com distribuição uniforme de 0 a x segundos ao shared_merge_tree_leader_update_period para evitar o efeito thundering herd. Disponível apenas no ClickHouse Cloud

shared_merge_tree_leader_update_period_seconds

Período máximo para verificar novamente a liderança na atualização de partes. Disponível apenas no ClickHouse Cloud

shared_merge_tree_max_outdated_parts_to_process_at_once

Número máximo de partes desatualizadas que o líder tentará confirmar para remoção em uma única requisição HTTP. Disponível apenas no ClickHouse Cloud.

shared_merge_tree_max_parts_update_backoff_ms

Backoff máximo para a atualização de partes. Disponível apenas no ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_in_total

Número máximo total de líderes de atualização de partes. Disponível apenas no ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_per_az

Número máximo de líderes de atualização das partes. Disponível apenas no ClickHouse Cloud

shared_merge_tree_max_replicas_for_parts_deletion

Número máximo de réplicas que participarão da exclusão de partes (killer thread). Disponível apenas no ClickHouse Cloud

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

Número máximo de réplicas que tentarão atribuir merges potencialmente conflitantes (o que permite evitar conflitos redundantes na atribuição de merges). 0 significa desabilitado. Disponível apenas no ClickHouse Cloud

shared_merge_tree_max_suspicious_broken_parts

Número máximo de partes corrompidas para SMT; se houver mais, não permitir a desanexação automática.

shared_merge_tree_max_suspicious_broken_parts_bytes

Tamanho máximo de todas as partes corrompidas para SMT; se for maior, desanexação automática negada.

shared_merge_tree_memo_ids_remove_timeout_seconds

Por quanto tempo armazenamos os IDs de memoização de insert para evitar operações incorretas durante as novas tentativas de insert. Disponível apenas no ClickHouse Cloud

shared_merge_tree_merge_coordinator_distribution_algorithm

O algoritmo usado pela thread do coordenador de merge para distribuir merges entre réplicas. Valores possíveis:
  • water_filling
  • sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

Tempo entre execuções da thread de eleição do coordenador de merge

shared_merge_tree_merge_coordinator_factor

Fator de variação do tempo de atraso da thread do coordenador

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

Com que frequência o coordenador de merge deve sincronizar com o ZooKeeper para obter metadados atualizados

shared_merge_tree_merge_coordinator_max_merge_request_size

Número de merges que o coordenador pode solicitar ao MergerMutator de uma só vez

shared_merge_tree_merge_coordinator_max_period_ms

Intervalo máximo entre execuções da thread do coordenador de merge

shared_merge_tree_merge_coordinator_merges_prepare_count

Número de entradas de merge que o coordenador deve preparar e distribuir pelos workers. Quando definido como ‘auto’, equivale ao número máximo de tarefas de merge permitidas em uma única réplica multiplicado pelo número de réplicas ativas.

shared_merge_tree_merge_coordinator_min_period_ms

Intervalo mínimo entre execuções da thread do coordenador de merge

shared_merge_tree_merge_worker_fast_timeout_ms

Tempo limite usado pela merge worker thread caso seja necessário atualizar seu estado após uma ação imediata

shared_merge_tree_merge_worker_regular_timeout_ms

Intervalo entre execuções da thread do merge worker

shared_merge_tree_outdated_parts_group_size

Número de réplicas que ficarão no mesmo grupo de hash de rendezvous para a limpeza de partes desatualizadas. Disponível apenas no ClickHouse Cloud.

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

Recarregará o predicado de merge na tarefa de seleção de merge/mutação quando a razão <candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> for maior que a configuração. Disponível apenas no ClickHouse Cloud

shared_merge_tree_parts_load_batch_size

Quantidade de jobs de busca de metadados de partes a serem agendados de uma só vez. Disponível apenas no ClickHouse Cloud

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

Tempo para manter uma parte mesclada localmente sem iniciar uma nova mesclagem que a inclua. Isso dá a outras réplicas a chance de buscar a parte e iniciar essa mesclagem. Disponível apenas no ClickHouse Cloud.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

Tamanho mínimo da parte (em linhas) para adiar a atribuição do próximo merge logo após mesclá-la localmente. Disponível apenas no ClickHouse Cloud.

shared_merge_tree_range_for_merge_window_size

Tamanho da janela (em números de blocos) usado para distribuir a atribuição de operações de merge entre as réplicas. As partes dentro da mesma janela são atribuídas às mesmas réplicas. Disponível apenas no ClickHouse Cloud

shared_merge_tree_read_virtual_parts_from_leader

Lê partes virtuais do líder quando possível. Disponível apenas no ClickHouse Cloud

shared_merge_tree_replica_set_max_lifetime_seconds

Com que frequência as réplicas tentarão atualizar o conjunto de réplicas em segundo plano. A próxima execução recebe uma variação aleatória uniforme em [0, value] segundos. Exceção: value = 0 não segue esse comportamento; a implementação aplica um valor mínimo de 200 ms, então a próxima execução recebe uma variação aleatória em [0, 200] ms.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

Se ativado, todas as réplicas tentam buscar de outras réplicas os dados em memória da parte (como chave primária, informações da partição e assim por diante) quando eles já existirem nelas.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

Se ativado, todas as réplicas tentam buscar de outras réplicas, na inicialização, dados em memória da parte (como chave primária, informações da partição e assim por diante) quando eles já existirem nelas.

shared_merge_tree_update_replica_flags_delay_ms

Com que frequência a réplica tentará recarregar suas flags de acordo com o agendamento em segundo plano.

shared_merge_tree_use_blobs_list_for_parts

Armazena partes de uma tabela SharedMergeTree (Wide e Compact) em um único nó consolidado de metadados de lista de blobs, em vez de um nó do Keeper por arquivo. Reduz os metadados do Keeper por parte de O(arquivos) para uma pequena constante, mantendo um blob no armazenamento de objetos por arquivo. Disponível apenas no ClickHouse Cloud.

shared_merge_tree_use_metadata_hints_cache

Habilita a solicitação, em outras réplicas, de indicações do cache de FS a partir do cache em memória. Disponível apenas no ClickHouse Cloud

shared_merge_tree_use_outdated_parts_compact_format

Usa o formato compact para parte desatualizada: reduz a carga sobre o Keeper, melhora o processamento de parte desatualizada. Disponível apenas no ClickHouse Cloud

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

Se habilitado, o contador de excesso de partes usará os dados compartilhados no Keeper, e não o estado local da réplica. Disponível apenas no ClickHouse Cloud

shared_merge_tree_use_zookeeper_connection_pool

Se habilitado, o SharedMergeTree usa uma das sessões do pool de ZooKeeper no nível do servidor.

shared_merge_tree_virtual_parts_discovery_batch

Quantas descobertas de partições devem ser agrupadas em um lote

shared_merge_tree_virtual_parts_partition_atomic_discovery

Configuração obsoleta, não tem efeito.
Última modificação em 26 de agosto de 2026