Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão use_top_k_dynamic_filtering_*

Essas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

use_top_k_dynamic_filtering

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.51Ativa a otimização de filtragem dinâmica para consultas TopK por padrão
25.120Nova configuração.

Ativa a otimização de filtragem dinâmica ao executar uma consulta ORDER BY <column> LIMIT n.

Quando ativada, o executor da consulta tentará ignorar grânulos e linhas que não farão parte das top N linhas do resultado final. Essa otimização é inerentemente dinâmica, e os ganhos de latência dependem da distribuição dos dados e da presença de outros predicados na consulta.

Valores possíveis:

  • 0 — Desativado.
  • 1 — Ativado.

use_top_k_dynamic_filtering_for_variable_length_types

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.50Desabilita `use_top_k_dynamic_filtering` por padrão para colunas de ordenação de comprimento variável (por exemplo, `String`); o comportamento anterior, em que a otimização era aplicada incondicionalmente, é preservado em `compatibility`.

Permite que use_top_k_dynamic_filtering seja aplicado quando a coluna de ordenação tem um tipo de dado de comprimento variável (por exemplo, String, Array, Map, Tuple contendo elementos de comprimento variável).

Para esses tipos, a comparação de limiar por linha feita pelo filtro dinâmico pode custar mais do que a economia obtida quando o mínimo lexicográfico da coluna predomina (por exemplo, strings majoritariamente vazias) e poucos grânulos podem ser ignorados. Nesse caso, o filtro dinâmico piora a latência da consulta em vez de melhorá-la.

Quando essa configuração é 0, a filtragem dinâmica fica restrita a colunas cujos valores têm um tamanho máximo fixo na memória (números, Date, DateTime, FixedString, Enum, Nullable desses tipos, Tuple desses tipos). Quando definida como 1, a filtragem dinâmica também se aplica a tipos de comprimento variável.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.
Navigation