Skip to main content
Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.

add_http_cors_header

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

analyzer_inline_views

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.

cache_warmer_threads

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.

checksum_on_read

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.

convert_query_to_cnf

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.

decimal_check_overflow

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

describe_compact_output

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

Dialecte utilisé pour interpréter la requête

discard_query_data

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.

distinct_overflow_mode

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.

enforce_strict_identifier_format

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.

exact_rows_before_limit

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.

except_default_mode

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.

extract_key_value_pairs_max_pairs_per_row

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.

extremes

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.

final

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 :
  • 0 - désactivé
  • 1 - activé
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.

flatten_nested

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 :

fsync_metadata

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.

geotoh3_argument_order

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

handshake_timeout_ms

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 :
  • Entier positif.
Taille de la liste dynamique des candidats lors de la recherche dans l’index de similarité vectorielle, également appelée « ef_search ».

hsts_max_age

Durée d’expiration du HSTS. 0 signifie que le HSTS est désactivé.

idle_connection_timeout

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

interactive_delay

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.

intersect_default_mode

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.

limit

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.

lock_acquire_timeout

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.

make_distributed_plan

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

normalize_function_names

Ramener les noms de fonctions à leur forme canonique

offset

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.

per_part_index_stats

Enregistre les statistiques d’index pour chaque partie

poll_interval

Bloque dans la boucle d’attente des requêtes sur le serveur pendant le nombre de secondes spécifié.

polyglot_dialect

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

prefetch_buffer_size

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 :

priority

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

queue_max_wait_ms

Le temps d’attente dans la file de requêtes si le nombre de requêtes simultanées dépasse le maximum autorisé.

rabbitmq_max_wait_ms

Le délai d’attente avant une nouvelle tentative de lecture depuis RabbitMQ.

readonly

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 :
  • Entier positif.

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 (”%”).

Exemple

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

reserve_memory

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.

result_overflow_mode

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
Query
Result

rows_before_aggregation

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 :

session_timezone

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

set_overflow_mode

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

snappy_mode

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.

sort_overflow_mode

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.

tcp_keep_alive_timeout

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

transfer_overflow_mode

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.

transform_null_in

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

union_default_mode

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

workload

Nom de la charge de travail à utiliser pour accéder aux ressources

write_full_path_in_iceberg_metadata

Écrit les chemins complets (y compris s3://) dans les fichiers de métadonnées Iceberg.

zstd_window_log_max

Permet de définir la taille maximale du journal de fenêtre de ZSTD (ne sera pas utilisé pour la famille MergeTree)
Dernière modification le 24 juillet 2026