> ## 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.

# paramètres de session query_cache_*

> Paramètres de session ClickHouse du groupe généré query_cache_*.

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
  }}>Type</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Par défaut</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Modifiable sans redémarrage
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Ces paramètres sont disponibles dans [system.settings](/docs/fr/reference/system-tables/settings) et sont générés automatiquement à partir du [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="query_cache_compress_entries">
  ## query\_cache\_compress\_entries
</div>

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

Compresse les entrées du [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache). 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é

<div id="query_cache_for_subqueries">
  ## query\_cache\_for\_subqueries
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "Nouveau 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](/docs/fr/concepts/features/performance/caches/query-cache) et lu depuis celui-ci. Cela permet de propager `use_query_cache` à toutes les sous-requêtes.

Valeurs possibles :

* 0 - Désactivé
* 1 - Activé

<div id="query_cache_max_entries">
  ## query\_cache\_max\_entries
</div>

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

Le nombre maximal de résultats de requête que l’utilisateur courant peut stocker dans le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache). 0 signifie qu’il n’y a pas de limite.

Valeurs possibles :

* Entier positif >= 0.

<div id="query_cache_max_size_in_bytes">
  ## query\_cache\_max\_size\_in\_bytes
</div>

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

Quantité maximale de mémoire (en octets) que l’utilisateur courant peut allouer dans le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache). 0 signifie illimité.

Valeurs possibles :

* Entier >= 0.

<div id="query_cache_min_query_duration">
  ## query\_cache\_min\_query\_duration
</div>

<SettingsInfoBlock type="Millisecondes" default_value="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](/docs/fr/concepts/features/performance/caches/query-cache).

Valeurs possibles :

* Entier supérieur ou égal à 0.

<div id="query_cache_min_query_runs">
  ## query\_cache\_min\_query\_runs
</div>

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

Nombre minimal d’exécutions d’une requête `SELECT` avant que son résultat soit stocké dans le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache).

Valeurs possibles :

* Entier positif >= 0.

<div id="query_cache_nondeterministic_function_handling">
  ## query\_cache\_nondeterministic\_function\_handling
</div>

<SettingsInfoBlock type="QueryResultCacheNondeterministicFunctionHandling" default_value="throw" />

Contrôle la façon dont le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache) 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.

<div id="query_cache_share_between_users">
  ## query\_cache\_share\_between\_users
</div>

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

Si ce paramètre est activé, le résultat des requêtes `SELECT` mises en cache dans le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache) 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é

<div id="query_cache_squash_partial_results">
  ## query\_cache\_squash\_partial\_results
</div>

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

Fusionne les blocs de résultats partiels en blocs de taille [max\_block\_size](/docs/fr/reference/settings/session-settings/max#max_block_size). Réduit les performances lors des insertions dans le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache), mais améliore la compressibilité des entrées du cache (voir [query\_cache\_compress-entries](/docs/fr/reference/settings/session-settings/query-cache#query_cache_compress_entries)).

Valeurs possibles :

* 0 - Désactivé
* 1 - Activé

<div id="query_cache_system_table_handling">
  ## query\_cache\_system\_table\_handling
</div>

<SettingsInfoBlock type="QueryResultCacheSystemTableHandling" default_value="throw" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.4"},{"label": "throw"},{"label": "Le 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](/docs/fr/concepts/features/performance/caches/query-cache) 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.

<div id="query_cache_tag">
  ## query\_cache\_tag
</div>

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.8"},{"label": ""},{"label": "Nouveau 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](/docs/fr/concepts/features/performance/caches/query-cache).
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

<div id="query_cache_ttl">
  ## query\_cache\_ttl
</div>

<SettingsInfoBlock type="Secondes" default_value="60" />

Au bout de ce délai, exprimé en secondes, les entrées du [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache) deviennent obsolètes.

Valeurs possibles :

* Entier positif >= 0.