Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de tabela do MergeTree allow_*

Essas configurações estão disponíveis em system.merge_tree_settings e são geradas automaticamente com base no código-fonte do ClickHouse.

allow_coalescing_columns_in_partition_or_order_key

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.60Nova configuração para permitir que colunas de partição ou da chave de ordenação sejam colunas de coalescência.

Quando habilitada, permite que colunas de coalescência em uma tabela CoalescingMergeTree sejam usadas na partição ou na chave de ordenação.

allow_commit_order_projection

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

Habilita projeções com ordem de commit que armazenam as colunas virtuais _block_number e _block_offset, preservando a ordem original de inserção durante as mesclagens. Requer que enable_block_number_column e enable_block_offset_column estejam habilitados.

allow_dimensions_outside_sorting_key

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.70O AggregatingMergeTree agora rejeita, na criação da tabela, schemas em que uma coluna não faz parte da chave de ordenação nem é uma medida de estado de agregação; anteriormente, esses schemas eram aceitos (o comportamento antigo corresponde ao valor 'true').

No AggregatingMergeTree, as mesclagens em segundo plano colapsam linhas que compartilham o mesmo valor da chave de ordenação, combinando seus estados de agregação. Uma coluna que não faz parte da chave de ordenação nem é uma medida de estado de agregação (AggregateFunction ou SimpleAggregateFunction) é uma dimensão: após uma mesclagem, ela mantém um valor arbitrário de uma das linhas colapsadas, o que produz, silenciosamente, resultados incorretos em consultas que usam GROUP BY ou aplicam filtros sobre ela (consulte https://github.com/ClickHouse/ClickHouse/issues/751).

Por padrão, esse schema é rejeitado quando a tabela é criada. Habilite essa configuração se a coluna tiver dependência funcional da chave de ordenação (de modo que todas as linhas colapsadas compartilhem o mesmo valor) e esse comportamento for intencional.

A verificação se aplica apenas a tabelas que de fato fazem agregação (aquelas com pelo menos uma coluna de estado de agregação) e é ignorada quando allow_tuple_element_aggregation está habilitado.

allow_floating_point_partition_key

Tipo
Bool
Padrão
0

Permite o uso de número de ponto flutuante como chave de partição.

Valores possíveis:

  • 0 — Chave de partição com ponto flutuante não permitida.
  • 1 — Chave de partição com ponto flutuante permitida.

allow_minmax_index_for_json

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.70Proíbe por padrão a criação de índice skip minmax em colunas JSON, porque a serialização do índice não consegue lidar com valores heterogêneos de Field

Permite criar índices skip minmax em colunas JSON (Object). Desabilitado por padrão porque o caminho de serialização do índice minmax não consegue lidar com valores heterogêneos de Field que colunas JSON podem conter.

allow_nullable_key

Tipo
Bool
Padrão
0

Permite tipos Nullable como chaves primárias.

allow_part_offset_column_in_projections

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.81Agora, as projeções podem usar a coluna _part_offset.
25.50Nova configuração; protege contra a criação de projeções com a coluna _part_offset da part pai até que esse recurso seja estabilizado.

Permite o uso da coluna '_part_offset' na consulta SELECT das projeções.

allow_reduce_blocking_parts_task

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.21Agora, o SMT removerá partes bloqueadoras obsoletas do ZooKeeper por padrão
25.10Cloud sync

Tarefa em segundo plano que reduz partes bloqueadoras em tabelas shared merge tree. Disponível somente no ClickHouse Cloud

allow_remote_fs_zero_copy_replication

Recurso experimental
Tipo
Bool
Padrão
0

Não use esta configuração em produção, pois ela ainda não está pronta.

allow_summing_columns_in_partition_or_order_key

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.40Nova configuração para permitir o uso de colunas de soma na partição ou na chave de ordenação

Quando ativado, permite que colunas de soma em uma tabela SummingMergeTree sejam usadas na partição ou na chave de ordenação.

allow_suspicious_indices

Tipo
Bool
Padrão
0

Rejeita índices primários/secundários e chaves de ordenação com expressões idênticas

allow_tuple_element_aggregation

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

Quando ativado, elementos individuais dentro de colunas Tuple participam da agregação durante a mesclagem no SummingMergeTree, AggregatingMergeTree e CoalescingMergeTree. Tuples aninhadas são expandidas recursivamente para que todos os elementos terminais sejam agregados de forma independente. Essa configuração é imutável e deve ser especificada no momento da criação da tabela.

allow_vertical_merges_from_compact_to_wide_parts

Tipo
Bool
Padrão
1

Permite mesclagens verticais de partes compact para partes wide. Esta configuração deve ter o mesmo valor em todas as réplicas.

Navigation