ClickHouse/docs/fr/operations/settings/settings.md

machine_translated	machine_translated_rev	toc_priority	toc_title
true	f865c9653f	60	Paramètre

Paramètre

distributed_product_mode

Modifie le comportement de distribués sous-requêtes.

ClickHouse applies this setting when the query contains the product of distributed tables, i.e. when the query for a distributed table contains a non-GLOBAL subquery for the distributed table.

Restriction:

• Uniquement appliqué pour les sous-requêtes IN et JOIN.
• Uniquement si la section FROM utilise une table distribuée contenant plus d'un fragment.
• Si la sous-requête concerne un distribué tableau contenant plus d'un fragment.
• Pas utilisé pour une table distant fonction.

Valeurs possibles:

• deny — Default value. Prohibits using these types of subqueries (returns the “Double-distributed in/JOIN subqueries is denied” exception).
• local — Replaces the database and table in the subquery with local ones for the destination server (shard), leaving the normal IN/JOIN.
• global — Replaces the IN/JOIN requête avec GLOBAL IN/GLOBAL JOIN.
• allow — Allows the use of these types of subqueries.

enable_optimize_predicate_expression

Active la poussée du prédicat SELECT requête.

Prédicat pushdown peut réduire considérablement le trafic réseau pour les requêtes distribuées.

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 1.

Utilisation

Considérez les requêtes suivantes:

1. SELECT count() FROM test_table WHERE date = '2018-10-10'
2. SELECT count() FROM (SELECT * FROM test_table) WHERE date = '2018-10-10'

Si enable_optimize_predicate_expression = 1, alors le temps d'exécution de ces requêtes est égal car ClickHouse s'applique WHERE à la sous-requête lors du traitement.

Si enable_optimize_predicate_expression = 0 puis le temps d'exécution de la deuxième requête est beaucoup plus long, parce que le WHERE la clause s'applique à toutes les données après la sous-requête des finitions.

fallback_to_stale_replicas_for_distributed_queries

Force une requête à un réplica obsolète si les données mises à jour ne sont pas disponibles. Voir Réplication.

ClickHouse sélectionne le plus pertinent parmi les répliques obsolètes de la table.

Utilisé lors de l'exécution SELECT à partir d'une table distribuée qui pointe vers des tables répliquées.

Par défaut, 1 (activé).

force_index_by_date

Désactive l'exécution de la requête si l'index ne peut pas être utilisé par jour.

Fonctionne avec les tables de la famille MergeTree.

Si force_index_by_date=1, Clickhouse vérifie si la requête a une condition de clé de date qui peut être utilisée pour restreindre les plages de données. S'il n'y a pas de condition appropriée, il lève une exception. Cependant, il ne vérifie pas si la condition réduit la quantité de données à lire. Par exemple, la condition Date != ' 2000-01-01 ' est acceptable même lorsqu'il correspond à toutes les données de la table (c'est-à-dire que l'exécution de la requête nécessite une analyse complète). Pour plus d'informations sur les plages de données dans les tables MergeTree, voir MergeTree.

force_primary_key

Désactive l'exécution de la requête si l'indexation par la clé primaire n'est pas possible.

Fonctionne avec les tables de la famille MergeTree.

Si force_primary_key=1, Clickhouse vérifie si la requête a une condition de clé primaire qui peut être utilisée pour restreindre les plages de données. S'il n'y a pas de condition appropriée, il lève une exception. Cependant, il ne vérifie pas si la condition réduit la quantité de données à lire. Pour plus d'informations sur les plages de données dans les tables MergeTree, voir MergeTree.

format_schema

Ce paramètre est utile lorsque vous utilisez des formats nécessitant une définition de schéma, tels que Cap'n Proto ou Protobuf. La valeur dépend du format.

fsync_metadata

Active ou désactive fsync lors de l'écriture .sql fichier. Activé par défaut.

Il est logique de le désactiver si le serveur a des millions de tables minuscules qui sont constamment créées et détruites.

enable_http_compression

Active ou désactive la compression de données dans la réponse à une requête HTTP.

Pour plus d'informations, lire l' Description de L'interface HTTP.

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 0.

http_zlib_compression_level

Définit le niveau de compression des données dans la réponse à une requête HTTP si enable_http_compression = 1.

Valeurs possibles: nombres de 1 à 9.

Valeur par défaut: 3.

http_native_compression_disable_checksumming_on_decompress

Active ou désactive la vérification de la somme de contrôle lors de la décompression des données HTTP POST du client. Utilisé uniquement pour le format de compression natif ClickHouse (non utilisé avec gzip ou deflate).

Pour plus d'informations, lire l' Description de L'interface HTTP.

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 0.

send_progress_in_http_headers

Active ou désactive X-ClickHouse-Progress - Têtes de réponse HTTP dans clickhouse-server réponse.

Pour plus d'informations, lire l' Description de L'interface HTTP.

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 0.

max_http_get_redirects

Limite le nombre maximal de sauts de redirection HTTP GET pour URL-tables de moteur. Le paramètre s'applique aux deux types de tables: celles créées par CREATE TABLE requête et par la URL table de fonction.

Valeurs possibles:

• Tout nombre entier positif de houblon.
• 0 — No hops allowed.

Valeur par défaut: 0.

input_format_allow_errors_num

Définit le nombre maximal d'erreurs acceptables lors de la lecture à partir de formats de texte (CSV, TSV, etc.).

La valeur par défaut est de 0.

Toujours le coupler avec input_format_allow_errors_ratio.

Si une erreur s'est produite lors de la lecture de lignes mais que le compteur d'erreurs est toujours inférieur à input_format_allow_errors_num, ClickHouse ignore la ligne et passe à la suivante.

Si les deux input_format_allow_errors_num et input_format_allow_errors_ratio sont dépassés, ClickHouse lève une exception.

input_format_allow_errors_ratio

Définit le pourcentage maximal d'erreurs autorisées lors de la lecture à partir de formats de texte (CSV, TSV, etc.). Le pourcentage d'erreurs est défini comme un nombre à virgule flottante compris entre 0 et 1.

La valeur par défaut est de 0.

Toujours le coupler avec input_format_allow_errors_num.

