merge_tree_* paramètres de session

Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source. Lors de la recherche de données, ClickHouse examine les marques de données dans le fichier d’index. Si ClickHouse détecte que les clés requises se trouvent dans une plage donnée, il divise cette plage en merge_tree_coarse_index_granularity sous-plages et y recherche récursivement les clés requises. Valeurs possibles :

• Tout entier pair positif.

N’a d’effet que dans ClickHouse Cloud. Nombre de granules dans la stripe d’une compact part des tables MergeTree à partir duquel utiliser le lecteur multibuffer, qui prend en charge la lecture parallèle et la prélecture. En cas de lecture depuis remote fs, l’utilisation du lecteur multibuffer augmente le nombre de requêtes de lecture. Une part est lue avec un seul tampon lorsqu’elle contient à la fois moins de granules que ce seuil et moins de granules que le nombre de colonnes lues, car dans ce cas, le lecteur à tampon unique effectue moins de requêtes de lecture que le lecteur multibuffer. Indique s’il faut utiliser uniquement la taille des colonnes prewhere pour déterminer la taille de la tâche de lecture. Lorsqu’un filtre ne peut pas être évalué comme une seule plage continue de la clé primaire, par exemple lorsqu’il utilise des colonnes de clé autres que la première, ClickHouse exécute un algorithme itératif de recherche par exclusion générique sur les marques d’index. Le même algorithme est utilisé pour l’analyse de l’index de texte. Ce paramètre limite le nombre d’étapes (vérifications d’index) que l’algorithme consacre à chaque partie de données. Le budget est d’abord consommé sur les plus grandes plages de marques restantes. Lorsqu’il est épuisé, les plages qui n’ont pas été entièrement analysées sont acceptées telles quelles, de sorte que la requête reste correcte mais peut lire plus de granules qu’une recherche sans limite n’en sélectionnerait. Un budget plus faible accélère l’analyse de l’index, au prix de la lecture d’un plus grand volume de données. La limite est approximative plutôt qu’un plafond strict du coût d’analyse : la recherche peut la dépasser d’environ un cycle de division, et lorsque la partie est déjà divisée en de nombreuses plages (par exemple par le cache des conditions de requête), chacune d’elles est vérifiée au moins une fois, quelle que soit la limite. Le nombre d’étapes effectuées par la recherche pour chaque partie de données est indiqué dans les messages de journal de niveau trace de la requête, et les événements de profil IndexGenericExclusionSearchStepLimitReached et TextIndexGenericExclusionSearchStepLimitReached comptent le nombre de fois où le budget a été épuisé. La valeur (par défaut) 0 signifie que le nombre d’étapes est illimité. Valeurs possibles :

• 0 pour un nombre d’étapes illimité, ou tout entier positif.

Si ClickHouse doit lire plus de merge_tree_max_bytes_to_use_cache octets dans une même requête, il n’utilise pas le cache des blocs non compressés. Le cache des blocs non compressés stocke les données extraites pour les requêtes. ClickHouse utilise ce cache pour accélérer les réponses aux petites requêtes répétées. Ce paramètre évite que le cache ne soit perturbé par des requêtes qui lisent de grandes quantités de données. Le paramètre serveur uncompressed_cache_size définit la taille du cache des blocs non compressés. Valeurs possibles :

• Tout entier positif.

Si ClickHouse doit lire plus de merge_tree_max_rows_to_use_cache lignes dans une même requête, il n’utilise pas le cache des blocs non compressés. Le cache des blocs non compressés stocke les données extraites pour les requêtes. ClickHouse utilise ce cache pour accélérer les réponses aux petites requêtes répétées. Ce paramètre évite que le cache soit saturé par des requêtes qui lisent de grandes quantités de données. Le paramètre de serveur uncompressed_cache_size définit la taille du cache des blocs non compressés. Valeurs possibles :

• Tout entier positif.

Si le nombre d’octets à lire à partir d’un fichier d’une table à moteur MergeTree dépasse merge_tree_min_bytes_for_concurrent_read, ClickHouse tente alors de lire ce fichier de manière concurrente à l’aide de plusieurs threads. Valeur possible :

• Entier positif.

Le nombre minimal d’octets à lire à partir d’un fichier avant que le moteur MergeTree puisse paralléliser la lecture lors d’une lecture depuis un système de fichiers distant. Nous ne recommandons pas d’utiliser ce paramètre. Valeurs possibles :

• Entier positif.

Si la distance entre deux blocs de données à lire dans un même fichier est inférieure à merge_tree_min_bytes_for_seek octets, ClickHouse lit alors de façon séquentielle une plage du fichier contenant les deux blocs, évitant ainsi une opération de seek supplémentaire. Valeurs possibles :

• Tout entier positif.

Alias : filesystem_prefetch_min_bytes_for_single_read_task Nombre minimal d’octets à lire par tâche. Limite inférieure stricte pour la taille des tâches (même lorsque le nombre de granules est faible et que le nombre de threads disponibles est élevé, nous n’allouerons pas de tâches plus petites Si le nombre de lignes à lire dans un fichier d’une table MergeTree dépasse merge_tree_min_rows_for_concurrent_read, ClickHouse tente alors d’effectuer une lecture concurrente de ce fichier sur plusieurs threads. Valeurs possibles :

• Entier positif.

Nombre minimal de lignes à lire dans un fichier avant que le moteur MergeTree puisse paralléliser la lecture lors d’une lecture depuis un système de fichiers distant. Nous ne recommandons pas d’utiliser ce paramètre. Valeurs possibles :

• Entier positif.

Si la distance entre deux blocs de données à lire dans un fichier est inférieure à merge_tree_min_rows_for_seek lignes, ClickHouse ne fait pas de seek dans le fichier, mais lit les données de manière séquentielle. Valeurs possibles :

• Tout entier positif.

Pour tester PartsSplitter : diviser les plages de lecture en plages se chevauchant et non chevauchantes à chaque lecture depuis MergeTree, avec la probabilité spécifiée. Injecte un délai artificiel (en millisecondes) lors de la création d’un instantané de stockage pour les tables MergeTree. À utiliser uniquement à des fins de test et de débogage. Valeurs possibles :

• 0 - Aucun délai (par défaut)
• N - Délai en millisecondes

Indique s’il faut utiliser des tâches de taille constante pour lire depuis une table distante. Active la mise en cache des métadonnées des colonnes issues des préfixes de fichiers lors de la lecture depuis des disques distants dans MergeTree. Permet d’utiliser le pool de threads pour la lecture parallèle des préfixes dans les Wide parts de MergeTree. La taille de ce pool de threads est contrôlée par le paramètre du serveur max_prefixes_deserialization_thread_pool_size. Lorsqu’il est activé, ce paramètre utilise la version de sérialisation V1 des types JSON et Dynamic dans MergeTree au lieu de V2. La modification de ce paramètre ne prend effet qu’après le redémarrage du serveur.