> ## 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 use_*
> Paramètres de session ClickHouse du groupe généré use_*.
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 [code source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## use\_async\_executor\_for\_materialized\_views
Utilise une exécution asynchrone et potentiellement multithreadée de la requête de vue matérialisée, ce qui peut accélérer le traitement des vues lors des INSERT, mais consomme aussi davantage de mémoire.
## use\_cache\_for\_count\_from\_files
Active la mise en cache du nombre de lignes lors du comptage depuis des fichiers dans les fonctions de table `file`/`s3`/`url`/`hdfs`/`azureBlobStorage`.
Activé par défaut.
## use\_client\_time\_zone
Utilise le fuseau horaire du client pour interpréter les valeurs de chaîne DateTime, au lieu de celui du serveur.
## use\_compact\_format\_in\_distributed\_parts\_names
Utilise le format compact pour stocker les blocs des INSERT en arrière-plan (`distributed_foreground_insert`) dans les tables utilisant le moteur `Distributed`.
Valeurs possibles :
* 0 — Utilise le format de répertoire `user[:password]@host:port#default_database`.
* 1 — Utilise le format de répertoire `[shard{shard_index}[_replica{replica_index}]]`.
- avec `use_compact_format_in_distributed_parts_names=0`, les modifications de la définition du cluster ne seront pas appliquées aux INSERT en arrière-plan.
- avec `use_compact_format_in_distributed_parts_names=1`, modifier l’ordre des nœuds dans la définition du cluster changera `shard_index`/`replica_index` ; tenez-en compte.
## use\_concurrency\_control
Respecte le contrôle de la concurrence du serveur (voir les paramètres globaux du serveur `concurrent_threads_soft_limit_num` et `concurrent_threads_soft_limit_ratio_to_cores`). Si ce paramètre est désactivé, il permet d'utiliser un plus grand nombre de threads même si le serveur est surchargé (non recommandé en usage normal, et surtout nécessaire pour les tests).
## use\_constant\_folding\_in\_index\_analysis
Substitue les constantes au niveau des partitions dans le prédicat de filtre lors de l'analyse, pour chaque part, de la clé primaire et des skip indexes.
Lorsque la clé de partition apparaît dans le filtre avec des colonnes de clé primaire ou de skip index, cela permet à l'analyse des index de substituer séparément la valeur de partition dans chaque part. C'est particulièrement utile pour les filtres disjonctifs dont les branches ciblent des partitions différentes. Par exemple, avec `PARTITION BY a` et `ORDER BY b` :
```sql theme={null}
SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10)
```
Pour la part de la partition `a = 1`, la condition se simplifie en `b >= 1`, tandis que pour les partitions `a = 2` et `a = 3`, elle se simplifie en `b > 10`, de sorte que chaque part est analysée avec le prédicat qui lui correspond réellement.
Valeurs possibles :
* 0 — Désactivé.
* 1 — Activé.
## use\_hash\_table\_stats\_for\_join\_reordering
Active l’utilisation des statistiques de table de hachage collectées pour l’estimation de la cardinalité lors de la réorganisation des jointures
## use\_hedged\_requests
Active la logique des requêtes hedged pour les requêtes distantes. Cela permet d’établir plusieurs connexions à différentes répliques pour une requête.
Une nouvelle connexion est activée si la ou les connexions existantes à la ou aux répliques n’ont pas été établies dans le délai `hedged_connection_timeout`
ou si aucune donnée n’a été reçue dans le délai `receive_data_timeout`. La requête utilise la première connexion qui envoie un paquet Progress non vide (ou un paquet Data, si `allow_changing_replica_until_first_data_packet`) ;
les autres connexions sont annulées. Les requêtes avec `max_parallel_replicas > 1` sont prises en charge.
Activé par défaut.
Valeur par défaut dans Cloud : `0`.
## use\_hive\_partitioning
Lorsqu’il est activé, ClickHouse détecte le partitionnement de style Hive dans le chemin (`/name=value/`) des moteurs de table de type fichier [File](/docs/fr/reference/functions/table-functions/file#hive-style-partitioning)/[S3](/docs/fr/reference/functions/table-functions/s3#hive-style-partitioning)/[URL](/docs/fr/reference/functions/table-functions/url#hive-style-partitioning)/[HDFS](/docs/fr/reference/functions/table-functions/hdfs#hive-style-partitioning)/[AzureBlobStorage](/docs/fr/reference/functions/table-functions/azureBlobStorage#hive-style-partitioning), et permet d’utiliser les colonnes de partition comme colonnes virtuelles dans les requêtes. Ces colonnes virtuelles porteront les mêmes noms que dans le chemin partitionné, précédés de `_`.
## use\_join\_disjunctions\_push\_down
Active le pushdown des parties des conditions de JOIN reliées par OR vers les côtés d'entrée correspondants (« pushdown partiel »).
Cela permet aux moteurs de stockage de filtrer plus tôt, ce qui peut réduire la quantité de données lues.
L'optimisation préserve la sémantique et n'est appliquée que lorsque chaque branche OR de premier niveau apporte au moins un
prédicat déterministe pour le côté cible.
## use\_legacy\_to\_time
Lorsqu'il est activé, ce paramètre permet d'utiliser la fonction `toTime` legacy, qui convertit une date et heure en une date fixe donnée, tout en préservant l'heure.
Sinon, une nouvelle fonction `toTime` est utilisée, qui convertit différents types de données en type `Time`.
L'ancienne fonction legacy reste également accessible sans condition sous le nom `toTimeWithFixedDate`.
## use\_lightweight\_primary\_key\_index\_analysis
Optimise l’analyse de l’index de la clé primaire pour les tables `MergeTree` avec de longues clés primaires.
Lorsqu’il est activé, la durée de l’analyse d’index dépend principalement de la complexité du filtre de la requête (c’est-à-dire des colonnes clés qu’elle utilise réellement), et non de la longueur de la clé primaire. Ainsi, l’extension de la clé de tri n’ajoute qu’une surcharge négligeable à l’analyse d’index pour les requêtes qui ne filtrent que sur quelques-unes de ses colonnes.
Valeurs possibles :
* 0 — Désactivé. Toutes les colonnes de la clé primaire sont traitées lors de l’analyse d’index.
* 1 — Activé.
## use\_parquet\_metadata\_cache
Lorsque ce paramètre est activé, le format Parquet peut utiliser le cache des métadonnées Parquet.
Valeurs possibles :
* 0 - Désactivé
* 1 - Activé
## use\_primary\_key
Utilise la clé primaire pour élaguer les granules lors de l’exécution des requêtes sur les tables MergeTree.
Valeurs possibles :
* 0 — Désactivé.
* 1 — Activé.
## use\_reader\_executor
Expérimental. Achemine les lectures via le nouveau pipeline `ReaderExecutor` au lieu de la matriochka legacy des tampons de lecture. Bascule sur le chemin legacy pour les configurations que l'exécuteur ne prend pas encore en charge.
## use\_roaring\_bitmap\_iceberg\_positional\_deletes
Utiliser un bitmap roaring pour les suppressions positionnelles d’Iceberg.
## use\_streaming\_marks\_compression
Lors du chargement des marks pour les parts MergeTree, compressez-les dans leur représentation en mémoire un bloc à la fois (streaming), au lieu de matérialiser d’abord l’ensemble du tableau de marks bruts. Cela réduit considérablement le pic de mémoire lors du chargement des marks pour les compact parts avec de nombreux sous-flux (par exemple, les tables avec des colonnes JSON et `write_marks_for_substreams_in_compact_parts` activé).
## use\_strict\_insert\_block\_limits
Lorsqu’il est activé, ce paramètre applique strictement les limites minimale et maximale de taille du bloc d’insertion.
Un bloc est émis lorsque :
* Seuils min (AND) : min\_insert\_block\_size\_rows ET min\_insert\_block\_size\_bytes sont tous deux atteints.
* Seuils max (OR) : max\_insert\_block\_size\_rows OU max\_insert\_block\_size\_bytes est atteint.
Lorsqu’il est désactivé, un bloc est émis lorsque :
* Seuils min (OR) : min\_insert\_block\_size\_rows OU min\_insert\_block\_size\_bytes est atteint.
**Remarque** : si les paramètres max sont inférieurs aux paramètres min, les limites max ont préséance et les blocs seront émis avant que les seuils min ne soient atteints.
**Remarque** : ce paramètre est automatiquement désactivé pour les inserts asynchrones, car les inserts asynchrones associent un token de déduplication à chaque entrée, ce qui est incompatible avec le fractionnement des blocs nécessaire à l’application de limites strictes.
Désactivé par défaut.
## use\_structure\_from\_insertion\_table\_in\_table\_functions
Utilise la structure de la table d’insertion au lieu de l’inférence de schéma à partir des données. Valeurs possibles : 0 - désactivé, 1 - activé, 2 - auto
## use\_uncompressed\_cache
Indique s’il faut utiliser un cache de blocs non compressés. Accepte 0 ou 1. Par défaut, 0 (désactivé).
L’utilisation du cache non compressé (uniquement pour les tables de la famille MergeTree) peut réduire considérablement la latence et augmenter le débit lorsqu’un grand nombre de requêtes courtes sont exécutées. Activez ce paramètre pour les utilisateurs qui envoient fréquemment des requêtes courtes. Tenez également compte du paramètre de configuration [uncompressed\_cache\_size](/docs/fr/reference/settings/server-settings/settings#uncompressed_cache_size) (défini uniquement dans le fichier de configuration) — la taille des blocs du cache non compressé. Par défaut, elle est de 8 Gio. Le cache non compressé se remplit selon les besoins et les données les moins utilisées sont automatiquement supprimées.
Pour les requêtes qui lisent un volume de données déjà important (un million de lignes ou plus), le cache non compressé est automatiquement désactivé afin de réserver l’espace aux requêtes véritablement petites. Cela signifie que vous pouvez laisser le paramètre 'use\_uncompressed\_cache' toujours défini sur 1.
## use\_with\_fill\_by\_sorting\_prefix
Les colonnes qui précèdent les colonnes WITH FILL dans la clause ORDER BY constituent le préfixe de tri. Les lignes dont les valeurs du préfixe de tri diffèrent sont remplies indépendamment