> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# configurações de tabela do MergeTree shared_merge_*

> Configurações de tabela do MergeTree no ClickHouse no grupo gerado shared_merge_*.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["Versão", "Valor padrão", "Comentário"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        Histórico de versões
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Padrão</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Pode ser alterado sem reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Essas configurações estão disponíveis em [system.merge\_tree\_settings](/pt-BR/reference/system-tables/merge_tree_settings) e são geradas automaticamente a partir do código-fonte do ClickHouse.

<div id="shared_merge_tree_activate_coordinated_merges_tasks">
  ## shared\_merge\_tree\_activate\_coordinated\_merges\_tasks
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "0"},{"label": "Novas configurações"}]}, {"id": "row-2","items": [{"label": "25.8"},{"label": "0"},{"label": "Novas configurações"}]}, {"id": "row-3","items": [{"label": "25.7"},{"label": "0"},{"label": "Novas configurações"}]}, {"id": "row-4","items": [{"label": "25.6"},{"label": "0"},{"label": "Novas configurações"}]}, {"id": "row-5","items": [{"label": "25.10"},{"label": "0"},{"label": "Novas 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.

<div id="shared_merge_tree_blobs_list_inline_file_max_bytes">
  ## shared\_merge\_tree\_blobs\_list\_inline\_file\_max\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "0"},{"label": "Nova 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.

<div id="shared_merge_tree_create_per_replica_metadata_nodes">
  ## shared\_merge\_tree\_create\_per\_replica\_metadata\_nodes
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "0"},{"label": "Reduz a quantidade de metadados no Keeper."}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "1"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_disable_merges_and_mutations_assignment">
  ## shared\_merge\_tree\_disable\_merges\_and\_mutations\_assignment
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_empty_partition_lifetime">
  ## shared\_merge\_tree\_empty\_partition\_lifetime
</div>

<SettingsInfoBlock type="Segundos" default_value="86400" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "86400"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_enable_automatic_empty_partitions_cleanup">
  ## shared\_merge\_tree\_enable\_automatic\_empty\_partitions\_cleanup
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.2"},{"label": "1"},{"label": "Habilitado por padrão"}]}, {"id": "row-2","items": [{"label": "25.9"},{"label": "0"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_enable_coordinated_merges">
  ## shared\_merge\_tree\_enable\_coordinated\_merges
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "Ativa merges coordenados por padrão"}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "0"},{"label": "Nova configuração"}]}]} />

Ativa a estratégia de merges coordenados

<div id="shared_merge_tree_enable_keeper_parts_extra_data">
  ## shared\_merge\_tree\_enable\_keeper\_parts\_extra\_data
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "Habilita merge coordenado por padrão"}]}, {"id": "row-2","items": [{"label": "25.3"},{"label": "0"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_enable_outdated_parts_check">
  ## shared\_merge\_tree\_enable\_outdated\_parts\_check
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "Sincronização na Cloud"}]}]} />

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

<div id="shared_merge_tree_idle_parts_update_seconds">
  ## shared\_merge\_tree\_idle\_parts\_update\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="3600" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "3600"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_inactive_replica_cutoff_seconds">
  ## shared\_merge\_tree\_inactive\_replica\_cutoff\_seconds
</div>

<SettingsInfoBlock type="Segundos" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "Nova 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

<div id="shared_merge_tree_initial_parts_update_backoff_ms">
  ## shared\_merge\_tree\_initial\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="50" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "50"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_interserver_http_connection_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_connection\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="100" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "100"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_interserver_http_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10000"},{"label": "Sincronização na Cloud"}]}]} />

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

<div id="shared_merge_tree_leader_update_period_random_add_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_random\_add\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_leader_update_period_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="30" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "30"},{"label": "Sincronização na Cloud"}]}]} />

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

<div id="shared_merge_tree_max_outdated_parts_to_process_at_once">
  ## shared\_merge\_tree\_max\_outdated\_parts\_to\_process\_at\_once
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000"},{"label": "Sincronizaçã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.

<div id="shared_merge_tree_max_parts_update_backoff_ms">
  ## shared\_merge\_tree\_max\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="5000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "5000"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_max_parts_update_leaders_in_total">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_in\_total
</div>

<SettingsInfoBlock type="UInt64" default_value="6" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "6"},{"label": "Sincronização na Cloud"}]}]} />

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

<div id="shared_merge_tree_max_parts_update_leaders_per_az">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_per\_az
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "2"},{"label": "Sincronização na Cloud"}]}]} />

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

<div id="shared_merge_tree_max_replicas_for_parts_deletion">
  ## shared\_merge\_tree\_max\_replicas\_for\_parts\_deletion
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range">
  ## shared\_merge\_tree\_max\_replicas\_to\_merge\_parts\_for\_each\_parts\_range
</div>

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "5"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_max_suspicious_broken_parts">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "0"},{"label": "Nú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.