Si une erreur s'est produite lors de la lecture de lignes mais que le compteur d'erreurs est toujours inférieur à input_format_allow_errors_ratio, ClickHouse ignore la ligne et passe à la suivante.

Si les deux input_format_allow_errors_num et input_format_allow_errors_ratio sont dépassés, ClickHouse lève une exception.

input_format_values_interpret_expressions

Active ou désactive L'analyseur SQL complet si l'analyseur de flux rapide ne peut pas analyser les données. Ce paramètre est utilisé uniquement pour la Valeur format lors de l'insertion des données. Pour plus d'informations sur l'analyse syntaxique, consultez Syntaxe section.

Valeurs possibles:

• 0 — Disabled.

  Dans ce cas, vous devez fournir des données formatées. Voir la Format section.

• 1 — Enabled.

  Dans ce cas, vous pouvez utiliser une expression SQL en tant que valeur, mais l'insertion de données est beaucoup plus lente de cette façon. Si vous insérez uniquement des données formatées, ClickHouse se comporte comme si la valeur de réglage était 0.

Valeur par défaut: 1.

Exemple D'utilisation

Insérez le DateTime tapez valeur avec les différents paramètres.

SET input_format_values_interpret_expressions = 0;
INSERT INTO datetime_t VALUES (now())

Exception on client:
Code: 27. DB::Exception: Cannot parse input: expected ) before: now()): (at row 1)

SET input_format_values_interpret_expressions = 1;
INSERT INTO datetime_t VALUES (now())

Ok.

La dernière requête est équivalente à la suivante:

SET input_format_values_interpret_expressions = 0;
INSERT INTO datetime_t SELECT now()

Ok.

input_format_values_deduce_templates_of_expressions

Active ou désactive la déduction de modèle pour une expression SQL dans Valeur format. Il permet d'analyser et d'interpréter les expressions dans Values beaucoup plus rapide si les expressions dans des lignes consécutives ont la même structure. ClickHouse va essayer de déduire le modèle d'une expression, analyser les lignes suivantes en utilisant ce modèle et évaluer l'expression sur un lot de lignes analysées avec succès. Pour la requête suivante:

INSERT INTO test VALUES (lower('Hello')), (lower('world')), (lower('INSERT')), (upper('Values')), ...

• si input_format_values_interpret_expressions=1 et format_values_deduce_templates_of_expressions=0 les expressions seront interprétées séparément pour chaque ligne (Ceci est très lent pour un grand nombre de lignes)
• si input_format_values_interpret_expressions=0 et format_values_deduce_templates_of_expressions=1 expressions dans les première, deuxième et troisième lignes seront analysées à l'aide du modèle lower(String) et interprété ensemble, l'expression est la quatrième ligne sera analysée avec un autre modèle (upper(String))
• si input_format_values_interpret_expressions=1 et format_values_deduce_templates_of_expressions=1 - la même chose que dans le cas précédent, mais permet également d'interpréter les expressions séparément s'il n'est pas possible de déduire le modèle.

Activé par défaut.

input_format_values_accurate_types_of_literals

Ce paramètre est utilisé uniquement lorsque input_format_values_deduce_templates_of_expressions = 1. Il peut arriver que les expressions pour une colonne aient la même structure, mais contiennent des littéraux numériques de types différents, par exemple

(..., abs(0), ...),             -- UInt64 literal
(..., abs(3.141592654), ...),   -- Float64 literal
(..., abs(-1), ...),            -- Int64 literal

Lorsque ce paramètre est activé, ClickHouse vérifie le type réel de littéral et utilise un modèle d'expression du type correspondant. Dans certains cas, cela peut considérablement ralentir l'évaluation de l'expression dans Values. When disabled, ClickHouse may use more general type for some literals (e.g. Float64 ou Int64 plutôt UInt64 pour 42), mais cela peut causer des problèmes de débordement et de précision. Activé par défaut.

input_format_defaults_for_omitted_fields

Lors de l'exécution de INSERT requêtes, remplacez les valeurs de colonne d'entrée omises par les valeurs par défaut des colonnes respectives. Cette option s'applique uniquement aux JSONEachRow, CSV et TabSeparated format.

!!! note "Note" Lorsque cette option est activée, les métadonnées de table étendues sont envoyées du serveur au client. Il consomme des ressources informatiques supplémentaires sur le serveur et peut réduire les performances.

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 1.

input_format_tsv_empty_as_default

Lorsque cette option est activée, remplacez les champs de saisie vides dans TSV par des valeurs par défaut. Pour les expressions par défaut complexes input_format_defaults_for_omitted_fields doit être activé en trop.

Désactivé par défaut.

input_format_null_as_default

Active ou désactive l'utilisation des valeurs par défaut si les données NULL mais le type de données de la colonne correspondante dans pas Nullable(T) (pour les formats de saisie de texte).

input_format_skip_unknown_fields

Active ou désactive le saut d'insertion de données supplémentaires.

Lors de l'écriture de données, ClickHouse lève une exception si les données d'entrée contiennent des colonnes qui n'existent pas dans la table cible. Si le saut est activé, ClickHouse n'insère pas de données supplémentaires et ne lance pas d'exception.

Formats pris en charge:

• JSONEachRow
• CSVWithNames
• TabSeparatedWithNames
• TSKV

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 0.

input_format_import_nested_json

Active ou désactive l'insertion de données JSON avec des objets imbriqués.

Formats pris en charge:

• JSONEachRow

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 0.

Voir aussi:

• Utilisation de Structures imbriquées avec l' JSONEachRow format.

input_format_with_names_use_header

Active ou désactive la vérification de l'ordre des colonnes lors de l'insertion de données.

Pour améliorer les performances d'insertion, nous vous recommandons de désactiver cette vérification si vous êtes sûr que l'ordre des colonnes des données d'entrée est le même que dans la table cible.

Formats pris en charge:

• CSVWithNames
• TabSeparatedWithNames

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 1.

date_time_input_format

Permet de choisir un analyseur de la représentation textuelle de la date et de l'heure.

Le réglage ne s'applique pas à fonctions date et heure.

Valeurs possibles:

