> ## 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 enable_*
> Paramètres de session ClickHouse du groupe généré enable_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Type
{type}
Par défaut
{default_value}
{changeable_without_restart &&
Modifiable sans redémarrage
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const ExperimentalBadge = () => {
return ;
};
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).
## enable\_adaptive\_memory\_spill\_scheduler
Déclenche le processeur pour déverser de manière adaptative les données vers un stockage externe. Seul grace join est actuellement pris en charge.
## enable\_add\_distinct\_to\_in\_subqueries
Active `DISTINCT` dans les sous-requêtes `IN`. Ce paramètre implique un compromis : son activation peut réduire considérablement la taille des tables temporaires transférées pour les sous-requêtes `IN` distribuées et accélérer nettement le transfert de données entre les shards, en garantissant que seules des valeurs uniques sont envoyées.
Cependant, l’activation de ce paramètre ajoute des opérations de fusion supplémentaires sur chaque nœud, car la déduplication (`DISTINCT`) doit être effectuée. Utilisez ce paramètre lorsque le transfert réseau constitue un goulot d’étranglement et que le coût supplémentaire de fusion est acceptable.
## enable\_automatic\_decision\_for\_merging\_across\_partitions\_for\_final
Si ce paramètre est activé, ClickHouse activera automatiquement cette optimisation lorsque l'expression de la clé de partition est déterministe et que toutes les colonnes utilisées dans cette expression sont incluses dans la clé primaire.
Cette déduction automatique garantit que les lignes ayant les mêmes valeurs de clé primaire appartiendront toujours à la même partition, ce qui permet d'éviter en toute sécurité les fusions entre partitions.
## enable\_early\_constant\_folding
Active une optimisation de requête qui analyse les résultats des fonctions et des sous-requêtes, puis réécrit la requête si elle contient des constantes
## enable\_extended\_results\_for\_datetime\_functions
Active ou désactive le renvoi de résultats de type `Date32` avec une plage étendue (par rapport au type `Date`)
ou de type `DateTime64` avec une plage étendue (par rapport au type `DateTime`).
Valeurs possibles :
* `0` — Les fonctions renvoient `Date` ou `DateTime` pour tous les types d'arguments.
* `1` — Les fonctions renvoient `Date32` ou `DateTime64` pour les arguments `Date32` ou `DateTime64`, et `Date` ou `DateTime` dans les autres cas.
Le tableau ci-dessous montre le comportement de ce paramètre pour différentes fonctions de date et heure.
| Function | `enable_extended_results_for_datetime_functions = 0` | `enable_extended_results_for_datetime_functions = 1` |
| ------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `toStartOfYear` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée `Date32`/`DateTime64` |
| `toStartOfISOYear` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toStartOfQuarter` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée `Date32`/`DateTime64` |
| `toStartOfMonth` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toStartOfWeek` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toLastDayOfWeek` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une valeur d’entrée `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une valeur d’entrée `Date32`/`DateTime64` |
| `toLastDayOfMonth` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toMonday` | Renvoie `Date` ou `DateTime` | Renvoie `Date`/`DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `Date32`/`DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toStartOfDay` | Renvoie `DateTime`
*Remarque : résultats erronés pour les valeurs hors de la plage 1970-2149* | Renvoie `DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toStartOfHour` | Renvoie `DateTime`
*Remarque : résultats incorrects pour les valeurs en dehors de la plage 1970-2149* | Renvoie `DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toStartOfFifteenMinutes` | Renvoie `DateTime`
*Remarque : résultats incorrects pour les valeurs hors de la plage 1970-2149* | Renvoie `DateTime` pour une entrée en `Date`/`DateTime`
Renvoie `DateTime64` pour une entrée en `Date32`/`DateTime64` |
| `toStartOfTenMinutes` | Renvoie `DateTime`
*Remarque : résultats incorrects pour les valeurs en dehors de la plage 1970-2149* | Renvoie `DateTime` pour une entrée de type `Date`/`DateTime`
Renvoie `DateTime64` pour une entrée de type `Date32`/`DateTime64` |
| `toStartOfFiveMinutes` | Renvoie `DateTime`
*Remarque : résultats incorrects pour des valeurs en dehors de la plage 1970-2149* | Renvoie `DateTime` pour une valeur d’entrée de type `Date`/`DateTime`
Renvoie `DateTime64` pour une valeur d’entrée de type `Date32`/`DateTime64` |
| `toStartOfMinute` | Renvoie `DateTime`
*Remarque : résultats incorrects pour les valeurs hors de la plage 1970-2149* | Renvoie `DateTime` pour une entrée `Date`/`DateTime`
Renvoie `DateTime64` pour une entrée `Date32`/`DateTime64` |
| `timeSlot` | Renvoie `DateTime`
*Remarque : résultats incorrects pour les valeurs hors de la plage 1970-2149* | Renvoie `DateTime` pour un argument `Date`/`DateTime`
Renvoie `DateTime64` pour un argument `Date32`/`DateTime64` |
## enable\_full\_text\_index
**Alias** : `allow_experimental_full_text_index`
Si cette option est définie sur true, l’utilisation de l’index de texte est autorisée.
## enable\_global\_with\_statement
Propage les instructions WITH aux requêtes UNION et à toutes les sous-requêtes
## enable\_hdfs\_pread
Active ou désactive `pread` pour les fichiers HDFS. Par défaut, `hdfsPread` est utilisé. S'il est désactivé, `hdfsRead` et `hdfsSeek` sont utilisés pour lire les fichiers HDFS.
## enable\_http\_compression
Active ou désactive la compression des données dans la réponse à une requête HTTP.
Pour plus d'informations, consultez la [description de l'interface HTTP](/docs/fr/concepts/features/interfaces/http).
Valeurs possibles :
* 0 — Désactivé.
* 1 — Activé.
## enable\_identifier\_resolve\_cache
Active le cache de résolution des identifiants dans l’analyseur de requêtes. Le cache partage les nœuds d’alias résolus afin d’éviter une explosion de l’AST lorsque le même alias est utilisé plusieurs fois. Définissez-la sur false pour désactiver la mise en cache si vous suspectez des résultats incorrects.
## enable\_job\_stack\_trace
Affiche la trace de pile du créateur du job lorsque celui-ci entraîne une exception. Désactivé par défaut afin d’éviter toute surcharge de performances.
## enable\_lazy\_columns\_replication
Active la réplication différée des colonnes dans JOIN et ARRAY JOIN. Cela permet d'éviter de copier inutilement plusieurs fois les mêmes lignes en mémoire.
## enable\_materialized\_cte
Active les expressions de table communes matérialisées ; ce paramètre est prioritaire sur enable\_global\_with\_statement
## enable\_memory\_bound\_merging\_of\_aggregation\_results
Active la stratégie de fusion des résultats d’agrégation limitée par la mémoire.
## enable\_multiple\_prewhere\_read\_steps
Déplace davantage de conditions de WHERE vers PREWHERE, et effectue les lectures sur disque ainsi que le filtrage en plusieurs étapes s’il y a plusieurs conditions combinées avec AND
## enable\_named\_columns\_in\_function\_tuple
Génère des tuples nommés dans la fonction tuple() lorsque tous les noms sont uniques et peuvent être considérés comme des identifiants non quotés.
## enable\_order\_by\_all
Active ou désactive le tri à l’aide de la syntaxe `ORDER BY ALL`, voir [ORDER BY](/docs/fr/reference/statements/select/order-by).
Valeurs possibles :
* 0 — Désactive `ORDER BY ALL`.
* 1 — Active `ORDER BY ALL`.
**Exemple**
Requête :
```sql theme={null}
CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();
INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);
SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous
SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;
```
Résultat :
```text theme={null}
┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │ 10 │
│ 30 │ 10 │ 20 │
│ 10 │ 20 │ 30 │
└────┴────┴─────┘
```
## enable\_parallel\_blocks\_marshalling
Affecte uniquement les requêtes distribuées. Si cette option est activée, les blocs seront (dé)sérialisés et (dé)compressés sur les threads de pipeline (c.-à-d. avec un parallélisme plus élevé que par défaut) avant/après leur envoi à l’initiateur.
## enable\_parsing\_to\_custom\_serialization
Si la valeur est true, les données peuvent être analysées directement dans des colonnes avec une sérialisation personnalisée (par ex. Sparse), selon les indications de sérialisation obtenues depuis la table.
## enable\_producing\_buckets\_out\_of\_order\_in\_aggregation
Permet à l'agrégation économe en mémoire (voir `distributed_aggregation_memory_efficient`) de produire des buckets dans le désordre.
Cela peut améliorer les performances lorsque la taille des buckets d'agrégation est inégale, en permettant à une réplique d'envoyer à l'initiateur des buckets dont les ID sont plus élevés alors qu'elle traite encore des buckets volumineux avec des ID plus faibles.
L'inconvénient est une consommation de mémoire potentiellement plus élevée.
## enable\_reads\_from\_query\_cache
Si cette option est activée, les résultats des requêtes `SELECT` sont lus depuis le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache).
Valeurs possibles :
* 0 - Désactivé
* 1 - Activé
## enable\_s3\_requests\_logging
Active une journalisation très détaillée des requêtes S3. À utiliser uniquement pour le débogage.
## enable\_scalar\_subquery\_optimization
Si ce paramètre est défini sur true, il empêche les sous-requêtes scalaires de (dé)sérialiser de grandes valeurs scalaires et peut éviter d’exécuter la même sous-requête plusieurs fois.
## enable\_scopes\_for\_with\_statement
Si cette option est désactivée, les déclarations dans les clauses WITH parentes auront la même portée que si elles étaient déclarées dans la portée actuelle.
Notez qu’il s’agit d’un paramètre de compatibilité de l’analyseur permettant d’exécuter certaines requêtes non valides que l’ancien analyseur pouvait exécuter.
## enable\_sharding\_aggregator
Active l’optimisation de `GROUP BY` partitionnée, qui répartit les lignes entre les threads en hachant la clé de regroupement, de sorte que chaque thread agrège un sous-ensemble distinct de clés sans phase de fusion.
Cette approche est efficace pour les clés à forte cardinalité lorsque les données sont réparties uniformément, mais peut être moins performante en cas de distribution très déséquilibrée des clés ou de requêtes comportant très peu de clés distinctes.
Valeurs possibles :
* 0 — L’optimisation d’agrégation partitionnée est désactivée.
* 1 — L’optimisation d’agrégation partitionnée est activée.
## enable\_shared\_storage\_snapshot\_in\_query
Si cette option est activée, toutes les sous-requêtes d’une même requête partageront le même StorageSnapshot pour chaque table.
Cela garantit une vue cohérente des données dans l’ensemble de la requête, même si la même table est accédée plusieurs fois.
Ce paramètre est nécessaire pour les requêtes où la cohérence interne des data parts est importante. Exemple :
```sql theme={null}
SELECT
count()
FROM events
WHERE (_part, _part_offset) IN (
SELECT _part, _part_offset
FROM events
WHERE user_id = 42
)
```
Sans ce paramètre, la requête externe et la requête interne peuvent s’exécuter sur des instantanés de données différents, ce qui peut entraîner des résultats incorrects.
L’activation de ce paramètre désactive l’optimisation qui supprime les parties de données inutiles des instantanés une fois l’étape de planification terminée.
Par conséquent, les requêtes de longue durée peuvent conserver des parties obsolètes pendant toute leur exécution, ce qui retarde leur nettoyage et accroît la pression sur le stockage.
Ce paramètre s’applique actuellement uniquement aux tables de la famille MergeTree.
Valeurs possibles :
* 0 - Désactivé
* 1 - Activé
## enable\_sharing\_sets\_for\_mutations
Autorise le partage des objets Set créés pour les sous-requêtes IN entre différentes tâches d'une même mutation. Cela réduit l'utilisation de la mémoire et la consommation de CPU
## enable\_streaming\_queries
Autorise les requêtes en continu `SELECT ... FROM t STREAM [CURSOR '{...}']`.
Lorsqu’il est désactivé, toute expression de table utilisant le modificateur `STREAM` est rejetée
lors de la construction du plan. Il s’agit du paramètre de contrôle global de la
fonctionnalité de requêtes en continu ; des capacités supplémentaires peuvent être régies par leurs propres paramètres.
## enable\_time\_time64\_type
**Alias** : `allow_experimental_time_time64_type`
Permet de créer les types de données [Time](/docs/fr/reference/data-types/time) et [Time64](/docs/fr/reference/data-types/time64).
## enable\_unaligned\_array\_join
Autorise ARRAY JOIN sur plusieurs tableaux de tailles différentes. Lorsque ce paramètre est activé, les tableaux sont redimensionnés à la longueur du plus long.
## enable\_url\_encoding
Permet d’activer ou de désactiver le décodage/l’encodage du chemin dans l’URI des tables utilisant le moteur [URL](/docs/fr/reference/engines/table-engines/special/url).
Désactivé par défaut.
## enable\_vertical\_final
Si cette option est activée, les lignes dupliquées sont supprimées pendant FINAL en marquant les lignes comme supprimées, puis en les filtrant ultérieurement au lieu de les fusionner
## enable\_writes\_to\_query\_cache
Lorsqu'il est activé, les résultats des requêtes `SELECT` sont stockés dans le [cache de requêtes](/docs/fr/concepts/features/performance/caches/query-cache).
Valeurs possibles :
* 0 - Désactivé
* 1 - Activé