<div id="shared_merge_tree_max_suspicious_broken_parts_bytes">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "0"},{"label": "Tamanho 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.

<div id="shared_merge_tree_memo_ids_remove_timeout_seconds">
  ## shared\_merge\_tree\_memo\_ids\_remove\_timeout\_seconds
</div>

<SettingsInfoBlock type="Int64" default_value="1800" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1800"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_merge_coordinator_distribution_algorithm">
  ## shared\_merge\_tree\_merge\_coordinator\_distribution\_algorithm
</div>

<SettingsInfoBlock type="MergeCoordinatorDistributionAlgorithm" default_value="sainte_lague" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "sainte_lague"},{"label": "Ativa a distribuição Sainte-Lague por padrão."}]}, {"id": "row-2","items": [{"label": "26.7"},{"label": "water_filling"},{"label": "Nova 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`

<div id="shared_merge_tree_merge_coordinator_election_check_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_election\_check\_period\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="30000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "30000"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_merge_coordinator_factor">
  ## shared\_merge\_tree\_merge\_coordinator\_factor
</div>

<SettingsInfoBlock type="Float" default_value="1.1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1.100000023841858"},{"label": "Nova configuração"}]}, {"id": "row-2","items": [{"label": "25.10"},{"label": "1.100000023841858"},{"label": "Menor tempo de espera do coordenador após carga"}]}]} />

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

<div id="shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_fetch\_fresh\_metadata\_period\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "10000"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_merge_coordinator_max_merge_request_size">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_merge\_request\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="20" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "20"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_merge_coordinator_max_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_period\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "10000"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_merge_coordinator_merges_prepare_count">
  ## shared\_merge\_tree\_merge\_coordinator\_merges\_prepare\_count
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "auto"},{"label": "Definir a configuração como automática: máximo de tarefas de merge por réplica * número de réplicas ativas"}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "100"},{"label": "Nova 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.

<div id="shared_merge_tree_merge_coordinator_min_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_min\_period\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_merge_worker_fast_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_fast\_timeout\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="100" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "100"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_merge_worker_regular_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_regular\_timeout\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "10000"},{"label": "Nova configuração"}]}]} />

Intervalo entre execuções da thread do merge worker

<div id="shared_merge_tree_outdated_parts_group_size">
  ## shared\_merge\_tree\_outdated\_parts\_group\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "2"},{"label": "Nova 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.

<div id="shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations">
  ## shared\_merge\_tree\_partitions\_hint\_ratio\_to\_reload\_merge\_pred\_for\_mutations
</div>

<SettingsInfoBlock type="Float" default_value="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

<div id="shared_merge_tree_parts_load_batch_size">
  ## shared\_merge\_tree\_parts\_load\_batch\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="32" />

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

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Sincronizaçã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.

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_rows\_threshold
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000000"},{"label": "Sincronizaçã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.

<div id="shared_merge_tree_range_for_merge_window_size">
  ## shared\_merge\_tree\_range\_for\_merge\_window\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_read_virtual_parts_from_leader">
  ## shared\_merge\_tree\_read\_virtual\_parts\_from\_leader
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "Sincronização na Cloud"}]}]} />

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

<div id="shared_merge_tree_replica_set_max_lifetime_seconds">
  ## shared\_merge\_tree\_replica\_set\_max\_lifetime\_seconds
</div>

<SettingsInfoBlock type="Segundos" default_value="1800" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "1800"},{"label": "Aumenta o intervalo padrão de atualização em segundo plano do conjunto de réplicas para 30 minutos"}]}, {"id": "row-2","items": [{"label": "26.2"},{"label": "300"},{"label": "Nova 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.

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Nova 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.

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas\_on\_startup
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "Nova 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.

<div id="shared_merge_tree_update_replica_flags_delay_ms">
  ## shared\_merge\_tree\_update\_replica\_flags\_delay\_ms
</div>

<SettingsInfoBlock type="Milissegundos" default_value="30000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "30000"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_use_blobs_list_for_parts">
  ## shared\_merge\_tree\_use\_blobs\_list\_for\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "0"},{"label": "Nova 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.

<div id="shared_merge_tree_use_metadata_hints_cache">
  ## shared\_merge\_tree\_use\_metadata\_hints\_cache
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_use_outdated_parts_compact_format">
  ## shared\_merge\_tree\_use\_outdated\_parts\_compact\_format
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "1"},{"label": "Ativa parte desatualizada v3 por padrão"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "0"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_use_too_many_parts_count_from_virtual_parts">
  ## shared\_merge\_tree\_use\_too\_many\_parts\_count\_from\_virtual\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Sincronizaçã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

<div id="shared_merge_tree_use_zookeeper_connection_pool">
  ## shared\_merge\_tree\_use\_zookeeper\_connection\_pool
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_virtual_parts_discovery_batch">
  ## shared\_merge\_tree\_virtual\_parts\_discovery\_batch
</div>

<SettingsInfoBlock type="UInt64" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1"},{"label": "Nova configuração"}]}]} />

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

<div id="shared_merge_tree_virtual_parts_partition_atomic_discovery">
  ## shared\_merge\_tree\_virtual\_parts\_partition\_atomic\_discovery
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1"},{"label": "Nova configuração"}]}]} />

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