• 'best_effort' — Enables extended parsing.

  ClickHouse peut analyser la base YYYY-MM-DD HH:MM:SS format et tous ISO 8601 formats de date et heure. Exemple, '2018-06-08T01:02:03.000Z'.

• 'basic' — Use basic parser.

  ClickHouse ne peut analyser que la base YYYY-MM-DD HH:MM:SS format. Exemple, '2019-08-20 10:18:56'.

Valeur par défaut: 'basic'.

Voir aussi:

• Type de données DateTime.
• Fonctions pour travailler avec des dates et des heures.

join_default_strictness

Définit la rigueur par défaut pour JOIN clauses.

Valeurs possibles:

• ALL — If the right table has several matching rows, ClickHouse creates a Produit cartésien à partir des lignes correspondantes. C'est normal JOIN comportement de SQL standard.
• ANY — If the right table has several matching rows, only the first one found is joined. If the right table has only one matching row, the results of ANY et ALL sont les mêmes.
• ASOF — For joining sequences with an uncertain match.
• Empty string — If ALL ou ANY n'est pas spécifié dans la requête, ClickHouse lève une exception.

Valeur par défaut: ALL.

join_any_take_last_row

Modifie le comportement des opérations de jointure avec ANY rigueur.

!!! warning "Attention" Ce paramètre s'applique uniquement pour JOIN opérations avec Rejoindre le moteur de tables.

Valeurs possibles:

• 0 — If the right table has more than one matching row, only the first one found is joined.
• 1 — If the right table has more than one matching row, only the last one found is joined.

Valeur par défaut: 0.

Voir aussi:

• Clause de JOINTURE
• Rejoindre le moteur de table
• join_default_strictness

join_use_nulls

Définit le type de JOIN comportement. Lors de la fusion de tables, des cellules vides peuvent apparaître. ClickHouse les remplit différemment en fonction de ce paramètre.

Valeurs possibles:

• 0 — The empty cells are filled with the default value of the corresponding field type.
• 1 — JOIN se comporte de la même manière que dans SQL standard. Le type du champ correspondant est converti en Nullable et les cellules vides sont remplis avec NULL.

Valeur par défaut: 0.

max_block_size

Dans ClickHouse, les données sont traitées par Blocs (Ensembles de parties de colonne). Les cycles de traitement internes pour un seul bloc sont assez efficaces, mais il y a des dépenses notables sur chaque bloc. Le max_block_size le paramètre est une recommandation pour la taille du bloc (dans un nombre de lignes) à charger à partir des tables. La taille du bloc ne doit pas être trop petite, de sorte que les dépenses sur chaque bloc sont toujours perceptibles, mais pas trop grande pour que la requête avec limite qui est terminée après le premier bloc soit traitée rapidement. L'objectif est d'éviter de consommer trop de mémoire lors de l'extraction d'un grand nombre de colonnes dans plusieurs threads et de préserver au moins certains localité de cache.

Valeur par défaut: de 65 536.

Les blocs de la taille de max_block_size ne sont pas toujours chargées de la table. Si il est évident que moins de données doivent être récupérées, un bloc plus petit est traitée.

preferred_block_size_bytes

Utilisé dans le même but que max_block_size, mais il définit la taille de bloc recommandée en octets en l'adaptant au nombre de lignes dans le bloc. Cependant, la taille du bloc ne peut pas être supérieure à max_block_size rangée. Par défaut: 1 000 000. Cela ne fonctionne que lors de la lecture des moteurs MergeTree.

merge_tree_min_rows_for_concurrent_read

Si le nombre de lignes à lire à partir d'un fichier d'un MergeTree table dépasse merge_tree_min_rows_for_concurrent_read ensuite, ClickHouse essaie d'effectuer une lecture simultanée de ce fichier sur plusieurs threads.

Valeurs possibles:

• Tout nombre entier positif.

Valeur par défaut: 163840.

merge_tree_min_bytes_for_concurrent_read

Si le nombre d'octets à lire à partir d'un fichier d'un MergeTree- table de moteur dépasse merge_tree_min_bytes_for_concurrent_read puis ClickHouse essaie de lire simultanément à partir de ce fichier dans plusieurs threads.

Valeur Possible:

• Tout nombre entier positif.

Valeur par défaut: 251658240.

merge_tree_min_rows_for_seek

Si la distance entre deux blocs de données à lire dans un fichier est inférieure à merge_tree_min_rows_for_seek lignes, puis ClickHouse ne cherche pas à travers le fichier mais lit les données séquentiellement.

Valeurs possibles:

• Tout nombre entier positif.

Valeur par défaut: 0.

merge_tree_min_bytes_for_seek

Si la distance entre deux blocs de données à lire dans un fichier est inférieure à merge_tree_min_bytes_for_seek octets, puis ClickHouse lit séquentiellement une plage de fichier qui contient les deux blocs, évitant ainsi la recherche supplémentaire.

Valeurs possibles:

• Tout nombre entier positif.

Valeur par défaut: 0.

merge_tree_coarse_index_granularité

Lors de la recherche de données, ClickHouse vérifie les marques de données dans le fichier d'index. Si ClickHouse trouve que les clés requises sont dans une certaine plage, il divise cette plage en merge_tree_coarse_index_granularity subranges et recherche les clés requises récursivement.

Valeurs possibles:

• Tout entier pair positif.

Valeur par défaut: 8.

merge_tree_max_rows_to_use_cache

Si ClickHouse devrait lire plus de merge_tree_max_rows_to_use_cache lignes dans une 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 protège le cache contre le saccage par les requêtes qui lisent une grande quantité de données. Le uncompressed_cache_size le paramètre serveur définit la taille du cache des blocs non compressés.

Valeurs possibles:

• Tout nombre entier positif.

Default value: 128 ✕ 8192.

merge_tree_max_bytes_to_use_cache

Si ClickHouse devrait lire plus de merge_tree_max_bytes_to_use_cache octets dans une requête, il n'utilise pas le cache de non compressé blocs.

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 protège le cache contre le saccage par les requêtes qui lisent une grande quantité de données. Le uncompressed_cache_size le paramètre serveur définit la taille du cache des blocs non compressés.

Valeur Possible:

• Tout nombre entier positif.

Valeur par défaut: 2013265920.

