Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Paramètres de session use_top_k_dynamic_filtering_*

Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.

use_top_k_dynamic_filtering

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
26.51Activer par défaut l’optimisation du filtrage dynamique pour les requêtes TopK
25.120Nouveau paramètre.

Active l’optimisation du filtrage dynamique lors de l’exécution d’une requête ORDER BY <column> LIMIT n.

Lorsqu’elle est activée, le moteur d’exécution de la requête tentera d’ignorer les granules et les lignes qui ne feront pas partie des top N lignes finales du jeu de résultats. Cette optimisation est de nature dynamique, et les améliorations de latence dépendent de la distribution des données et de la présence d’autres prédicats dans la requête.

Valeurs possibles :

  • 0 — Désactivé.
  • 1 — Activé.

use_top_k_dynamic_filtering_for_variable_length_types

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.50Désactive `use_top_k_dynamic_filtering` par défaut pour les colonnes de tri de longueur variable (par ex. `String`) ; le comportement précédent appliquait cette optimisation sans condition et est conservé avec `compatibility`.

Permet à use_top_k_dynamic_filtering de s’appliquer lorsque la colonne de tri utilise un type de données de longueur variable (par ex. String, Array, Map, Tuple contenant des éléments de longueur variable).

Pour ces types, la comparaison du seuil ligne par ligne effectuée par le filtre dynamique peut coûter plus qu’elle ne rapporte lorsque le minimum lexicographique de la colonne prédomine (par ex. des chaînes majoritairement vides) et que peu de granules peuvent être ignorées. Dans ce cas, le filtre dynamique dégrade la latence de la requête au lieu de l’améliorer.

Lorsque ce paramètre vaut 0, le filtrage dynamique est limité aux colonnes dont les valeurs ont une taille maximale fixe en mémoire (nombres, Date, DateTime, FixedString, Enum, Nullable de ces types, Tuple de ces types). Lorsqu’il est défini sur 1, le filtrage dynamique s’applique aussi aux types de longueur variable.

Valeurs possibles :

  • 0 — Désactivé.
  • 1 — Activé.
Navigation