paramètres de session use_*

Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source. 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. 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. Utilise le fuseau horaire du client pour interpréter les valeurs de chaîne DateTime, au lieu de celui du serveur. 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}]].

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). 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 : 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é.

Active l’utilisation des statistiques de table de hachage collectées pour l’estimation de la cardinalité lors de la réorganisation des jointures 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. 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/S3/URL/HDFS/AzureBlobStorage, 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 _. 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. 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. 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é.

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é

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

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. Utiliser un bitmap roaring pour les suppressions positionnelles d’Iceberg. 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é). 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. 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 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 (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. 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