min_bytes_to_use_direct_io

Volume de données minimum requis pour utiliser l'accès direct aux E/S sur le disque de stockage.

ClickHouse utilise ce paramètre lors de la lecture de données à partir de tables. Si le volume total de stockage de toutes les données à lire dépasse min_bytes_to_use_direct_io octets, puis ClickHouse lit les données du disque de stockage avec le O_DIRECT option.

Valeurs possibles:

• 0 — Direct I/O is disabled.
• Entier positif.

Valeur par défaut: 0.

log_queries

Configuration de la journalisation des requêtes.

Les requêtes envoyées à ClickHouse avec cette configuration sont enregistrées selon les règles du query_log paramètre de configuration du serveur.

Exemple:

log_queries=1

log_query_threads

Configuration de la journalisation des threads de requête.

Les threads de requêtes exécutés par ClickHouse avec cette configuration sont journalisés selon les règles du query_thread_log paramètre de configuration du serveur.

Exemple:

log_query_threads=1

max_insert_block_size

La taille des blocs à former pour l'insertion dans une table. Ce paramètre s'applique uniquement dans les cas où le serveur formes les blocs. Par exemple, pour une insertion via L'interface HTTP, le serveur analyse le format de données et forme des blocs de la taille spécifiée. Mais lors de l'utilisation de clickhouse-client, le client analyse les données ‘max_insert_block_size’ le réglage sur le serveur n'affecte pas la taille des blocs insérés. Le paramètre n'a pas non plus de but lors de L'utilisation D'INSERT SELECT, car les données sont insérées à l'aide des mêmes blocs qui sont formés après SELECT.

Valeur par défaut: 1 048 576 octets.

La valeur par défaut est légèrement supérieure à max_block_size. La raison en est que certains moteurs de table (*MergeTree) former une partie de données sur le disque pour chaque bloc inséré, qui est une entité assez grande. Pareillement, *MergeTree les tables trient les données lors de l'insertion et une taille de bloc suffisamment grande permet de trier plus de données dans la RAM.

max_replica_delay_for_distributed_queries

Désactive les répliques en retard pour les requêtes distribuées. Voir Réplication.

Définit le temps en secondes. Si une réplique accuse plus de retard que la valeur définie, cette réplique n'est pas utilisée.

Valeur par défaut: 300.

Utilisé lors de l'exécution SELECT à partir d'une table distribuée qui pointe vers des tables répliquées.

max_threads

Nombre maximal de threads de traitement des requêtes, à l'exclusion des threads de récupération de données à partir de serveurs distants (voir ‘max_distributed_connections’ paramètre).

Ce paramètre s'applique aux threads qui effectuent les mêmes étapes du pipeline de traitement des requêtes en parallèle. Par exemple, lors de la lecture d'une table, s'il est possible d'évaluer des expressions avec des fonctions, filtrer avec WHERE et pré-agréger pour GROUP BY en parallèle en utilisant au moins ‘max_threads’ nombre de threads, puis ‘max_threads’ sont utilisés.

Valeur par défaut: nombre de cœurs de processeur physiques.

Si moins d'une requête SELECT est normalement exécutée sur un serveur à la fois, définissez ce paramètre sur une valeur légèrement inférieure au nombre réel de cœurs de processeur.

Pour les requêtes qui sont terminées rapidement en raison d'une limite, vous pouvez définir une valeur inférieure ‘max_threads’. Par exemple, si le nombre d'entrées se trouvent dans chaque bloc et max_threads = 8, 8 blocs sont récupérées, même s'il aurait été suffisante pour lire un seul.

Le plus petit de la max_threads valeur, moins la mémoire est consommée.

max_insert_threads

Nombre maximal de threads à exécuter INSERT SELECT requête.

Valeurs possibles:

• 0 (or 1) — INSERT SELECT pas d'exécution parallèle.
• Entier positif. Plus grand que 1.

Valeur par défaut: 0.

Parallèle INSERT SELECT n'a d'effet que si l' SELECT une partie est exécutée en parallèle, voir max_threads paramètre. Des valeurs plus élevées conduiront à une utilisation de la mémoire plus élevée.

max_compress_block_size

La taille maximale des blocs de données non compressées avant la compression pour l'écriture dans une table. Par défaut, 1 048 576 (1 MiB). Si la taille est réduite, le taux de compression est considérablement réduit, la vitesse de compression et de décompression augmente légèrement en raison de la localisation du cache, et la consommation de mémoire est réduite. Il n'y aucune raison de modifier ce paramètre.

Ne confondez pas les blocs pour la compression (un morceau de mémoire constitué d'octets) avec des blocs pour le traitement des requêtes (Un ensemble de lignes d'une table).

min_compress_block_size

Pour MergeTree" table. Afin de réduire la latence lors du traitement des requêtes, un bloc est compressé lors de l'écriture de la marque suivante si sa taille est au moins ‘min_compress_block_size’. Par défaut, 65 536.

La taille réelle du bloc, si les données non compressées sont inférieures à ‘max_compress_block_size’ pas moins de cette valeur et pas moins que le volume de données pour une marque.

Regardons un exemple. Supposons que ‘index_granularity’ a 8192 lors de la création de la table.

Nous écrivons une colonne de type UInt32 (4 octets par valeur). Lors de l'écriture de 8192 lignes, le total sera de 32 KO de données. Puisque min_compress_block_size = 65 536, un bloc compressé sera formé pour toutes les deux marques.

Nous écrivons une colonne URL avec le type de chaîne (taille moyenne de 60 octets par valeur). Lors de l'écriture de 8192 lignes, la moyenne sera légèrement inférieure à 500 Ko de données. Comme il s'agit de plus de 65 536, un bloc compressé sera formé pour chaque marque. Dans ce cas, lors de la lecture de données du disque dans la plage d'une seule marque, les données supplémentaires ne seront pas décompressées.

Il n'y aucune raison de modifier ce paramètre.

max_query_size

La partie maximale d'une requête qui peut être prise en RAM pour l'analyse avec L'analyseur SQL. La requête INSERT contient également des données pour INSERT qui sont traitées par un analyseur de flux séparé (qui consomme O (1) RAM), qui n'est pas inclus dans cette restriction.

