Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.
Écrit un en-tête CORS HTTP supplémentaire.
analyze_index_with_space_filling_curves
Si une table possède une courbe de remplissage de l’espace dans son index, par exemple ORDER BY mortonEncode(x, y) ou ORDER BY hilbertEncode(x, y), et que la requête comporte des conditions sur ses arguments, par exemple x >= 10 AND x <= 20 AND y >= 20 AND y <= 30, utilisez la courbe de remplissage de l’espace pour l’analyse de l’index.
Lorsqu’il est activé, l’analyseur remplace les vues ordinaires (non matérialisées et non paramétrées) par les sous-requêtes qui les définissent, ce qui permet des optimisations transversales telles que le pushdown des prédicats et l’élagage des colonnes.
any_join_distinct_right_table_keys
Active le comportement legacy du serveur ClickHouse pour les opérations ANY INNER|LEFT JOIN.
Utilisez ce paramètre uniquement pour assurer la rétrocompatibilité si vos cas d’usage dépendent du comportement legacy de JOIN.
Lorsque le comportement legacy est activé :
- Les résultats des opérations
t1 ANY LEFT JOIN t2 et t2 ANY RIGHT JOIN t1 ne sont pas identiques, car ClickHouse utilise une logique de correspondance des clés entre les tables, de gauche à droite, de plusieurs à un.
- Les résultats des opérations
ANY INNER JOIN contiennent toutes les lignes de la table de gauche, comme c’est le cas pour les opérations SEMI LEFT JOIN.
Lorsque le comportement legacy est désactivé :
- Les résultats des opérations
t1 ANY LEFT JOIN t2 et t2 ANY RIGHT JOIN t1 sont identiques, car ClickHouse utilise une logique qui permet une correspondance des clés de un à plusieurs dans les opérations ANY RIGHT JOIN.
- Les résultats des opérations
ANY INNER JOIN contiennent une ligne par clé provenant des tables de gauche et de droite.
Valeurs possibles :
- 0 — Le comportement legacy est désactivé.
- 1 — Le comportement legacy est activé.
Voir aussi :
archive_adaptive_buffer_max_size_bytes
Limite la taille maximale du tampon adaptatif utilisé pour l’écriture dans des fichiers d’archive (par exemple, des archives tar
arrow_flight_request_descriptor_type
Type de descripteur à utiliser pour les requêtes Arrow Flight. ‘path’ envoie le nom du jeu de données sous forme de descripteur de chemin. ‘command’ envoie une requête SQL sous forme de descripteur de commande (requis pour Dremio).
Valeurs possibles :
- ‘path’ — Utilise FlightDescriptor::Path (par défaut, fonctionne avec la plupart des serveurs Arrow Flight)
- ‘command’ — Utilise FlightDescriptor::Command avec une requête SELECT (requis pour Dremio)
backup_slow_all_threads_after_retryable_s3_error
Lorsqu’il est défini sur true, tous les threads exécutant des requêtes S3 vers le même endpoint de sauvegarde sont ralentis
dès qu’une requête S3 rencontre une erreur S3 pouvant donner lieu à un réessai, telle que ‘Slow Down’.
Lorsqu’il est défini sur false, chaque thread gère le backoff des requêtes S3 indépendamment des autres.
N’a d’effet que dans ClickHouse Cloud. Nombre de threads d’arrière-plan utilisés pour télécharger de manière spéculative de nouvelles parties de données dans le cache du système de fichiers lorsque cache_populated_by_fetch est activé. Zéro pour désactiver.
calculate_text_stack_trace
Calcule une stack trace textuelle en cas d’exception pendant l’exécution des requêtes. Il s’agit du comportement par défaut. Cela nécessite des recherches de symboles, ce qui peut ralentir les tests de fuzzing lorsqu’un très grand nombre de requêtes erronées sont exécutées. Dans des conditions normales, vous ne devriez pas désactiver cette option.
cancel_http_readonly_queries_on_client_close
Annule les requêtes HTTP en lecture seule (par ex. SELECT) lorsqu’un client ferme la connexion sans attendre de réponse.
Valeur par défaut dans Cloud : 1.
Valide les sommes de contrôle lors de la lecture. Ce paramètre est activé par défaut et doit toujours l’être en production. N’attendez aucun bénéfice de la désactivation de ce paramètre. Il ne doit être utilisé que pour des expérimentations et des benchmarks. Ce paramètre s’applique uniquement aux tables de la famille MergeTree. Les sommes de contrôle sont toujours validées pour les autres moteurs de table et lors de la réception de données sur le réseau.
connection_pool_max_wait_ms
Temps d’attente, en millisecondes, pour obtenir une connexion lorsque le pool de connexions est plein.
Valeurs possibles :
- Entier positif.
- 0 — Délai d’attente infini.
connections_with_failover_max_tries
Le nombre maximal de tentatives de connexion à effectuer avec chaque réplique pour le moteur de table Distributed.
Lorsqu’elle est définie sur true, une requête SELECT est convertie en forme normale conjonctive (CNF). Dans certains cas, réécrire une requête en CNF peut accélérer son exécution (voir cette issue GitHub pour plus d’explications).
Par exemple, notez que la requête SELECT suivante n’est pas modifiée (comportement par défaut) :
Le résultat est :
Définissons convert_query_to_cnf à true et voyons ce qui change :
Notez que la clause WHERE est réécrite en CNF, mais le jeu de résultats reste identique : la logique booléenne est inchangée.
Valeurs possibles : true, false
count_matches_stop_at_empty_match
Arrête le comptage dès qu’un motif produit une correspondance de longueur nulle dans la fonction countMatches.
cross_to_inner_join_rewrite
Utilisez INNER JOIN au lieu d’une jointure par virgule/CROSS JOIN s’il existe des expressions de jointure dans la clause WHERE. Valeurs : 0 - aucune réécriture, 1 - appliquer si possible aux jointures par virgule/CROSS JOIN, 2 - forcer la réécriture de toutes les jointures par virgule, cross - si possible
data_type_default_nullable
Permet aux types de données sans modificateurs explicites NULL or NOT NULL dans les définitions de colonnes d’être Nullable.
Valeurs possibles :
- 1 — Les types de données dans les définitions de colonnes sont
Nullable par défaut.
- 0 — Les types de données dans les définitions de colonnes ne sont pas
Nullable par défaut.
Vérifie les dépassements de capacité des opérations arithmétiques et de comparaison sur les nombres décimaux
deduplicate_blocks_in_dependent_materialized_views
Active ou désactive la vérification de déduplication pour les vues matérialisées qui reçoivent des données de tables Replicated*.
Valeurs possibles :
- 0 — Désactivé.
- 1 — Activé.
Lorsqu’il est activé, ClickHouse effectue la déduplication des blocs dans les vues matérialisées qui dépendent de tables Replicated*.
Ce paramètre est utile pour garantir que les vues matérialisées ne contiennent pas de données dupliquées lorsque l’opération d’insertion est réessayée à la suite d’une défaillance.
Voir aussi
defer_partition_pruning_after_final
Lorsqu’il est activé (par défaut), l’élagage des partitions est ignoré pour les requêtes FINAL sur les tables dont les
colonnes de clé de partition ne font pas partie de la clé de tri. Il s’agit du comportement sûr du point de vue de la validité des résultats,
introduit en 26.3 : FINAL peut devoir dédupliquer des lignes qui partagent une clé primaire mais se trouvent
dans des partitions différentes, et l’élagage des partitions exclurait silencieusement ces lignes de
l’ensemble d’entrée de la déduplication.
Lorsqu’il est désactivé, l’élagage des partitions s’applique même avec FINAL, ce qui rétablit le comportement
antérieur à 26.3. Cela peut être nettement plus rapide pour les requêtes avec des prédicats WHERE sur la
colonne de partition, mais n’est correct que lorsque des lignes ayant la même clé primaire ne peuvent pas exister
dans des partitions différentes — par exemple, des tables de journaux d’événements dont la colonne de partition est définie au moment de l’insert
et ne change jamais.
Ce paramètre n’affecte que les tables partitionnées dont les colonnes de clé de partition ne sont pas incluses
dans la clé de tri ; pour les autres tables, l’élagage des partitions est toujours appliqué.
Valeurs possibles :
- 0 — Appliquer l’élagage des partitions avant
FINAL (comportement antérieur à 26.3, plus rapide mais non sûr dans le cas général).
- 1 — Différer l’élagage des partitions après
FINAL (par défaut, sûr du point de vue de la validité des résultats).
Si cette valeur est définie sur true, inclut uniquement les noms de colonnes et les types dans le résultat de la requête DESCRIBE
Dialecte utilisé pour interpréter la requête
S’il est activé, le serveur n’envoie pas au client les lignes du résultat de la requête. La requête est toujours exécutée et intégralement journalisée sur le serveur, et le client reçoit toujours les paquets restants.
Utilisé pour le trafic miroir, les benchmarks et le fuzzing.
N’a aucun effet sur les requêtes secondaires.
Affecte uniquement le protocole TCP natif.
Définit ce qui se produit lorsque la quantité de données dépasse l’une des limites.
Valeurs possibles :
throw : lever une exception (par défaut).
break : arrêter l’exécution de la requête et renvoyer le résultat partiel, comme si les
données source étaient épuisées.
do_not_merge_across_partitions_select_final
Améliore les requêtes FINAL en évitant les fusions entre partitions différentes.
Lorsqu’il est activé, lors des requêtes SELECT FINAL, les parts provenant de partitions différentes ne sont pas fusionnées entre elles. La fusion s’effectue uniquement au sein de chaque partition. Cela peut considérablement améliorer les performances des requêtes sur les tables partitionnées.
dynamic_throw_on_type_mismatch
Lorsqu’une fonction est appliquée à une colonne Dynamic à l’aide de l’implémentation par défaut,
ce paramètre contrôle ce qui se passe pour les lignes dont le type réel est incompatible avec la fonction :
true (par défaut) — lever une exception.
false — renvoyer NULL pour ces lignes à la place.
Si cette option est activée, n’autoriser que les identifiants contenant des caractères alphanumériques et des traits de soulignement.
engine_url_skip_empty_files
Permet d’ignorer ou non les fichiers vides dans les tables du moteur URL.
Valeurs possibles :
- 0 —
SELECT lève une exception si le fichier vide n’est pas compatible avec le format demandé.
- 1 —
SELECT renvoie un résultat vide pour un fichier vide.
Lorsqu’il est activé, ClickHouse fournit la valeur exacte de la statistique rows_before_limit_at_least, mais au prix d’une lecture complète des données avant la limite.
Définit le mode par défaut de la requête EXCEPT. Valeurs possibles : chaîne vide, ‘ALL’, ‘DISTINCT’. Si elle est vide, une requête sans mode lèvera une exception.
exclude_materialize_skip_indexes_on_insert
Exclut les index de saut spécifiés afin qu’ils ne soient ni construits ni stockés lors des INSERT. Les index de saut exclus seront toutefois toujours construits et stockés lors des fusions ou par une requête
MATERIALIZE INDEX explicite.
N’a aucun effet si materialize_skip_indexes_on_insert vaut false.
Exemple :
execute_exists_as_scalar_subquery
Exécute les sous-requêtes EXISTS non corrélées sous forme de sous-requêtes scalaires. Comme pour les sous-requêtes scalaires, le cache est utilisé et le constant folding s’applique au résultat.
Valeur par défaut dans Cloud : 0.
explain_query_plan_default
Format par défaut utilisé par EXPLAIN PLAN.
Valeurs possibles :
pretty (par défaut depuis la version 26.7) — actions, compact et pretty valent par défaut true, ce qui produit un plan compact, pretty et annoté avec les actions.
legacy — sortie antérieure à la version 26.7.
Si vous spécifiez explicitement les options actions, compact ou pretty dans l’instruction EXPLAIN (par exemple, EXPLAIN actions = 0, compact = 0, pretty = 0 SELECT ...), cela prévaut toujours sur ce paramètre.
EXPLAIN PLAN avec json = 1 ou distributed = 1 conserve les valeurs par défaut legacy (antérieures à la version 26.7), indépendamment de ce paramètre, sauf si actions, compact ou pretty sont définis explicitement. La sortie pretty ne peut pas représenter des résultats JSON ni des plans distribués par shard ; ces modes ne sont donc correctement rendus qu’au format legacy.
Alias: extract_kvp_max_pairs_per_row
Nombre maximal de paires que la fonction extractKeyValuePairs peut produire. Sert de garde-fou pour éviter une consommation excessive de mémoire.
Indique s’il faut prendre en compte les valeurs extrêmes (les valeurs minimales et maximales des colonnes dans le résultat de la requête). Accepte 0 ou 1. La valeur par défaut est 0 (désactivé).
Pour plus d’informations, consultez la section « Valeurs extrêmes ».
fallback_to_stale_replicas_for_distributed_queries
Force une requête vers une réplique obsolète si des données à jour ne sont pas disponibles. Voir Replication.
ClickHouse sélectionne la réplique la plus pertinente parmi les répliques obsolètes de la table.
Utilisé lors de l’exécution d’un SELECT depuis une table distribuée pointant vers des tables répliquées.
Par défaut, 1 (activé).
file_like_engine_default_partition_strategy
Stratégie de partitionnement par défaut pour les moteurs de type fichier.
filesystem_prefetches_limit
Nombre maximal de prefetches. Zéro signifie qu’il n’y a pas de limite. Il est toutefois recommandé d’utiliser le paramètre filesystem_prefetches_max_memory_usage si vous souhaitez limiter le nombre de prefetches.
Applique automatiquement le modificateur FINAL à toutes les tables d’une requête auxquelles FINAL s’applique, y compris les tables jointes, les tables dans les sous-requêtes et les
tables distribuées.
Valeurs possibles :
Exemple :
finalize_projection_parts_synchronously
Lorsqu’il est activé, les parties de projection sont finalisées de manière synchrone pendant INSERT, ce qui réduit l’utilisation mémoire maximale au prix d’un parallélisme de téléversement vers S3 moindre. Par défaut, le flux de sortie de chaque projection est maintenu actif jusqu’à la finalisation de l’intégralité de la part (y compris toutes les projections), ce qui permet de faire se chevaucher les téléversements vers S3, mais augmente l’utilisation mémoire maximale proportionnellement au nombre de projections. Ce paramètre n’affecte que le processus d’INSERT ; merge et mutation finalisent déjà les projections de manière synchrone.
Définit le format des données des colonnes Nested.
Valeurs possibles :
- 1 — La colonne Nested est aplatie en tableaux distincts.
- 0 — La colonne Nested reste un tableau unique de tuples.
Utilisation
Si ce paramètre est défini sur 0, il est possible d’utiliser un niveau d’imbrication quelconque.
Exemples
Requête :
Résultat :
Requête :
Résultat :
Active ou désactive fsync lors de l’écriture de fichiers .sql. Activé par défaut.
Il peut être judicieux de le désactiver si le serveur possède des millions de petites tables constamment créées et supprimées.
functions_h3_default_if_invalid
Si false, les fonctions h3, par exemple h3CellAreaM2, génèrent une exception si l’entrée n’est pas valide. Si true, elles renvoient 0 ou la valeur par défaut.
geo_distance_returns_float64_on_float64_arguments
Si les quatre arguments des fonctions geoDistance, greatCircleDistance et greatCircleAngle sont de type Float64, celles-ci renvoient un Float64 et utilisent la double précision pour les calculs internes. Dans les versions précédentes de ClickHouse, ces fonctions renvoyaient toujours un Float32.
La fonction geoToH3 accepte (lon, lat) si le paramètre est réglé sur lon_lat, et (lat, lon) s’il est réglé sur lat_lon.
glob_expansion_max_elements
Nombre maximal d’adresses autorisées (pour les stockages externes, les fonctions table, etc.).
h3togeo_lon_lat_result_order
La fonction ‘h3ToGeo’ renvoie (lon, lat) si la valeur est true, sinon (lat, lon).
Délai d’expiration, en millisecondes, pour la réception du paquet Hello des répliques lors de la négociation initiale.
hedged_connection_timeout_ms
Délai d’expiration pour établir une connexion avec une réplique dans le cadre des requêtes hedged
highlight_max_matches_per_row
Définit le nombre maximal de correspondances de surlignage par ligne dans la fonction highlight. Utilisez-le pour éviter une consommation excessive de mémoire lors du surlignage de motifs très répétitifs dans de longs textes.
Valeurs possibles :
hnsw_candidate_list_size_for_search
Taille de la liste dynamique des candidats lors de la recherche dans l’index de similarité vectorielle, également appelée « ef_search ».
Durée d’expiration du HSTS. 0 signifie que le HSTS est désactivé.
Délai d’expiration avant la fermeture des connexions TCP inactives après le nombre de secondes spécifié.
Valeurs possibles :
- Entier positif (0 : fermeture immédiate, après 0 seconde).
inject_random_order_for_select_without_order_by
Si ce paramètre est activé, ‘ORDER BY rand()’ est injecté dans les requêtes SELECT sans clause ORDER BY.
S’applique uniquement à une profondeur de sous-requête = 0. Les sous-requêtes et INSERT INTO … SELECT ne sont pas affectés.
Si la structure de premier niveau est UNION, ‘ORDER BY rand()’ est injecté indépendamment dans chacune des branches.
Utile uniquement pour les tests et le développement (l’absence de ORDER BY est une source de résultats de requête non déterministes).
L’intervalle, en microsecondes, entre les vérifications de l’annulation de l’exécution de la requête et l’envoi de la progression.
Définit le mode par défaut de la requête INTERSECT. Valeurs possibles : chaîne vide, ‘ALL’, ‘DISTINCT’. Si cette valeur est vide, une requête sans mode générera une exception.
least_greatest_legacy_null_behavior
S’il est activé, les fonctions ‘least’ et ‘greatest’ renvoient NULL si l’un de leurs arguments est NULL.
legacy_column_name_of_tuple_literal
Répertorie tous les noms des éléments des grands littéraux tuple dans leurs noms de colonne au lieu d’un hachage. Ce paramètre n’existe que pour des raisons de compatibilité. Il est pertinent de le définir sur ‘true’ lors d’une mise à jour progressive du cluster d’une version inférieure à 21.7 vers une version supérieure.
Définit le nombre maximal de lignes à renvoyer dans le résultat de la requête. Ce paramètre ajuste la valeur définie par la clause LIMIT, de sorte que la limite spécifiée dans la requête ne puisse pas dépasser celle définie par ce paramètre.
Valeurs possibles :
- 0 — Le nombre de lignes n’est pas limité.
- Entier positif.
load_marks_asynchronously
Charger les marks MergeTree de façon asynchrone
Valeur par défaut dans Cloud : 1.
Définit le nombre de secondes pendant lequel une demande de verrouillage attend avant d’échouer.
Le délai d’expiration du verrouillage est utilisé pour éviter les interblocages lors de l’exécution d’opérations de lecture/écriture sur des tables. Lorsque ce délai expire et que la demande de verrouillage échoue, le serveur ClickHouse lève une exception “Locking attempt timed out! Possible deadlock avoided. Client should retry.” avec le code d’erreur DEADLOCK_AVOIDED.
Valeurs possibles :
- Entier positif (en secondes).
- 0 — Aucun délai d’expiration du verrouillage.
low_priority_query_wait_time_ms
Lorsque le mécanisme de priorisation des requêtes est utilisé (voir le paramètre priority), les requêtes à faible priorité attendent la fin des requêtes de priorité plus élevée. Ce paramètre définit cette durée d’attente.
Créer un plan de requête distribuée.
merge_table_max_tables_to_look_for_schema_inference
Lors de la création d’une table Merge sans schéma explicite ou lors de l’utilisation de la fonction de table merge, le schéma est inféré comme l’union d’au plus le nombre spécifié de tables correspondantes.
S’il y a davantage de tables, le schéma sera inféré à partir des premières tables, jusqu’au nombre spécifié.
mongodb_throw_on_unsupported_query
Si ce paramètre est activé, les tables MongoDB renverront une erreur lorsqu’une requête MongoDB ne peut pas être générée. Sinon, ClickHouse lit l’intégralité de la table et la traite localement. Cette option ne s’applique pas lorsque ‘allow_experimental_analyzer=0’.
multiple_joins_try_to_keep_original_names
Ne pas ajouter d’alias à la liste des expressions de premier niveau lors de la réécriture de plusieurs JOIN
Ramener les noms de fonctions à leur forme canonique
Définit le nombre de lignes à ignorer avant de commencer à renvoyer les lignes de la requête. Il ajuste l’offset défini par la clause OFFSET, de sorte que ces deux valeurs soient additionnées.
Valeurs possibles :
- 0 — Aucune ligne n’est ignorée.
- Entier positif.
Exemple
Table d’entrée :
Requête :
Résultat :
paimon_target_snapshot_id
Lecture ciblée d’un snapshot au niveau de la requête pour le mode incrémental de Paimon. Lorsque >0, le lecteur récupère uniquement le delta
pour le snapshot_id spécifié sans faire progresser le watermark validé.
Par défaut : -1 (désactivé)
parallelize_output_from_storages
Parallélise la sortie à l’étape de lecture depuis les stockages. Cela permet, lorsque c’est possible, de paralléliser le traitement des requêtes immédiatement après la lecture depuis les stockages.
partial_result_on_first_cancel
Permet à la requête de renvoyer un résultat partiel après son annulation.
Enregistre les statistiques d’index pour chaque partie
Bloque dans la boucle d’attente des requêtes sur le serveur pendant le nombre de secondes spécifié.
Dialecte SQL source du transpileur polyglotte (par ex. ‘sqlite’, ‘mysql’, ‘postgresql’, ‘snowflake’, ‘duckdb’).
postgresql_fault_injection_probability
Probabilité approximative d’échec des requêtes PostgreSQL internes (utilisées pour la réplication). La valeur valide se situe dans l’intervalle [0.0f, 1.0f]
predicate_statistics_sample_rate
Collecte des statistiques sur la sélectivité des prédicats dans system.predicate_statistics_log. Lorsqu’il est défini sur N > 0, environ 1/N des requêtes sont échantillonnées (en fonction de l’identifiant de requête). 0 signifie désactivé.
La taille maximale du tampon de prélecture pour la lecture à partir du système de fichiers. Les valeurs supérieures à 256 MiB sont limitées à 256 MiB, car un tampon de lecture n’a jamais besoin d’être plus grand.
Permet d’afficher de façon lisible, avec des retraits, les noms de types profondément imbriqués dans la requête DESCRIBE et la fonction toTypeName().
Exemple :
Priorité de la requête. 1 - la plus élevée ; plus la valeur est grande, plus la priorité est faible ; 0 - ne pas utiliser de priorités.
push_external_roles_in_interserver_queries
Active la transmission des rôles utilisateur de l’initiateur aux autres nœuds lors de l’exécution d’une requête.
query_metric_log_interval
Intervalle, en millisecondes, de collecte du query_metric_log pour les requêtes individuelles.
S’il est défini sur une valeur négative, il prendra la valeur collect_interval_milliseconds du paramètre query_metric_log, ou utilisera 1000 par défaut si ce paramètre n’est pas présent.
Pour désactiver la collecte pour une requête donnée, définissez query_metric_log_interval sur 0.
Valeur par défaut : -1
Le temps d’attente dans la file de requêtes si le nombre de requêtes simultanées dépasse le maximum autorisé.
Le délai d’attente avant une nouvelle tentative de lecture depuis RabbitMQ.
0 - aucune restriction en mode lecture seule. 1 - uniquement les requêtes de lecture, ainsi que la modification des paramètres explicitement autorisés. 2 - uniquement les requêtes de lecture, ainsi que la modification des paramètres, à l’exception du paramètre ‘readonly’.
recursive_cte_max_steps_in_type_inference
Nombre maximal d’itérations pour déduire les types de colonnes dans les CTE récursives. Les types de colonnes sont déterminés en appliquant de manière itérative getLeastSupertype aux parties non récursive et récursive de l’UNION ALL jusqu’à convergence. Définissez cette valeur sur 0 pour désactiver l’élargissement des types et utiliser uniquement les types de la partie non récursive.
regexp_max_matches_per_row
Définit le nombre maximal de correspondances d’une même expression régulière par ligne. Utilisez ce paramètre pour éviter une surcharge de mémoire lors de l’utilisation d’une expression régulière gourmande dans la fonction extractAllGroupsHorizontal.
Valeurs possibles :
reject_expensive_hyperscan_regexps
Rejette les motifs dont l’évaluation avec hyperscan est susceptible d’être coûteuse (en raison d’une explosion du nombre d’états de l’AFN)
remerge_sort_lowered_memory_bytes_ratio
Si l’utilisation de la mémoire après une nouvelle fusion n’est pas réduite dans cette proportion, cette nouvelle fusion sera désactivée.
remote_read_min_bytes_for_seek
Nombre minimal d’octets requis pour qu’une lecture distante (URL, S3) effectue un seek, plutôt qu’une lecture avec ignore.
rename_files_after_processing
-
Type: String
-
Valeur par défaut : Chaîne vide
Ce paramètre permet de spécifier un modèle de renommage pour les fichiers traités par la fonction de table file. Lorsque cette option est définie, tous les fichiers lus par la fonction de table file sont renommés selon le modèle spécifié et ses espaces réservés, uniquement si leur traitement a réussi.
Marqueurs de substitution
%a — Nom de fichier d’origine complet (p. ex., “sample.csv”).
%f — Nom de fichier d’origine sans extension (p. ex., “sample”).
%e — Extension du fichier d’origine avec le point (p. ex., “.csv”).
%t — Horodatage (en microsecondes).
%% — Signe de pourcentage (”%”).
-
Option :
--rename_files_after_processing="processed_%f_%t%e"
-
Requête :
SELECT * FROM file('sample.csv')
Si sample.csv est lu avec succès, le fichier sera renommé en processed_sample_1683473210851438.csv
replication_wait_for_inactive_replica_timeout
Indique combien de temps (en secondes) attendre que les répliques inactives exécutent les requêtes ALTER, OPTIMIZE ou TRUNCATE.
Valeurs possibles :
0 — Ne pas attendre.
- Entier négatif — Attendre indéfiniment.
- Entier positif — Nombre de secondes à attendre.
Utilisé dans la planification des charges de travail. Quantité minimale de RAM réservée à l’exécution d’une requête sur un seul serveur. La réservation s’effectue via la hiérarchie WORKLOAD à l’aide de la valeur du paramètre de requête workload.
Si la charge de travail ne dispose pas de suffisamment de mémoire, une requête ne peut pas démarrer et reste en attente jusqu’à ce que la réservation puisse être honorée.
Une valeur de 0 signifie qu’il n’y a pas de réservation.
Ce paramètre ne prend effet que si la ressource MEMORY RESERVATION est créée.
restore_replicated_merge_tree_to_shared_merge_tree
Remplace le moteur de table ReplicatedMergeTree par SharedMergeTree lors de RESTORE.
Valeur par défaut Cloud : 1.
Définit le comportement à adopter si le volume du résultat dépasse l’une des limites.
Valeurs possibles :
throw : lever une exception (par défaut).
break : arrêter l’exécution de la requête et renvoyer un résultat partiel, comme si les
données source étaient épuisées.
L’utilisation de ‘break’ est similaire à celle de LIMIT. Break interrompt l’exécution uniquement au
niveau du block. Cela signifie que le nombre de lignes renvoyées est supérieur à
max_result_rows, est un multiple de max_block_size
et dépend de max_threads.
Exemple
Lorsqu’il est activé, ClickHouse fournit la valeur exacte de la statistique rows_before_aggregation, qui correspond au nombre de lignes lues avant l’agrégatio
secondary_indices_enable_bulk_filtering
Active l’algorithme de filtrage groupé pour les indices. Il devrait toujours offrir de meilleures performances, mais ce paramètre est conservé pour des raisons de compatibilité et de contrôle.
select_sequential_consistency
Le comportement de ce paramètre diffère entre SharedMergeTree et ReplicatedMergeTree. Voir la cohérence de SharedMergeTree pour plus d’informations sur le comportement de select_sequential_consistency dans SharedMergeTree.
Active ou désactive la cohérence séquentielle pour les requêtes SELECT. Nécessite que insert_quorum_parallel soit désactivé (activé par défaut).
Valeurs possibles :
- 0 — Désactivé.
- 1 — Activé.
Utilisation
Lorsque la cohérence séquentielle est activée, ClickHouse n’autorise l’exécution de la requête SELECT par le client que sur les répliques qui contiennent les données de toutes les requêtes INSERT précédentes exécutées avec insert_quorum. Si le client pointe vers une réplique incomplète, ClickHouse génère une exception. La requête SELECT n’inclura pas les données qui n’ont pas encore été écrites sur le quorum de répliques.
Lorsque insert_quorum_parallel est activé (par défaut), select_sequential_consistency ne fonctionne pas. En effet, les requêtes INSERT parallèles peuvent être écrites sur différents ensembles de répliques de quorum, sans garantie qu’une seule réplique ait reçu toutes les écritures.
Voir aussi :
Définit le fuseau horaire implicite de la session ou de la requête actuelle.
Le fuseau horaire implicite est celui appliqué aux valeurs de type DateTime/DateTime64 pour lesquelles aucun fuseau horaire n’est explicitement spécifié.
Ce paramètre a préséance sur le fuseau horaire implicite configuré globalement (au niveau du serveur).
Une valeur de ” (chaîne vide) signifie que le fuseau horaire implicite de la session ou de la requête actuelle est celui du fuseau horaire du serveur.
Vous pouvez utiliser les fonctions timeZone() et serverTimeZone() pour obtenir le fuseau horaire de la session et celui du serveur.
Valeurs possibles :
- N’importe quel nom de fuseau horaire de
system.time_zones, par exemple Europe/Berlin, UTC ou Zulu
Exemples :
Attribuez au DateTime interne le fuseau horaire de session ‘America/Denver’, sans fuseau horaire explicitement spécifié :
Toutes les fonctions qui analysent des valeurs DateTime/DateTime64 ne respectent pas session_timezone. Cela peut entraîner des erreurs subtiles.
Voir l’exemple et l’explication ci-dessous.
Cela s’explique par l’utilisation de chaînes d’analyse différentes :
toDateTime() sans fuseau horaire explicitement indiqué, utilisé dans la première requête SELECT, respecte le paramètre session_timezone et le fuseau horaire global.
- Dans la deuxième requête, une valeur DateTime est analysée à partir d’une String et hérite du type et du fuseau horaire de la colonne existante
d. Ainsi, le paramètre session_timezone et le fuseau horaire global ne sont pas pris en compte.
Voir aussi
Définit ce qui se produit lorsque la quantité de données dépasse l’une des limites.
Valeurs possibles :
throw : lever une exception (par défaut).
break : arrêter l’exécution de la requête et renvoyer le résultat partiel, comme si les
données source étaient épuisées.
single_join_prefer_left_table
Pour un seul JOIN, en cas d’ambiguïté d’identifiant, privilégier la table de gauche
skip_redundant_aliases_in_udf
Les alias redondants ne sont pas utilisés (substitués) dans les fonctions définies par l’utilisateur afin d’en simplifier l’utilisation.
Valeurs possibles :
- 1 — Les alias sont ignorés (substitués) dans les UDFs.
- 0 — Les alias ne sont pas ignorés (substitués) dans les UDFs.
Exemple
Différence entre l’état activé et désactivé :
Requête :
Résultat :
Requête :
Résultat :
sleep_after_receiving_query_ms
Durée d’attente après réception d’une requête dans TCPHandler
Contrôle le format binaire de transmission utilisé pour la compression snappy sur les chemins d’E/S de fichiers génériques tels que file et url. HTTP Content-Encoding: snappy utilise toujours le format de tramage et ignore ce paramètre.
Notez que le format brut de bloc snappy produit par un seul appel à snappy::Compress (par exemple, les charges utiles du protocole distant Prometheus gérées par SnappyBasicReadBuffer) est un format binaire de transmission distinct, propre au protocole, et n’est pas contrôlé par ce paramètre.
Valeurs possibles :
basic — format de bloc Hadoop snappy. Compatible avec les fichiers lus et écrits par Hadoop. Prend en charge la lecture et l’écriture.
framed — format de tramage Snappy, le format de streaming standard défini par Google. Prend en charge la lecture et l’écriture.
Définit ce qui se produit si le nombre de lignes reçues avant le tri dépasse l’une des limites.
Valeurs possibles :
throw : lever une exception.
break : arrêter l’exécution de la requête et renvoyer un résultat partiel.
splitby_max_substrings_includes_remaining_string
Contrôle si la fonction splitBy*(), avec l’argument max_substrings > 0, inclut la chaîne restante dans le dernier élément du tableau résultant.
Valeurs possibles :
0 - La chaîne restante ne sera pas incluse dans le dernier élément du tableau résultant.
1 - La chaîne restante sera incluse dans le dernier élément du tableau résultant. Il s’agit du comportement de la fonction split() de Spark et de la méthode ‘string.split()’ de Python.
stop_refreshable_materialized_views_on_startup
Au démarrage du serveur, empêche la programmation des vues matérialisées actualisables, comme avec SYSTEM STOP VIEWS. Vous pouvez ensuite les démarrer manuellement avec SYSTEM START VIEWS ou SYSTEM START VIEW <name>. S’applique également aux vues nouvellement créées. N’a aucun effet sur les vues matérialisées non actualisables.
Le temps, en secondes, pendant lequel la connexion doit rester inactive avant que TCP ne commence à envoyer des sondes keepalive
temporary_data_in_cache_reserve_space_wait_lock_timeout_milliseconds
Délai d’attente pour verrouiller le cache lors de la réservation d’espace pour les données temporaires dans le cache du système de fichiers
throw_if_no_data_to_insert
Autorise ou interdit les INSERT vides. Ce paramètre est activé par défaut (et déclenche une erreur en cas d’insert vide). S’applique uniquement aux INSERT effectués avec clickhouse-client ou via l’interface gRPC.
timeout_before_checking_execution_speed
Vérifie que la vitesse d’exécution n’est pas trop faible (pas inférieure à min_execution_speed),
une fois le délai spécifié en secondes écoulé.
Détermine ce qui se passe lorsque la quantité de données dépasse l’une des limites.
Valeurs possibles :
throw : lever une exception (par défaut).
break : arrêter l’exécution de la requête et renvoyer un résultat partiel, comme si les
données source étaient épuisées.
Active l’égalité des valeurs NULL pour l’opérateur IN.
Par défaut, les valeurs NULL ne peuvent pas être comparées, car NULL désigne une valeur indéfinie. Ainsi, la comparaison expr = NULL doit toujours renvoyer false. Avec ce paramètre, NULL = NULL renvoie true pour l’opérateur IN.
Valeurs possibles :
- 0 — La comparaison des valeurs
NULL avec l’opérateur IN renvoie false.
- 1 — La comparaison des valeurs
NULL avec l’opérateur IN renvoie true.
Exemple
Considérez la table null_in :
Requête :
Résultat :
Requête :
Résultat :
Voir aussi
traverse_shadow_remote_data_paths
Parcourir les données gelées (répertoire shadow) en plus des données réelles de la table lors de l’interrogation de system.remote_data_paths
Définit un mode de combinaison des résultats des requêtes SELECT. Ce paramètre n’est utilisé que lorsqu’il est employé avec UNION sans préciser explicitement UNION ALL ou UNION DISTINCT.
Valeurs possibles :
'DISTINCT' — ClickHouse renvoie les lignes issues de la combinaison de requêtes en supprimant les lignes dupliquées.
'ALL' — ClickHouse renvoie toutes les lignes issues de la combinaison de requêtes, y compris les lignes dupliquées.
'' — ClickHouse génère une exception lorsqu’il est utilisé avec UNION.
Voir des exemples dans UNION.
unique_key_max_encoded_size
Taille maximale (en octets) de l’encodage binaire d’une seule ligne UNIQUE KEY qui préserve l’ordre.
unknown_packet_in_send_data
Envoyer un paquet inconnu à la place du n-ième paquet de données
variant_throw_on_type_mismatch
Lorsqu’une fonction est appliquée à une colonne Variant à l’aide de l’implémentation par défaut,
contrôle ce qui se passe pour les lignes dont le type réel est incompatible avec la fonction :
true (par défaut) — lever une exception.
false — renvoyer NULL pour ces lignes à la place.
wait_changes_become_visible_after_commit_mode
Attendre que les modifications validées deviennent réellement visibles dans le snapshot le plus récent
Nom de la charge de travail à utiliser pour accéder aux ressources
Écrit les chemins complets (y compris s3://) dans les fichiers de métadonnées Iceberg.
Permet de définir la taille maximale du journal de fenêtre de ZSTD (ne sera pas utilisé pour la famille MergeTree)