> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# configurações de sessão use_top_k_dynamic_filtering_*

> Configurações de sessão do ClickHouse no grupo gerado use_top_k_dynamic_filtering_*.

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.settings](/docs/pt-BR/reference/system-tables/settings) e são geradas automaticamente a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="use_top_k_dynamic_filtering">
  ## use\_top\_k\_dynamic\_filtering
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "1"},{"label": "Ativa a otimização de filtragem dinâmica para consultas TopK por padrão"}]}, {"id": "row-2","items": [{"label": "25.12"},{"label": "0"},{"label": "Nova 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.

<div id="use_top_k_dynamic_filtering_for_variable_length_types">
  ## use\_top\_k\_dynamic\_filtering\_for\_variable\_length\_types
</div>

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

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