Valeur par défaut: 256 Ko.

interactive_delay

Intervalle en microsecondes pour vérifier si l'exécution de la requête a été annulée et envoyer la progression.

Valeur par défaut: 100 000 (vérifie l'Annulation et envoie la progression dix fois par seconde).

connect_timeout, receive_timeout, send_timeout

Délais d'attente en secondes sur le socket utilisé pour communiquer avec le client.

Valeur par défaut: 10, 300, 300.

cancel_http_readonly_queries_on_client_close

Cancels HTTP read-only queries (e.g. SELECT) when a client closes the connection without waiting for the response.

Valeur par défaut: 0

poll_interval

Verrouillez une boucle d'attente pendant le nombre de secondes spécifié.

Valeur par défaut: 10.

max_distributed_connections

Nombre maximal de connexions simultanées avec des serveurs distants pour le traitement distribué d'une seule requête vers une seule table distribuée. Nous vous recommandons de définir une valeur au moins égale au nombre de serveurs dans le cluster.

Valeur par défaut: 1024.

Les paramètres suivants ne sont utilisés que lors de la création de tables distribuées (et lors du lancement d'un serveur), il n'y a donc aucune raison de les modifier lors de l'exécution.

distributed_connections_pool_size

Nombre maximal de connexions simultanées avec des serveurs distants pour le traitement distribué de toutes les requêtes vers une seule table distribuée. Nous vous recommandons de définir une valeur au moins égale au nombre de serveurs dans le cluster.

Valeur par défaut: 1024.

connect_timeout_with_failover_ms

Délai d'attente en millisecondes pour la connexion à un serveur distant pour un moteur de table distribué, si ‘shard’ et ‘replica’ les sections sont utilisées dans la définition du cluster. En cas d'échec, plusieurs tentatives sont faites pour se connecter à diverses répliques.

Valeur par défaut: 50.

connections_with_failover_max_tries

Nombre maximal de tentatives de connexion avec chaque réplique pour le moteur de table distribué.

Valeur par défaut: 3.

extrême

Indique s'il faut compter les valeurs extrêmes (les minimums et les maximums dans les colonnes d'un résultat de requête). Accepte 0 ou 1. Par défaut, 0 (désactivé). Pour plus d'informations, consultez la section “Extreme values”.

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 lorsque vous travaillez avec un grand nombre de requêtes courtes. Activez ce paramètre pour les utilisateurs qui envoient des requêtes courtes fréquentes. Faites également attention à la uncompressed_cache_size configuration parameter (only set in the config file) – the size of uncompressed cache blocks. By default, it is 8 GiB. The uncompressed cache is filled in as needed and the least-used data is automatically deleted.

Pour les requêtes qui lisent au moins un volume de données assez important (un million de lignes ou plus), le cache non compressé est désactivé automatiquement pour économiser de l'espace pour les requêtes vraiment petites. Cela signifie que vous pouvez garder la ‘use_uncompressed_cache’ toujours la valeur 1.

replace_running_query

Lors de l'utilisation de L'interface HTTP, le ‘query_id’ le paramètre peut être passé. C'est n'importe quelle chaîne qui sert d'Identificateur de requête. Si une requête d'un utilisateur avec le même ‘query_id’ il existe déjà à ce moment, le comportement dépend de la ‘replace_running_query’ paramètre.

0 (default) – Throw an exception (don't allow the query to run if a query with the same ‘query_id’ est déjà en cours d'exécution).

1 – Cancel the old query and start running the new one.

Yandex.Metrica utilise ce paramètre défini sur 1 pour implémenter des suggestions de conditions de segmentation. Après avoir entré le caractère suivant, si l'ancienne requête n'est pas encore terminée, elle doit être annulée.

stream_flush_interval_ms

Fonctionne pour les tables avec des flux dans le cas d'une expiration, ou lorsqu'un thread génère max_insert_block_size rangée.

La valeur par défaut est 7500.

Plus la valeur est petite, plus les données sont vidées dans la table. Régler la valeur trop faible entraîne de mauvaises performances.

équilibrage

Spécifie l'algorithme de sélection des réplicas utilisé pour le traitement des requêtes distribuées.

ClickHouse prend en charge les algorithmes suivants de choix des répliques:

• Aléatoire (par défaut)
• Nom d'hôte le plus proche
• Afin
• Premier ou aléatoire

Aléatoire (par défaut)

load_balancing = random

Le nombre d'erreurs est compté pour chaque réplique. La requête est envoyée au réplica avec le moins d'erreurs, et s'il y en a plusieurs, à n'importe qui d'entre eux. Inconvénients: la proximité du serveur n'est pas prise en compte; si les répliques ont des données différentes, vous obtiendrez également des données différentes.

Nom D'Hôte Le Plus Proche

load_balancing = nearest_hostname

The number of errors is counted for each replica. Every 5 minutes, the number of errors is integrally divided by 2. Thus, the number of errors is calculated for a recent time with exponential smoothing. If there is one replica with a minimal number of errors (i.e. errors occurred recently on the other replicas), the query is sent to it. If there are multiple replicas with the same minimal number of errors, the query is sent to the replica with a hostname that is most similar to the server's hostname in the config file (for the number of different characters in identical positions, up to the minimum length of both hostnames).

Par exemple, exemple01-01-1 et example01-01-2.yandex.ru sont différents dans une position, tandis que l'exemple01-01-1 et l'exemple01-02-2 diffèrent dans deux endroits. Cette méthode peut sembler primitive, mais elle ne nécessite pas de données externes sur la topologie du réseau, et elle ne compare pas les adresses IP, ce qui serait compliqué pour nos adresses IPv6.

Ainsi, s'il existe des répliques équivalentes, la plus proche par son nom est préférée. Nous pouvons également supposer que lors de l'envoi d'une requête au même serveur, en l'absence d'Échecs, une requête distribuée ira également aux mêmes serveurs. Ainsi, même si des données différentes sont placées sur les répliques, la requête retournera principalement les mêmes résultats.

Afin

load_balancing = in_order

Répliques avec le même nombre d'erreurs sont accessibles dans le même ordre qu'ils sont définis dans la configuration. Cette méthode est appropriée lorsque vous savez exactement quelle réplique est préférable.

Premier ou aléatoire

load_balancing = first_or_random

Cet algorithme choisit la première réplique de l'ensemble ou une réplique aléatoire si la première n'est pas disponible. Il est efficace dans les configurations de topologie de réplication croisée, mais inutile dans d'autres configurations.

Le first_or_random algorithme résout le problème de la in_order algorithme. Avec in_order, si une réplique tombe en panne, la suivante obtient une double charge tandis que les répliques restantes gèrent la quantité habituelle de trafic. Lors de l'utilisation de la first_or_random algorithme, la charge est répartie uniformément entre les répliques qui sont encore disponibles.

prefer_localhost_replica

Active / désactive préférable d'utiliser le réplica localhost lors du traitement des requêtes distribuées.

Valeurs possibles:

• 1 — ClickHouse always sends a query to the localhost replica if it exists.
• 0 — ClickHouse uses the balancing strategy specified by the équilibrage paramètre.

Valeur par défaut: 1.

!!! warning "Avertissement" Désactivez ce paramètre si vous utilisez max_parallel_replicas.

totals_mode

Comment calculer les totaux lorsque HAVING est présent, ainsi que lorsque max_rows_to_group_by et group_by_overflow_mode = ‘any’ sont présents. Voir la section “WITH TOTALS modifier”.

totals_auto_threshold

Le seuil de totals_mode = 'auto'. Voir la section “WITH TOTALS modifier”.

max_parallel_replicas

Nombre maximal de répliques pour chaque fragment lors de l'exécution d'une requête. Par souci de cohérence (pour obtenir différentes parties du même partage de données), Cette option ne fonctionne que lorsque la clé d'échantillonnage est définie. Le retard de réplique n'est pas contrôlé.

compiler

Activer la compilation des requêtes. Par défaut, 0 (désactivé).

La compilation n'est utilisée que pour une partie du pipeline de traitement des requêtes: pour la première étape de l'agrégation (GROUP BY). Si cette partie du pipeline a été compilée, la requête peut s'exécuter plus rapidement en raison du déploiement de cycles courts et des appels de fonction d'agrégation intégrés. L'amélioration maximale des performances (jusqu'à quatre fois plus rapide dans de rares cas) est observée pour les requêtes avec plusieurs fonctions d'agrégat simples. Typiquement, le gain de performance est insignifiant. Dans de très rares cas, il peut ralentir l'exécution de la requête.

