Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de tabela do MergeTree shared_merge_*

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.90Novas configurações
25.80Novas configurações
25.70Novas configurações
25.60Novas configurações
25.100Novas configurações

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

Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.90Nova configuração que armazena inline no blobs.list consolidado arquivos pequenos de uma parte de lista de blobs, em vez de blobs separados

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.110Reduz a quantidade de metadados no Keeper.
25.11Sincronização na Cloud

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

Tipo
Bool
Padrão
0

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

shared_merge_tree_empty_partition_lifetime

Tipo
Segundos
Padrão
86400
Histórico de versões
VersãoValor padrãoComentário
25.986400Nova configuração

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

shared_merge_tree_enable_automatic_empty_partitions_cleanup

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.21Habilitado por padrão
25.90Nova configuração

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

shared_merge_tree_enable_coordinated_merges

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.61Ativa merges coordenados por padrão
25.50Nova configuração

Ativa a estratégia de merges coordenados

shared_merge_tree_enable_keeper_parts_extra_data

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.61Habilita merge coordenado por padrão
25.30Nova configuração

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

shared_merge_tree_enable_outdated_parts_check

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.11Sincronização na Cloud

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

shared_merge_tree_idle_parts_update_seconds

Tipo
UInt64
Padrão
3600
Histórico de versões
VersãoValor padrãoComentário
25.13600Sincronização na Cloud

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

Tipo
Segundos
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.60Nova configuração que controla por quanto tempo uma réplica inativa é considerada pela limpeza em segundo plano (0 significa dois timeouts de sessão do ZooKeeper)

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

Tipo
UInt64
Padrão
50
Histórico de versões
VersãoValor padrãoComentário
25.250Nova configuração

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

shared_merge_tree_interserver_http_connection_timeout_ms

Tipo
UInt64
Padrão
100
Histórico de versões
VersãoValor padrãoComentário
25.2100Nova configuração

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

shared_merge_tree_interserver_http_timeout_ms

Tipo
UInt64
Padrão
10000
Histórico de versões
VersãoValor padrãoComentário
25.110000Sincronização na Cloud

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

shared_merge_tree_leader_update_period_random_add_seconds

Tipo
UInt64
Padrão
10
Histórico de versões
VersãoValor padrãoComentário
25.110Sincronização na Cloud

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

Tipo
UInt64
Padrão
30
Histórico de versões
VersãoValor padrãoComentário
25.130Sincronização na Cloud

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

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
25.11000Sincronização na Cloud

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

Tipo
UInt64
Padrão
5000
Histórico de versões
VersãoValor padrãoComentário
25.25000Nova configuração

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

shared_merge_tree_max_parts_update_leaders_in_total

Tipo
UInt64
Padrão
6
Histórico de versões
VersãoValor padrãoComentário
25.16Sincronização na Cloud

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

Tipo
UInt64
Padrão
2
Histórico de versões
VersãoValor padrãoComentário
25.12Sincronização na Cloud

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

Tipo
UInt64
Padrão
10
Histórico de versões
VersãoValor padrãoComentário
25.110Sincronização na Cloud

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

Tipo
UInt64
Padrão
5
Histórico de versões
VersãoValor padrãoComentário
25.15Sincronização na Cloud

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

Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.20Número máximo de partes corrompidas para SMT; se houver mais, não permitir a desanexação automática

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

Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.20Tamanho máximo de todas as partes corrompidas para SMT; se for maior, desanexação automática negada

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

Tipo
Int64
Padrão
1800
Histórico de versões
VersãoValor padrãoComentário
25.11800Sincronização na Cloud

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

Tipo
MergeCoordinatorDistributionAlgorithm
Padrão
sainte_lague
Histórico de versões
VersãoValor padrãoComentário
26.8sainte_lagueAtiva a distribuição Sainte-Lague por padrão.
26.7water_fillingNova configuração que controla qual algoritmo é usado pelo coordenador de merge para distribuir merges entre réplicas

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

Tipo
Milissegundos
Padrão
30000
Histórico de versões
VersãoValor padrãoComentário
25.530000Nova configuração

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

shared_merge_tree_merge_coordinator_factor

Tipo
Float
Padrão
1.1
Histórico de versões
VersãoValor padrãoComentário
25.51.100000023841858Nova configuração
25.101.100000023841858Menor tempo de espera do coordenador após carga

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

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

Tipo
Milissegundos
Padrão
10000
Histórico de versões
VersãoValor padrãoComentário
25.510000Nova configuração

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

Tipo
UInt64
Padrão
20
Histórico de versões
VersãoValor padrãoComentário
25.520Nova configuração

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

shared_merge_tree_merge_coordinator_max_period_ms

Tipo
Milissegundos
Padrão
10000
Histórico de versões
VersãoValor padrãoComentário
25.510000Nova configuração

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

shared_merge_tree_merge_coordinator_merges_prepare_count

Tipo
UInt64Auto
Padrão
auto
Histórico de versões
VersãoValor padrãoComentário
26.4autoDefinir a configuração como automática: máximo de tarefas de merge por réplica * número de réplicas ativas
25.5100Nova configuração

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

Tipo
Milissegundos
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.51Nova configuração

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

shared_merge_tree_merge_worker_fast_timeout_ms

Tipo
Milissegundos
Padrão
100
Histórico de versões
VersãoValor padrãoComentário
25.5100Nova configuração

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

Tipo
Milissegundos
Padrão
10000
Histórico de versões
VersãoValor padrãoComentário
25.510000Nova configuração

Intervalo entre execuções da thread do merge worker

shared_merge_tree_outdated_parts_group_size

Tipo
UInt64
Padrão
2
Histórico de versões
VersãoValor padrãoComentário
25.92Nova configuração

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

Tipo
Float
Padrão
0.5

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

Tipo
UInt64
Padrão
32

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

Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.10Sincronização na Cloud

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

Tipo
UInt64
Padrão
1000000
Histórico de versões
VersãoValor padrãoComentário
25.11000000Sincronização na Cloud

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

Tipo
UInt64
Padrão
10
Histórico de versões
VersãoValor padrãoComentário
25.110Sincronização na Cloud

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

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.11Sincronização na Cloud

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

shared_merge_tree_replica_set_max_lifetime_seconds

Tipo
Segundos
Padrão
1800
Histórico de versões
VersãoValor padrãoComentário
26.41800Aumenta o intervalo padrão de atualização em segundo plano do conjunto de réplicas para 30 minutos
26.2300Nova configuração

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.10Nova configuração para buscar dados em memória de partes de outras réplicas

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.60Nova configuração que permite ao SMT baixar os dados das partes das réplicas em vez do S3 durante a inicialização

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

Tipo
Milissegundos
Padrão
30000
Histórico de versões
VersãoValor padrãoComentário
25.830000Nova configuração

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.90Nova configuração que armazena o mapa de blobs por arquivo de uma parte do SharedMergeTree em um único nó consolidado do Keeper, em vez de um nó por arquivo

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

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.11Sincronização na Cloud

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

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.91Ativa parte desatualizada v3 por padrão
25.10Sincronização na Cloud

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.10Sincronização na Cloud

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

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.30Nova configuração

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

Tipo
UInt64
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.81Nova configuração

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

shared_merge_tree_virtual_parts_partition_atomic_discovery

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.71Nova configuração

Configuração obsoleta, não tem efeito.

Navigation