Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

paramètres de session query_cache_*

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

query_cache_compress_entries

Type
Bool
Par défaut
1

Compresse les entrées du cache de requêtes. Réduit la consommation de mémoire du cache de requêtes au prix d’insertions et de lectures plus lentes.

Valeurs possibles :

  • 0 - Désactivé
  • 1 - Activé

query_cache_for_subqueries

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.50Nouveau paramètre permettant d'activer la propagation de `use_query_cache` à toutes les sous-requêtes. Sans cela, les sous-requêtes ne sont mises en cache qu'avec l'activation explicite, sous-requête par sous-requête, via `SETTINGS use_query_cache = true`.

Lorsqu'il est activé, le résultat des sous-requêtes peut être écrit dans le cache de requêtes et lu depuis celui-ci. Cela permet de propager use_query_cache à toutes les sous-requêtes.

Valeurs possibles :

  • 0 - Désactivé
  • 1 - Activé

query_cache_max_entries

Type
UInt64
Par défaut
0

Le nombre maximal de résultats de requête que l’utilisateur courant peut stocker dans le cache de requêtes. 0 signifie qu’il n’y a pas de limite.

Valeurs possibles :

  • Entier positif >= 0.

query_cache_max_size_in_bytes

Type
UInt64
Par défaut
0

Quantité maximale de mémoire (en octets) que l’utilisateur courant peut allouer dans le cache de requêtes. 0 signifie illimité.

Valeurs possibles :

  • Entier >= 0.

query_cache_min_query_duration

Type
Millisecondes
Par défaut
0

Durée minimale, en millisecondes, pendant laquelle une requête doit s'exécuter pour que son résultat soit stocké dans le cache de requêtes.

Valeurs possibles :

  • Entier supérieur ou égal à 0.

query_cache_min_query_runs

Type
UInt64
Par défaut
0

Nombre minimal d’exécutions d’une requête SELECT avant que son résultat soit stocké dans le cache de requêtes.

Valeurs possibles :

  • Entier positif >= 0.

query_cache_nondeterministic_function_handling

Type
QueryResultCacheNondeterministicFunctionHandling
Par défaut
throw

Contrôle la façon dont le cache de requêtes gère les requêtes SELECT comportant des fonctions non déterministes comme rand() ou now().

Valeurs possibles :

  • 'throw' - Lever une exception et ne pas mettre en cache le résultat de la requête.
  • 'save' - Mettre en cache le résultat de la requête.
  • 'ignore' - Ne pas mettre en cache le résultat de la requête et ne pas lever d'exception.

query_cache_share_between_users

Type
Bool
Par défaut
0

Si ce paramètre est activé, le résultat des requêtes SELECT mises en cache dans le cache de requêtes peut être lu par d'autres utilisateurs. Il n'est pas recommandé d'activer ce paramètre pour des raisons de sécurité.

Valeurs possibles :

  • 0 - Désactivé
  • 1 - Activé

query_cache_squash_partial_results

Type
Bool
Par défaut
1

Fusionne les blocs de résultats partiels en blocs de taille max_block_size. Réduit les performances lors des insertions dans le cache de requêtes, mais améliore la compressibilité des entrées du cache (voir query_cache_compress-entries).

Valeurs possibles :

  • 0 - Désactivé
  • 1 - Activé

query_cache_system_table_handling

Type
QueryResultCacheSystemTableHandling
Par défaut
throw
Historique des versions
VersionValeur par défautCommentaire
24.4throwLe cache de requêtes ne met plus en cache les résultats des requêtes effectuées sur les tables système

Contrôle la façon dont le cache de requêtes gère les requêtes SELECT sur les tables système, c.-à-d. les tables des bases de données system.* et information_schema.*.

Valeurs possibles :

  • 'throw' - Déclencher une exception et ne pas mettre en cache le résultat de la requête.
  • 'save' - Mettre en cache le résultat de la requête.
  • 'ignore' - Ne pas mettre en cache le résultat de la requête et ne pas déclencher d’exception.

query_cache_tag

Historique des versions
VersionValeur par défautCommentaire
24.8Nouveau paramètre pour ajouter un libellé aux paramètres du cache de requêtes.

Une chaîne de caractères servant de libellé pour les entrées du cache de requêtes. Des requêtes identiques avec des tags différents sont considérées comme différentes par le cache de requêtes.

Valeurs possibles :

  • Toute chaîne de caractères

query_cache_ttl

Type
Secondes
Par défaut
60

Au bout de ce délai, exprimé en secondes, les entrées du cache de requêtes deviennent obsolètes.

Valeurs possibles :

  • Entier positif >= 0.
Navigation