min_count_to_compile

Combien de fois utiliser potentiellement un morceau de code compilé avant d'exécuter la compilation. Par défaut, 3. For testing, the value can be set to 0: compilation runs synchronously and the query waits for the end of the compilation process before continuing execution. For all other cases, use values ​​starting with 1. Compilation normally takes about 5-10 seconds. Si la valeur est 1 ou plus, la compilation se produit de manière asynchrone dans un thread séparé. Le résultat sera utilisé dès qu'il sera prêt, y compris les requêtes en cours d'exécution.

Le code compilé est requis pour chaque combinaison différente de fonctions d'agrégat utilisées dans la requête et le type de clés dans la clause GROUP BY. The results of the compilation are saved in the build directory in the form of .so files. There is no restriction on the number of compilation results since they don't use very much space. Old results will be used after server restarts, except in the case of a server upgrade – in this case, the old results are deleted.

output_format_json_quote_64bit_integers

Si la valeur est true, les entiers apparaissent entre guillemets lors de l'utilisation des formats JSON* Int64 et UInt64 (pour la compatibilité avec la plupart des implémentations JavaScript); sinon, les entiers sont sortis sans les guillemets.

format_csv_delimiter

Caractère interprété comme un délimiteur dans les données CSV. Par défaut, le délimiteur est ,.

input_format_csv_unquoted_null_literal_as_null

Pour le format D'entrée CSV active ou désactive l'analyse des NULL comme littéral (synonyme de \N).

output_format_csv_crlf_end_of_line

Utilisez le séparateur de ligne de style DOS/Windows (CRLF) en CSV au lieu du style Unix (LF).

output_format_tsv_crlf_end_of_line

Utilisez le séparateur de ligne de style DOC/Windows (CRLF) dans TSV au lieu du style Unix (LF).

insert_quorum

Active les Écritures de quorum.

• Si insert_quorum < 2, les Écritures de quorum sont désactivées.
• Si insert_quorum >= 2, les Écritures de quorum sont activées.

Valeur par défaut: 0.

Quorum écrit

INSERT ne réussit que lorsque ClickHouse parvient à écrire correctement les données insert_quorum des répliques au cours de la insert_quorum_timeout. Si, pour une raison quelconque, le nombre de répliques avec succès écrit n'atteint pas le insert_quorum, l'écriture est considérée comme ayant échoué et ClickHouse supprimera le bloc inséré de toutes les répliques où les données ont déjà été écrites.

Toutes les répliques du quorum sont cohérentes, c'est-à-dire qu'elles contiennent des données de toutes les INSERT requête. Le INSERT la séquence est linéarisé.

Lors de la lecture des données écrites à partir du insert_quorum, vous pouvez utiliser le select_sequential_consistency option.

Clickhouse génère une exception

• Si le nombre de répliques au moment de la requête est inférieure à la insert_quorum.
• Lors d'une tentative d'écriture de données lorsque le bloc précédent n'a pas encore été inséré dans le insert_quorum des répliques. Cette situation peut se produire si l'utilisateur tente d'effectuer une INSERT avant le précédent avec le insert_quorum est terminé.

Voir aussi:

• insert_quorum_timeout
• select_sequential_consistency

insert_quorum_timeout

Ecrire dans quorum timeout en secondes. Si le délai d'attente est passé et qu'aucune écriture n'a encore eu lieu, ClickHouse génère une exception et le client doit répéter la requête pour écrire le même bloc dans le même réplica ou tout autre réplica.

Valeur par défaut: 60 secondes.

Voir aussi:

• insert_quorum
• select_sequential_consistency

select_sequential_consistency

Active ou désactive la cohérence séquentielle pour SELECT requête:

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 0.

Utilisation

Lorsque la cohérence séquentielle est activée, ClickHouse permet au client d'exécuter SELECT requête uniquement pour les répliques qui contiennent des données de toutes les INSERT requêtes exécutées avec insert_quorum. Si le client fait référence à une réplique partielle, ClickHouse génère une exception. La requête SELECT n'inclut pas les données qui n'ont pas encore été écrites dans le quorum des répliques.

Voir aussi:

• insert_quorum
• insert_quorum_timeout

insert_deduplicate

Active ou désactive la déduplication des blocs INSERT (Répliqués* les tableaux).

Valeurs possibles:

• 0 — Disabled.
• 1 — Enabled.

Valeur par défaut: 1.

Par défaut, les blocs insérés dans les tables répliquées INSERT déclaration sont dédupliquées (voir [Réplication de Données] (../moteurs/table_engines/mergetree_family/réplication.md).

déduplicate_blocks_in_dependent_materialized_views

Active ou désactive la vérification de déduplication des vues matérialisées qui reçoivent des données à partir de tables* répliquées.

Valeurs possibles:

  0 — Disabled.
  1 — Enabled.

Valeur par défaut: 0.

Utilisation

Par défaut, la déduplication n'est pas effectuée pour les vues matérialisées mais en amont, dans la table source. Si un bloc inséré est ignoré en raison de la déduplication dans la table source, il n'y aura pas d'insertion dans les vues matérialisées attachées. Ce comportement existe pour permettre l'insertion de données hautement agrégées dans des vues matérialisées, dans les cas où les blocs insérés sont les mêmes après l'agrégation de vues matérialisées mais dérivés de différentes insertions dans la table source. Dans le même temps, ce comportement “breaks” INSERT idempotence. Si un INSERT dans la table principale a été un succès et INSERT into a materialized view failed (e.g. because of communication failure with Zookeeper) a client will get an error and can retry the operation. However, the materialized view won't receive the second insert because it will be discarded by deduplication in the main (source) table. The setting deduplicate_blocks_in_dependent_materialized_views permet de changer ce comportement. Lors d'une nouvelle tentative, une vue matérialisée recevra l'insertion répétée et effectuera une vérification de déduplication par elle-même, ignorant le résultat de la vérification pour la table source, et insérera des lignes perdues en raison de la première défaillance.

max_network_bytes

Limite le volume de données (en octets) qui est reçu ou transmis sur le réseau lors de l'exécution d'une requête. Ce paramètre s'applique à chaque individu requête.

Valeurs possibles:

• Entier positif.
• 0 — Data volume control is disabled.

Valeur par défaut: 0.

max_network_bandwidth

Limite la vitesse de l'échange de données sur le réseau en octets par seconde. Ce paramètre s'applique à toutes les requêtes.

Valeurs possibles:

• Entier positif.
• 0 — Bandwidth control is disabled.

Valeur par défaut: 0.

max_network_bandwidth_for_user

Limite la vitesse de l'échange de données sur le réseau en octets par seconde. Ce paramètre s'applique à toutes les requêtes exécutées simultanément par un seul utilisateur.

Valeurs possibles:

• Entier positif.
• 0 — Control of the data speed is disabled.

Valeur par défaut: 0.

max_network_bandwidth_for_all_users

Limite la vitesse à laquelle les données sont échangées sur le réseau en octets par seconde. Ce paramètre s'applique à toutes les requêtes exécutées simultanément sur le serveur.

Valeurs possibles:

• Entier positif.
• 0 — Control of the data speed is disabled.

Valeur par défaut: 0.

count_distinct_implementation

Spécifie de l' uniq* les fonctions doivent être utilisées pour COUNT(DISTINCT …) construction.

Valeurs possibles:

• uniq
• uniqcombiné
• uniqCombined64
• uniqHLL12
• uniqExact

Valeur par défaut: uniqExact.

skip_unavailable_shards

Active ou désactive le saut silencieux des fragments indisponibles.

Tesson est considéré comme indisponible si toutes ses répliques ne sont pas disponibles. Une réplique n'est pas disponible dans les cas suivants:

• ClickHouse ne peut pas se connecter à la réplique pour une raison quelconque.

  Lors de la connexion à une réplique, ClickHouse effectue plusieurs tentatives. Si toutes ces tentatives échouent, la réplique est considéré comme indisponible.

• La réplique ne peut pas être résolue via le DNS.

  Si le nom d'hôte du réplica ne peut pas être résolu via DNS, il peut indiquer les situations suivantes:

  • L'hôte de la réplique n'a pas d'enregistrement DNS. Il peut se produire dans les systèmes avec DNS dynamique, par exemple, Kubernetes, où les nœuds peuvent être insolubles pendant les temps d'arrêt, et ce n'est pas une erreur.

  • Erreur de Configuration. Le fichier de configuration ClickHouse contient un mauvais nom d'hôte.

Valeurs possibles:

• 1 — skipping enabled.

  Si un fragment n'est pas disponible, ClickHouse renvoie un résultat basé sur des données partielles et ne signale pas les problèmes de disponibilité des nœuds.

• 0 — skipping disabled.

  Si un fragment n'est pas disponible, ClickHouse lève une exception.

Valeur par défaut: 0.

optimize_skip_unused_shards

Active ou désactive le saut des fragments inutilisés pour les requêtes SELECT qui ont la condition de clé de sharding dans PREWHERE/WHERE (suppose que les données sont distribuées par la clé de sharding, sinon ne rien faire).

Valeur par défaut: 0

force_optimize_skip_unused_shards

Active ou désactive l'exécution de la requête si optimize_skip_unused_shards activé et sauter des fragments inutilisés n'est pas possible. Si le saut n'est pas possible et le paramètre est activé, une exception sera levée.

Valeurs possibles:

• 0 - Désactivé (ne jette)
• 1-Désactiver l'exécution de la requête uniquement si la table a une clé de sharding
• 2-Désactiver l'exécution de la requête quelle que soit la clé de sharding est définie pour la table

Valeur par défaut: 0

force_optimize_skip_unused_shards_no_nested

Réinitialiser optimize_skip_unused_shards pour imbriquée Distributed table

Valeurs possibles:

• 1 — Enabled.
• 0 — Disabled.

Valeur par défaut: 0.

optimize_throw_if_noop

Active ou désactive le lancement d'une exception si OPTIMIZE la requête n'a pas effectué de fusion.

Par défaut, OPTIMIZE retourne avec succès même s'il n'a rien fait. Ce paramètre vous permet de différencier ces situations et d'obtenir la raison dans un message d'exception.

Valeurs possibles:

• 1 — Throwing an exception is enabled.
• 0 — Throwing an exception is disabled.

Valeur par défaut: 0.

distributed_replica_error_half_life

• Type: secondes
• Valeur par défaut: 60 secondes

Contrôle la vitesse à laquelle les erreurs dans les tables distribuées sont mises à zéro. Si une réplique est indisponible pendant un certain temps, accumule 5 erreurs et distributed_replica_error_half_life est défini sur 1 seconde, la réplique est considérée comme normale 3 secondes après la dernière erreur.

Voir aussi:

• Tableau moteur Distribués
• distributed_replica_error_cap

distributed_replica_error_cap

• Type: unsigned int
• Valeur par défaut: 1000

Le nombre d'erreurs de chaque réplique est plafonné à cette valeur, empêchant une seule réplique d'accumuler trop d'erreurs.

Voir aussi:

• Tableau moteur Distribués
• distributed_replica_error_half_life

distributed_directory_monitor_sleep_time_ms

Intervalle de Base pour le Distribué tableau moteur à envoyer des données. L'intervalle réel augmente de façon exponentielle en cas d'erreurs.

Valeurs possibles:

• Un nombre entier positif de millisecondes.

Valeur par défaut: 100 millisecondes.

distributed_directory_monitor_max_sleep_time_ms

Intervalle maximal pour le Distribué tableau moteur à envoyer des données. Limite la croissance exponentielle de l'intervalle défini dans distributed_directory_monitor_sleep_time_ms paramètre.

Valeurs possibles:

• Un nombre entier positif de millisecondes.

Valeur par défaut: 30000 millisecondes (30 secondes).

distributed_directory_monitor_batch_inserts

Active / désactive l'envoi des données insérées par lots.

Lorsque l'envoi par lots est activé, le Distribué tableau moteur essaie d'envoyer plusieurs fichiers de données insérées dans une seule opération au lieu de les envoyer séparément. L'envoi par lots améliore les performances du cluster en utilisant mieux les ressources du serveur et du réseau.

Valeurs possibles:

• 1 — Enabled.
• 0 — Disabled.

Valeur par défaut: 0.

os_thread_priority

Définit la priorité (beau) pour les threads qui exécutent des requêtes. Le planificateur du système d'exploitation considère cette priorité lors du choix du prochain thread à exécuter sur chaque noyau CPU disponible.

!!! warning "Avertissement" Pour utiliser ce paramètre, vous devez définir l' CAP_SYS_NICE capacité. Le clickhouse-server paquet configure lors de l'installation. Certains environnements virtuels ne vous permettent pas de définir CAP_SYS_NICE capacité. Dans ce cas, clickhouse-server affiche un message à ce sujet au début.

Valeurs possibles:

• Vous pouvez définir des valeurs dans la gamme [-20, 19].

Des valeurs plus faibles signifient une priorité plus élevée. Les discussions avec des bas nice les valeurs de priorité sont effectués plus fréquemment que les discussions avec des valeurs élevées. Les valeurs élevées sont préférables pour les requêtes non interactives de longue durée, car elles leur permettent d'abandonner rapidement des ressources au profit de requêtes interactives courtes lorsqu'elles arrivent.

Valeur par défaut: 0.

query_profiler_real_time_period_ns

Définit la période pour une horloge réelle de la requête profiler. La vraie minuterie d'horloge compte le temps d'horloge murale.

Valeurs possibles:

• Nombre entier positif, en nanosecondes.

  Valeurs recommandées:

      - 10000000 (100 times a second) nanoseconds and less for single queries.
      - 1000000000 (once a second) for cluster-wide profiling.
  

• 0 pour éteindre la minuterie.

Type: UInt64.

Valeur par défaut: 1000000000 nanosecondes (une fois par seconde).

Voir aussi:

• Système de table trace_log

query_profiler_cpu_time_period_ns

Définit la période pour une minuterie D'horloge CPU du requête profiler. Cette minuterie ne compte que le temps CPU.

Valeurs possibles:

• Un nombre entier positif de nanosecondes.

  Valeurs recommandées:

      - 10000000 (100 times a second) nanoseconds and more for single queries.
      - 1000000000 (once a second) for cluster-wide profiling.
  

• 0 pour éteindre la minuterie.

Type: UInt64.

Valeur par défaut: 1000000000 nanosecondes.

Voir aussi:

• Système de table trace_log

allow_introspection_functions

Active des désactive obscures fonctions pour le profilage de requête.

Valeurs possibles:

• 1 — Introspection functions enabled.
• 0 — Introspection functions disabled.

Valeur par défaut: 0.

Voir Aussi

• Échantillonnage Du Profileur De Requête
• Système de table trace_log

input_format_parallel_parsing

• Type: bool
• Valeur par défaut: True

Activer l'analyse parallèle des formats de données en préservant l'ordre. Pris en charge uniquement pour les formats TSV, TKSV, CSV et jsoneachrow.

min_chunk_bytes_for_parallel_parsing

• Type: unsigned int
• Valeur par défaut: 1 MiB

La taille minimale du bloc en octets, que chaque thread analysera en parallèle.

output_format_avro_codec

Définit le codec de compression utilisé pour le fichier Avro de sortie.

Type: string

Valeurs possibles:

• null — No compression
• deflate — Compress with Deflate (zlib)
• snappy — Compress with Hargneux

Valeur par défaut: snappy (si disponible) ou deflate.

output_format_avro_sync_interval

Définit la taille minimale des données (en octets) entre les marqueurs de synchronisation pour le fichier Avro de sortie.

Type: unsigned int

Valeurs possibles: 32 (32 octets) - 1073741824 (1 GiB)

Valeur par défaut: 32768 (32 Ko)

format_avro_schema_registry_url

Définit L'URL de Registre de schéma Confluent à utiliser avec AvroConfluent format

Type: URL

Valeur par défaut: vide

Article Original