Passer au contenu principal
Ces paramètres sont générés automatiquement à partir du code source.

​
allow_special_bool_values_inside_variant

Permet d’interpréter les valeurs Bool à l’intérieur du type Variant à partir de valeurs booléennes textuelles spéciales comme “on”, “off”, “enable”, “disable”, etc.

​
bool_false_representation

Texte utilisé pour représenter la valeur booléenne false dans les formats TSV/CSV/Vertical/Pretty.

​
bool_true_representation

Texte utilisé pour représenter la valeur booléenne true dans les formats TSV/CSV/Vertical/Pretty.

​
check_conversion_from_numbers_to_enum

Lève une exception lors de la conversion de Numbers en Enum si la valeur n’existe pas dans Enum. Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.
Exemple

​
column_names_for_schema_inference

La liste des noms de colonnes à utiliser pour l’inférence du schéma dans les formats dépourvus de noms de colonnes. Format : ‘column1,column2,column3,…‘

​
date_time_64_output_format_cut_trailing_zeros_align_to_groups_of_thousands

Supprime dynamiquement les zéros finaux des valeurs datetime64 afin d’ajuster l’échelle de sortie à [0, 3, 6], correspondant à « secondes », « millisecondes » et « microsecondes »

​
date_time_input_format

Permet de choisir un parseur pour la représentation textuelle de la date et de l’heure. Ce paramètre ne s’applique pas aux fonctions de date et d’heure. Valeurs possibles :
  • 'best_effort' — Active le parsing étendu. ClickHouse peut analyser le format de base YYYY-MM-DD HH:MM:SS ainsi que tous les formats de date et d’heure ISO 8601. Par exemple, '2018-06-08T01:02:03.000Z'.
  • 'best_effort_us' — Semblable à best_effort (voir la différence avec parseDateTimeBestEffortUS
  • 'basic' — Utilise le parseur de base. ClickHouse peut analyser uniquement le format de base YYYY-MM-DD HH:MM:SS ou YYYY-MM-DD. Par exemple, 2019-08-20 10:18:56 ou 2019-08-20.
Voir aussi :

​
date_time_output_format

Permet de choisir différents formats de sortie pour la représentation textuelle de la date et de l’heure. Valeurs possibles :
  • simple - Format de sortie simple. ClickHouse affiche la date et l’heure au format YYYY-MM-DD hh:mm:ss. Par exemple, 2019-08-20 10:18:56. Le calcul est effectué selon le fuseau horaire du type de données (s’il est présent) ou celui du serveur.
  • iso - Format de sortie ISO. ClickHouse affiche la date et l’heure au format ISO 8601 YYYY-MM-DDThh:mm:ssZ. Par exemple, 2019-08-20T10:18:56Z. Notez que la sortie est en UTC (Z signifie UTC).
  • unix_timestamp - Format de sortie Unix timestamp. ClickHouse affiche la date et l’heure au format Unix timestamp. Par exemple, 1566285536.
Voir aussi :

​
date_time_overflow_behavior

Définit le comportement lorsque Date, Date32, DateTime, DateTime64 ou des entiers sont convertis en Date, Date32, DateTime ou DateTime64, mais que la valeur ne peut pas être représentée dans le type de résultat. Valeurs possibles :
  • ignore — Ignore les dépassements sans signaler d’erreur. Les résultats sont indéfinis.
  • throw — Lève une exception en cas de dépassement.
  • saturate — Sature le résultat. Si la valeur est inférieure à la plus petite valeur pouvant être représentée par le type cible, le résultat retenu est la plus petite valeur représentable. Si la valeur est supérieure à la plus grande valeur pouvant être représentée par le type cible, le résultat retenu est la plus grande valeur représentable.
Valeur par défaut : ignore.

​
errors_output_format

Méthode d’écriture des erreurs dans la sortie texte.

​
format_avro_schema_registry_connection_timeout

Pour le format AvroConfluent : délai d’expiration de connexion, en secondes, du client HTTP Confluent Schema Registry. Utilisé à la fois pour la récupération du schéma et son enregistrement. Doit être supérieur à 0 et inférieur à 600 (10 minutes).

​
format_avro_schema_registry_max_retries

Pour le format AvroConfluent : nombre maximal de réessais en cas d’échecs transitoires lors de la communication avec le Confluent Schema Registry (dépassements de délai de transport, connexion refusée, erreurs DNS, HTTP 5xx/408/429). Définissez la valeur sur 0 pour désactiver les réessais. La valeur maximale autorisée est 20. Les erreurs de validation du schéma (HTTP 409, JSON Avro mal formé) ne font pas l’objet de réessais.

​
format_avro_schema_registry_receive_timeout

Pour le format AvroConfluent : délai d’attente de réception, en secondes, du client HTTP de Confluent Schema Registry. Utilisé à la fois pour la récupération du schéma et l’enregistrement du schéma. Doit être supérieur à 0 et inférieur à 600 (10 minutes).

​
format_avro_schema_registry_retry_initial_backoff_ms

Pour le format AvroConfluent : backoff initial, en millisecondes, avant de réessayer une requête Confluent Schema Registry qui a échoué. Le backoff double à chaque nouvelle tentative, avec un plafond de 10 secondes. Doit être supérieur à 0 et inférieur ou égal à 60000.

​
format_avro_schema_registry_send_timeout

Pour le format AvroConfluent : délai d’expiration d’envoi, en secondes, du client HTTP Confluent Schema Registry. Utilisé à la fois pour la récupération du schéma et l’enregistrement du schéma. Doit être supérieur à 0 et inférieur à 600 (10 minutes).

​
format_avro_schema_registry_url

Pour le format AvroConfluent : URL de Confluent Schema Registry.

​
format_binary_max_array_size

Taille maximale autorisée pour Array au format RowBinary. Cela évite d’allouer une grande quantité de mémoire en cas de données corrompues. 0 signifie qu’il n’y a pas de limite

​
format_binary_max_object_size

Le nombre maximal de chemins autorisé dans un même objet pour le format RowBinary du type JSON. Cela évite d’allouer une grande quantité de mémoire en cas de données corrompues. 0 signifie qu’il n’y a pas de limite

​
format_binary_max_string_size

Taille maximale autorisée pour String au format RowBinary. Ce paramètre empêche l’allocation d’une grande quantité de mémoire en cas de données corrompues. 0 signifie qu’il n’y a pas de limite

​
format_capn_proto_enum_comparising_mode

Comment faire correspondre les Enum ClickHouse et CapnProto

​
format_capn_proto_max_message_size

Taille maximale d’un message CapnProto unique, en octets. Cela protège contre des données mal formées ou corrompues pouvant entraîner une allocation excessive de mémoire. La valeur par défaut est de 1 GiB.

​
format_capn_proto_use_autogenerated_schema

Utilise le schéma CapnProto généré automatiquement lorsque format_schema n’est pas défini

​
format_csv_allow_double_quotes

S’il est défini sur true, autorise les chaînes de caractères entre guillemets doubles.

​
format_csv_allow_single_quotes

S’il est défini sur true, autorise les chaînes entre guillemets simples.

​
format_csv_delimiter

Caractère utilisé comme délimiteur dans les données CSV. Si ce paramètre est défini avec une chaîne, celle-ci doit avoir une longueur de 1.

​
format_csv_null_representation

Représentation personnalisée de NULL au format CSV

​
format_custom_escaping_rule

Règle d’échappement des champs (pour le format CustomSeparated)

​
format_custom_field_delimiter

Délimiteur entre les champs (format CustomSeparated)

​
format_custom_result_after_delimiter

Suffixe après le jeu de résultats (pour le format CustomSeparated)

​
format_custom_result_before_delimiter

Préfixe précédant le jeu de résultats (pour le format CustomSeparated)

​
format_custom_row_after_delimiter

Délimiteur après le champ de la dernière colonne (format CustomSeparated)

​
format_custom_row_before_delimiter

Délimiteur avant le champ de la première colonne (format CustomSeparated)

​
format_custom_row_between_delimiter

Délimiteur entre les lignes (pour le format CustomSeparated)

​
format_display_secrets_in_show_and_select

Active ou désactive l’affichage des secrets dans les requêtes SHOW et SELECT pour les tables, les bases de données, les fonctions de table et les dictionnaires. L’utilisateur qui souhaite voir les secrets doit également avoir le display_secrets_in_show_and_select paramètre du serveur activé et disposer du displaySecretsInShowAndSelect privilège. Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
format_json_object_each_row_column_for_object_name

Nom de la colonne utilisée pour stocker/écrire les noms d’objet au format JSONObjectEachRow. Le type de la colonne doit être String. Si la valeur est vide, les noms d’objet par défaut row_{i} seront utilisés.

​
format_protobuf_use_autogenerated_schema

Utiliser un Protobuf autogénéré lorsque format_schema n’est pas défini

​
format_regexp

Expression régulière (pour le format Regexp)

​
format_regexp_escaping_rule

Règle d’échappement du champ (pour le format Regexp)

​
format_regexp_skip_unmatched

Ignorer les lignes ne correspondant pas à l’expression régulière (pour le format Regexp)

​
format_schema

Ce paramètre est utile lorsque vous utilisez des formats qui nécessitent une définition de schéma, comme Cap’n Proto ou Protobuf. Sa valeur dépend du format.

​
format_schema_message_name

Définit le nom du message requis dans le schéma défini par format_schema. Pour assurer la compatibilité avec le format format_schema legacy (file_name:message_name) :
  • Si format_schema_message_name n’est pas spécifié, le nom du message est déduit de la partie message_name de la valeur format_schema legacy.
  • Si format_schema_message_name est spécifié lors de l’utilisation du format legacy, une erreur est générée.

​
format_schema_source

Définit la source de format_schema. Valeurs possibles :
  • ‘file’ (par défaut) : format_schema est le nom d’un fichier de schéma situé dans le répertoire format_schemas.
  • ‘string’ : format_schema correspond au contenu littéral du schéma.
  • ‘query’ : format_schema est une requête permettant de récupérer le schéma. Lorsque format_schema_source est défini sur ‘query’, les conditions suivantes s’appliquent :
  • La requête doit renvoyer exactement une valeur : une seule ligne avec une seule colonne de type chaîne.
  • Le résultat de la requête est traité comme le contenu du schéma.
  • Ce résultat est mis en cache localement dans le répertoire format_schemas.
  • Vous pouvez vider le cache local à l’aide de la commande : SYSTEM DROP FORMAT SCHEMA CACHE FOR Files.
  • Une fois mis en cache, les requêtes identiques ne sont plus exécutées pour récupérer à nouveau le schéma tant que le cache n’est pas explicitement vidé
  • En plus des fichiers du cache local, les messages Protobuf sont également mis en cache en mémoire. Même après avoir vidé les fichiers du cache local, le cache en mémoire doit être vidé à l’aide de SYSTEM DROP FORMAT SCHEMA CACHE [FOR Protobuf] pour actualiser complètement le schéma.
  • Exécutez la requête SYSTEM DROP FORMAT SCHEMA CACHE pour vider en une seule fois le cache des fichiers et celui des schémas des messages Protobuf.

​
format_template_resultset

Chemin d’accès au fichier contenant la chaîne de format du jeu de résultats (pour le format Template)

​
format_template_resultset_format

Chaîne de format du jeu de résultats (pour le format Template)

​
format_template_row

Chemin du fichier contenant la chaîne de format des lignes (pour le format Template)

​
format_template_row_format

Chaîne de format pour les lignes (pour le format Template)

​
format_template_rows_between_delimiter

Délimiteur entre les lignes (format Template)

​
format_tsv_null_representation

Représentation NULL personnalisée pour le format TSV

​
input_format_allow_errors_num

Définit le nombre maximal d’erreurs tolérées lors de la lecture de formats texte (CSV, TSV, etc.). La valeur par défaut est 0. Utilisez-le toujours avec input_format_allow_errors_ratio. Si une erreur se produit lors de la lecture de lignes, mais que le compteur d’erreurs reste inférieur à input_format_allow_errors_num, ClickHouse ignore la ligne et passe à la suivante. Si input_format_allow_errors_num et input_format_allow_errors_ratio sont tous deux 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 de formats texte (CSV, TSV, etc.). Le pourcentage d’erreurs est exprimé sous la forme d’un nombre à virgule flottante compris entre 0 et 1. La valeur par défaut est 0. Utilisez-le toujours avec input_format_allow_errors_num. Si une erreur survient lors de la lecture des lignes, mais que le compteur d’erreurs reste inférieur à input_format_allow_errors_ratio, ClickHouse ignore la ligne et passe à la suivante. Si input_format_allow_errors_num et input_format_allow_errors_ratio sont tous deux dépassés, ClickHouse lève une exception.

​
input_format_allow_seeks

Autorise les accès directs (ou les lectures par plage) lors de la lecture des formats d’entrée ORC, Parquet et Arrow. Lorsqu’elle est activée et que la source le permet (par exemple un fichier local, S3, ou HTTP avec prise en charge des plages et taille connue), ClickHouse peut ne lire que les plages d’octets nécessaires et utiliser moins de mémoire. Lorsqu’elle est désactivée, ou lorsque la source ne permet pas les accès directs (par exemple si la taille du fichier est inconnue ou si le flux ne permet pas le repositionnement), certains lecteurs peuvent alors se rabattre sur le chargement du fichier entier en mémoire. Activée par défaut.

​
input_format_arrow_allow_missing_columns

Autoriser les colonnes manquantes lors de la lecture des formats d’entrée Arrow

​
input_format_arrow_case_insensitive_column_matching

Ignore la casse lors de la correspondance entre les colonnes Arrow et les colonnes CH.

​
input_format_arrow_skip_columns_with_unsupported_types_in_schema_inference

Ignorer les colonnes de types non pris en charge lors de l’inférence du schéma pour le format Arrow

​
input_format_avro_allow_missing_fields

Pour le format Avro/AvroConfluent : lorsqu’un champ est introuvable dans le schéma, utiliser la valeur par défaut au lieu de renvoyer une erreur

​
input_format_avro_null_as_default

Pour le format Avro/AvroConfluent : insérer la valeur par défaut en cas de NULL dans une colonne non Nullable

​
input_format_binary_decode_types_in_binary_format

Lire les types de données au format binaire au lieu des noms de type dans le format d’entrée RowBinaryWithNamesAndTypes

​
input_format_binary_max_type_complexity

Nombre maximal de nœuds de type lors du décodage des types binaires (il ne s’agit pas de la profondeur, mais du nombre total). Map(String, UInt32) = 3 nœuds. Protège contre les données malveillantes. 0 = illimité.

​
input_format_binary_read_json_as_string

Lit les valeurs du type de données JSON comme des valeurs String JSON dans le format d’entrée RowBinary.

​
input_format_bson_skip_fields_with_unsupported_types_in_schema_inference

Ignore les champs dont les types ne sont pas pris en charge lors de l’inférence du schéma pour le format BSON.

​
input_format_capn_proto_skip_fields_with_unsupported_types_in_schema_inference

Ignorer les colonnes dont les types ne sont pas pris en charge lors de l’inférence du schéma pour le format CapnProto

​
input_format_column_name_matching_mode

Définit le mode de correspondance des noms de colonnes lors de l’ingestion de données via différents formats (notamment JSONEachRow, CSVWithNames, JSONColumns, BSONEachRow et RowBinaryWithNames). Modes pris en charge :
  • match_case : correspondance sensible à la casse
    • ignore_case : correspondance insensible à la casse
    • auto : essaie d’abord une correspondance sensible à la casse ; en cas d’échec, essaie une correspondance insensible à la casse.

​
input_format_connection_handling

Lorsque cette option est activée, si la connexion se ferme de manière inattendue, les données restantes dans le tampon sont analysées et traitées au lieu d’être considérées comme une erreur
L’activation de cette option désactive l’analyse parallèle et rend la déduplication impossible

​
input_format_csv_allow_cr_end_of_line

Si ce paramètre est défini sur true, \r sera autorisé en fin de ligne s’il n’est pas suivi de

​
input_format_csv_allow_variable_number_of_columns

Ignorer les colonnes supplémentaires dans l’entrée CSV (si le fichier contient plus de colonnes que prévu) et traiter les champs manquants dans l’entrée CSV comme des valeurs par défaut

​
input_format_csv_allow_whitespace_or_tab_as_delimiter

Permet d’utiliser des espaces et des tabulations(\t) comme délimiteurs de champs dans les chaînes CSV

​
input_format_csv_arrays_as_nested_csv

Lors de la lecture d’un Array à partir d’un CSV, on suppose que ses éléments ont été sérialisés au format CSV imbriqué, puis placés dans une chaîne. Exemple : ”[""Hello"", ""world"", ""42"""" TV""]”. Les crochets entourant le tableau peuvent être omis.

​
input_format_csv_deserialize_separate_columns_into_tuple

Si cette option est définie sur true, des colonnes distinctes écrites au format CSV peuvent être désérialisées en colonne Tuple.

​
input_format_csv_detect_header

Détecte automatiquement l’en-tête avec les noms et les types au format CSV

​
input_format_csv_empty_as_default

Traiter les champs vides d’une entrée CSV comme des valeurs par défaut.

​
input_format_csv_enum_as_number

Traiter les valeurs d’enum insérées au format CSV comme des indices d’enum

​
input_format_csv_skip_first_lines

Ignore le nombre de lignes spécifié au début des données au format CSV

​
input_format_csv_skip_trailing_empty_lines

Ignorer les lignes vides finales au format CSV

​
input_format_csv_trim_whitespaces

Supprime les espaces et les tabulations (\t) au début et à la fin des chaînes CSV

​
input_format_csv_try_infer_numbers_from_strings

Si ce paramètre est activé, lors de l’inférence du schéma, ClickHouse essaiera d’inférer les nombres à partir des champs de type String. Cela peut être utile si les données CSV contiennent des nombres UInt64 entre guillemets. Désactivé par défaut.

​
input_format_csv_try_infer_strings_from_quoted_tuples

Interpréter les tuples entre guillemets dans les données d’entrée comme une valeur de type String.

​
input_format_csv_use_best_effort_in_schema_inference

Utilise certains ajustements et certaines heuristiques pour inférer le schéma au format CSV

​
input_format_csv_use_default_on_bad_values

Permet de définir la valeur par défaut d’une colonne lorsque la désérialisation d’un champ CSV échoue à cause d’une valeur incorrecte

​
input_format_custom_allow_variable_number_of_columns

Ignorer les colonnes supplémentaires dans l’entrée CustomSeparated (si le fichier comporte plus de colonnes que prévu) et traiter les champs manquants dans l’entrée CustomSeparated comme des valeurs par défaut

​
input_format_custom_detect_header

Détecte automatiquement l’en-tête avec les noms et les types dans le format CustomSeparated

​
input_format_custom_skip_trailing_empty_lines

Ignorer les lignes vides finales dans le format CustomSeparated

​
input_format_defaults_for_omitted_fields

Pour les requêtes INSERT, remplace les valeurs des colonnes d’entrée omises par les valeurs par défaut des colonnes correspondantes. Cette option s’applique aux formats JSONEachRow (et autres formats JSON), CSV, TabSeparated, TSKV, Parquet, Arrow, Avro, ORC, Native, ainsi qu’aux formats avec les suffixes WithNames/WithNamesAndTypes.
Lorsque cette option est activée, des métadonnées de table supplémentaires sont transmises du serveur au client. Cela consomme des ressources de calcul supplémentaires sur le serveur et peut réduire les performances.
Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
input_format_force_null_for_omitted_fields

Forcer l’initialisation des champs omis avec des valeurs NULL

​
input_format_geojson_unsupported_geometry_handling

Contrôle le comportement lorsqu’un type de géométrie GeoJSON valide qui ne peut pas être représenté par le type Geometry de ClickHouse (comme GeometryCollection ou MultiPoint) doit être stocké dans la colonne geometry lors de la lecture d’une entrée GeoJSON. Valeurs possibles :
  • 'throw' (par défaut) — lever une exception.
  • 'null' — insérer une valeur NULL dans la colonne geometry et poursuivre l’analyse.
Cela s’applique uniquement lorsque la colonne geometry est matérialisée. Lorsqu’il ne s’agit pas d’une colonne de sortie demandée, une telle géométrie est validée pour s’assurer qu’elle est bien formée, mais ne déclenche pas ce traitement.

​
input_format_hive_text_allow_variable_number_of_columns

Ignorer les colonnes supplémentaires dans l’entrée au format Hive Text (si le fichier comporte plus de colonnes que prévu) et traiter les champs manquants dans l’entrée au format Hive Text comme des valeurs par défaut

​
input_format_hive_text_collection_items_delimiter

Délimiteur entre les éléments d’une collection (Array ou Map) dans Hive Text File

​
input_format_hive_text_fields_delimiter

Délimiteur des champs dans Hive Text File

​
input_format_hive_text_map_keys_delimiter

Délimiteur entre la clé et la valeur d’une paire de map dans Hive Text File

​
input_format_import_nested_json

Active ou désactive l’insertion de données JSON contenant des objets imbriqués. Formats pris en charge : Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.
Voir aussi :

​
input_format_ipv4_default_on_conversion_error

La désérialisation d’IPv4 utilisera les valeurs par défaut au lieu de lever une exception en cas d’erreur de conversion. Désactivé par défaut.

​
input_format_ipv6_default_on_conversion_error

La désérialisation d’IPV6 utilisera les valeurs par défaut au lieu de lever une exception en cas d’erreur de conversion. Désactivé par défaut.

​
input_format_json_compact_allow_variable_number_of_columns

Autorise un nombre variable de colonnes par ligne dans les formats d’entrée JSONCompact/JSONCompactEachRow. Ignore les colonnes supplémentaires dans les lignes qui contiennent plus de colonnes que prévu et traite les colonnes manquantes comme des valeurs par défaut. Désactivé par défaut.

​
input_format_json_defaults_for_missing_elements_in_named_tuple

Insère les valeurs par défaut pour les éléments manquants d’un objet JSON lors de l’analyse d’un tuple nommé. Ce paramètre fonctionne uniquement lorsque le paramètre input_format_json_named_tuples_as_objects est activé. Activé par défaut.

​
input_format_json_empty_as_default

Lorsqu’il est activé, les champs vides de l’entrée JSON sont remplacés par des valeurs par défaut. Pour les expressions par défaut complexes, input_format_defaults_for_omitted_fields doit également être activé. Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
input_format_json_ignore_unknown_keys_in_named_tuple

Ignorer les clés inconnues dans les objets JSON pour les tuples nommés. Activé par défaut.

​
input_format_json_ignore_unnecessary_fields

Ignorer les champs inutiles sans les analyser. L’activation de ce paramètre peut ne pas lever d’exception pour des chaînes JSON au format invalide ou contenant des champs dupliqués

​
input_format_json_infer_array_of_dynamic_from_array_of_different_types

Si ce paramètre est activé, lors de l’inférence du schéma, ClickHouse utilisera le type Array(Dynamic) pour les tableaux JSON contenant des valeurs de différents types de données. Exemple :
Activé par défaut.

​
input_format_json_infer_incomplete_types_as_strings

Permet d’utiliser le type String pour les clés JSON qui ne contiennent que Null/{}/[] dans l’échantillon de données lors de l’inférence du schéma. Dans les formats JSON, toute valeur peut être lue comme String, ce qui permet d’éviter des erreurs telles que Cannot determine type for column 'column_name' by first 25000 rows of data, most likely this column contains only Nulls or empty Arrays/Maps lors de l’inférence du schéma, en utilisant le type String pour les clés dont le type est inconnu. Exemple :
Résultat :
Activé par défaut.

​
input_format_json_map_as_array_of_tuples

Désérialise les colonnes de type Map sous forme de tableaux JSON de tuples. Désactivé par défaut.

​
input_format_json_max_depth

Profondeur maximale d’un champ dans un JSON. Il ne s’agit pas d’une limite stricte et elle ne doit pas nécessairement être appliquée de manière précise.

​
input_format_json_named_tuples_as_objects

Interpréter les colonnes de tuples nommés comme des objets JSON. Activé par défaut.

​
input_format_json_read_arrays_as_strings

Permet d’interpréter les tableaux JSON comme des chaînes dans les formats d’entrée JSON. Exemple :
Résultat :
Activé par défaut.

​
input_format_json_read_bools_as_numbers

Autorise l’interprétation des booléens comme des nombres dans les formats d’entrée JSON. Activé par défaut.

​
input_format_json_read_bools_as_strings

Autorise l’interprétation des booléens sous forme de chaînes dans les formats d’entrée JSON. Activé par défaut.

​
input_format_json_read_numbers_as_strings

Permet d’interpréter les nombres sous forme de chaînes dans les formats d’entrée JSON. Activé par défaut.

​
input_format_json_read_objects_as_strings

Autorise l’analyse des objets JSON sous forme de chaînes dans les formats d’entrée JSON. Exemple :
Résultat :
Activé par défaut.

​
input_format_json_throw_on_bad_escape_sequence

Lever une exception si une chaîne JSON contient une séquence d’échappement incorrecte dans les formats d’entrée JSON. Si cette option est désactivée, les séquences d’échappement incorrectes resteront telles quelles dans les données. Activé par défaut.

​
input_format_json_try_infer_named_tuples_from_objects

Si ce paramètre est activé, lors de l’inférence du schéma, ClickHouse essaiera d’inférer un Tuple nommé à partir d’objets JSON. Le Tuple nommé résultant contiendra tous les éléments de tous les objets JSON correspondants de l’échantillon de données. Exemple :
Résultat :
Activé par défaut.

​
input_format_json_try_infer_numbers_from_strings

Si cette option est activée, lors de l’inférence du schéma, ClickHouse essaiera d’inférer des nombres à partir de champs de type chaîne. Cela peut être utile si les données JSON contiennent des nombres UInt64 entre guillemets. Désactivé par défaut.

​
input_format_json_use_string_type_for_ambiguous_paths_in_named_tuples_inference_from_objects

Utilise le type String au lieu de générer une exception en cas de chemins ambigus dans des objets JSON lors de l’inférence de tuples nommés

​
input_format_json_validate_types_from_metadata

Pour les formats d’entrée JSON/JSONCompact/JSONColumnsWithMetadata, si ce paramètre est défini sur 1, les types des métadonnées des données d’entrée seront comparés aux types des colonnes correspondantes de la table. Activé par défaut.

​
input_format_max_block_size_bytes

Limite la taille, en octets, des blocs formés lors de l’analyse des données dans les formats d’entrée. Utilisé dans les formats d’entrée basés sur les lignes lorsque le bloc est formé côté ClickHouse. 0 signifie qu’il n’y a aucune limite en octets.

​
input_format_max_block_wait_ms

Limite le temps d’attente maximal, en millisecondes, avant l’émission d’un bloc lors de l’analyse dans les formats d’entrée basés sur des lignes. 0 signifie qu’il n’y a pas de limite.
Cette option fonctionne uniquement si input_format_connection_handling est activé. Définir une valeur désactive également l’analyse parallèle et rend la déduplication impossible.
Pour les insertions en streaming, vous devez également définir min_insert_block_size_rows=0 et min_insert_block_size_bytes=0. Sinon, les blocs analysés peuvent encore s’accumuler en mémoire à l’étape de fusion des blocs jusqu’à ce que ces seuils soient atteints, ce qui empêche des insertions en temps voulu.
Exemple : diffusion en streaming des modifications récentes de Wikipedia dans ClickHouse

​
input_format_max_bytes_to_read_for_schema_inference

Quantité maximale de données, en octets, à lire pour l’inférence automatique du schéma.

​
input_format_max_rows_to_read_for_schema_inference

Nombre maximal de lignes de données à lire pour l’inférence automatique du schéma.

​
input_format_msgpack_number_of_columns

Le nombre de colonnes dans les données MsgPack insérées. Utilisé pour l’inférence automatique du schéma à partir de ces données.

​
input_format_mysql_dump_map_column_names

Faire correspondre les colonnes de la table du dump MySQL avec celles de la table ClickHouse, en fonction de leur nom

​
input_format_mysql_dump_table_name

Nom de la table du dump MySQL à partir de laquelle lire les données

​
input_format_native_allow_types_conversion

Autoriser la conversion des types de données dans le format d’entrée Native

​
input_format_native_decode_types_in_binary_format

Lire les types de données au format binaire plutôt que les noms de type dans le format d’entrée Native

​
input_format_null_as_default

Active ou désactive l’initialisation des champs NULL avec des valeurs par défaut, si le type de données de ces champs n’est pas Nullable. Si le type de la colonne n’est pas Nullable et que ce paramètre est désactivé, l’insertion de NULL provoque une exception. Si le type de la colonne est Nullable, les valeurs NULL sont insérées telles quelles, quel que soit ce paramètre. Ce paramètre s’applique à la plupart des formats d’entrée. Pour les expressions par défaut complexes, input_format_defaults_for_omitted_fields doit également être activé. Valeurs possibles :
  • 0 — L’insertion de NULL dans une colonne non Nullable provoque une exception.
  • 1 — Les champs NULL sont initialisés avec les valeurs par défaut de la colonne.

​
input_format_orc_allow_missing_columns

Autoriser les colonnes manquantes lors de la lecture du format d’entrée ORC

​
input_format_orc_case_insensitive_column_matching

Ignore la casse lors de la mise en correspondance des colonnes ORC avec les colonnes CH.

​
input_format_orc_dictionary_as_low_cardinality

Traiter les colonnes encodées à l’aide du dictionnaire ORC comme des colonnes LowCardinality lors de la lecture de fichiers ORC.

​
input_format_orc_filter_push_down

Lors de la lecture de fichiers ORC, ignore des stripes entières ou des groupes de lignes entiers en fonction des expressions WHERE/PREWHERE, des statistiques min/max ou du filtre de Bloom dans les métadonnées ORC.

​
input_format_orc_reader_time_zone_name

Nom du fuseau horaire du lecteur de lignes ORC ; le fuseau horaire par défaut du lecteur de lignes ORC est GMT.

​
input_format_orc_row_batch_size

Taille du lot pour la lecture des stripes ORC.

​
input_format_orc_skip_columns_with_unsupported_types_in_schema_inference

Ignorer les colonnes dont les types ne sont pas pris en charge lors de l’inférence du schéma pour le format ORC

​
input_format_orc_use_fast_decoder

Utilise une implémentation plus rapide du décodeur ORC.

​
input_format_parallel_parsing

Active ou désactive l’analyse parallèle des formats de données avec préservation de l’ordre. Pris en charge uniquement pour les formats TabSeparated (TSV), TSKV, CSV et JSONEachRow. Valeurs possibles :
  • 1 — Activé.
  • 0 — Désactivé.

​
input_format_parquet_allow_geoparquet_parser

Utilise l’analyseur de colonnes géo pour convertir Array(UInt8) en types Point/Linestring/Polygon/MultiLineString/MultiPolygon

​
input_format_parquet_allow_missing_columns

Autoriser les colonnes manquantes lors de la lecture de formats d’entrée Parquet

​
input_format_parquet_bloom_filter_push_down

Lors de la lecture de fichiers Parquet, permet d’ignorer des groupes de lignes entiers en fonction des expressions WHERE et du filtre de Bloom dans les métadonnées Parquet.

​
input_format_parquet_case_insensitive_column_matching

Ignorer la casse lors de la mise en correspondance des colonnes Parquet avec les colonnes CH.

​
input_format_parquet_enable_json_parsing

Lors de la lecture de fichiers Parquet, interpréter les colonnes JSON comme des colonnes JSON ClickHouse.

​
input_format_parquet_enable_row_group_prefetch

Active la prélecture des groupes de lignes lors de l’analyse de Parquet. Actuellement, seule l’analyse en monothread peut effectuer cette prélecture.

​
input_format_parquet_filter_push_down

Lors de la lecture de fichiers Parquet, ignore des groupes de lignes entiers en fonction des expressions WHERE/PREWHERE et des statistiques min/max des métadonnées Parquet.

​
input_format_parquet_local_file_min_bytes_for_seek

Nombre minimal d’octets requis pour qu’une lecture locale (fichier) effectue un seek plutôt qu’une lecture avec ignore dans le format d’entrée Parquet

​
input_format_parquet_local_time_as_utc

Détermine le type de données utilisé par l’inférence de schéma pour les timestamps Parquet avec isAdjustedToUTC=false. Si true : DateTime64(…, ‘UTC’) ; si false : DateTime64(…). Aucun de ces deux comportements n’est entièrement correct, car ClickHouse ne dispose pas d’un type de données pour l’heure locale affichée. De façon contre-intuitive, ‘true’ est probablement l’option la moins incorrecte, car le formatage du timestamp ‘UTC’ en String produira une représentation de l’heure locale correcte.

​
input_format_parquet_max_block_size

Taille maximale des blocs pour le lecteur Parquet.

​
input_format_parquet_memory_high_watermark

Limite de mémoire approximative pour le lecteur Parquet v3. Limite le nombre de groupes de lignes ou de colonnes pouvant être lus en parallèle. Lors de la lecture de plusieurs fichiers dans une même requête, la limite porte sur l’utilisation mémoire totale de l’ensemble de ces fichiers.

​
input_format_parquet_memory_low_watermark

Planifie les prélectures plus agressivement si l’utilisation de la mémoire est inférieure au seuil. Cela peut être utile, par exemple, s’il y a de nombreux petits filtres de Bloom à lire sur le réseau.

​
input_format_parquet_page_filter_push_down

Ignore les pages à l’aide des valeurs min/max de l’index de colonne.

​
input_format_parquet_prefer_block_bytes

Nombre moyen d’octets par bloc produits par le lecteur Parquet

​
input_format_parquet_preserve_order

Évite de réordonner les lignes lors de la lecture de fichiers Parquet. Ce n’est pas recommandé, car l’ordre des lignes n’est généralement pas garanti et d’autres parties du pipeline d’exécution de la requête peuvent malgré tout le modifier. Utilisez plutôt ORDER BY _row_number.

​
input_format_parquet_skip_columns_with_unsupported_types_in_schema_inference

Ignorer les colonnes dont les types ne sont pas pris en charge lors de l’inférence de schéma pour le format Parquet

​
input_format_parquet_use_offset_index

Ajustement mineur de la façon dont les pages sont lues à partir d’un fichier Parquet lorsqu’aucun filtrage de page n’est appliqué.

​
input_format_parquet_verify_checksums

Vérifie les sommes de contrôle des pages lors de la lecture des fichiers Parquet.

​
input_format_protobuf_flatten_google_wrappers

Active les wrappers Google pour les colonnes ordinaires non imbriquées, par ex. google.protobuf.StringValue ‘str’ pour la colonne String ‘str’. Pour les colonnes Nullable, les wrappers vides sont interprétés comme des valeurs par défaut, et les valeurs manquantes comme des nulls

​
input_format_protobuf_oneof_presence

Indique quel champ du oneof Protobuf a été trouvé en définissant une valeur enum dans une colonne spéciale

​
input_format_protobuf_skip_fields_with_unsupported_types_in_schema_inference

Ignorer les champs dont les types ne sont pas pris en charge lors de l’inférence de schéma pour le format Protobuf

​
input_format_record_errors_file_path

Chemin du fichier utilisé pour consigner les erreurs lors de la lecture de formats texte (CSV, TSV).

​
input_format_skip_unknown_fields

Active ou désactive l’omission des données supplémentaires lors de l’insertion. 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 cette option est activée, ClickHouse n’insère pas les données supplémentaires et ne lève pas d’exception. Formats pris en charge : Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
input_format_try_infer_dates

Si ce paramètre est activé, ClickHouse essaiera d’inférer le type Date à partir des champs de type chaîne lors de l’inférence de schéma pour les formats texte. Si tous les champs d’une colonne dans les données d’entrée ont été correctement interprétés comme des dates, le type résultant sera Date ; si au moins un champ n’a pas été interprété comme une date, le type résultant sera String. Activé par défaut.

​
input_format_try_infer_datetimes

Si cette option est activée, ClickHouse tentera d’inférer le type DateTime64 à partir des champs de type chaîne lors de l’inférence de schéma pour les formats texte. Si tous les champs d’une colonne des données d’entrée sont correctement analysés comme des dates et heures, le type résultant sera DateTime64 ; si au moins un champ n’est pas analysé comme une date et heure, le type résultant sera String. Activé par défaut.

​
input_format_try_infer_datetimes_only_datetime64

Lorsque input_format_try_infer_datetimes est activé, n’inférer que le type DateTime64, et non les types DateTime

​
input_format_try_infer_exponent_floats

Tenter d’inférer les nombres flottants en notation exponentielle lors de l’inférence de schéma dans les formats texte (sauf JSON, où les nombres avec exposant sont toujours inférés)

​
input_format_try_infer_integers

Si cette option est activée, ClickHouse tentera d’inférer des entiers plutôt que des nombres à virgule flottante lors de l’inférence de schéma pour les formats texte. Si tous les nombres d’une colonne dans les données d’entrée sont des entiers, le type résultant sera Int64 ; si au moins un nombre est à virgule flottante, le type résultant sera Float64. Activé par défaut.

​
input_format_try_infer_variants

Si cette option est activée, ClickHouse tentera d’inférer le type Variant lors de l’inférence de schéma pour les formats texte lorsqu’il existe plusieurs types possibles pour les éléments de colonne ou de tableau. Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
input_format_tsv_allow_variable_number_of_columns

Ignorer les colonnes supplémentaires dans l’entrée TSV (si le fichier comporte plus de colonnes que prévu) et considérer les champs manquants dans l’entrée TSV comme des valeurs par défaut

​
input_format_tsv_crlf_end_of_line

Si ce paramètre est défini sur true, la fonction file lira le format TSV avec des fins de ligne \r\n au lieu de \n.

​
input_format_tsv_detect_header

Détecte automatiquement l’en-tête avec les noms et les types au format TSV

​
input_format_tsv_empty_as_default

Traite les champs vides dans l’entrée TSV comme des valeurs par défaut.

​
input_format_tsv_enum_as_number

Traite les valeurs d’enum insérées dans les formats TSV comme des indices d’enum.

​
input_format_tsv_skip_first_lines

Ignore le nombre spécifié de lignes au début des données au format TSV

​
input_format_tsv_skip_trailing_empty_lines

Ignorer les lignes vides finales au format TSV

​
input_format_tsv_use_best_effort_in_schema_inference

Utilise certains ajustements et heuristiques pour inférer le schéma au format TSV

​
input_format_values_accurate_types_of_literals

Pour le format Values : lors de l’analyse et de l’interprétation des expressions à l’aide du modèle, vérifiez le type réel du littéral afin d’éviter d’éventuels problèmes de dépassement de capacité et de précision.

​
input_format_values_deduce_templates_of_expressions

Pour le format Values : si le champ ne peut pas être analysé par le parseur en flux, l’analyseur SQL est exécuté, le modèle de l’expression SQL est déduit, toutes les lignes sont ensuite analysées à l’aide de ce modèle, puis l’expression est interprétée pour toutes les lignes.

​
input_format_values_interpret_expressions

Pour le format Values : si le champ n’a pas pu être analysé par le parseur en flux, exécutez l’analyseur SQL et essayez de l’interpréter comme une expression SQL.

​
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 recommandons de désactiver cette vérification si vous êtes sûr que l’ordre des colonnes dans les données d’entrée est le même que dans la table cible. Formats pris en charge : Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
input_format_with_types_use_header

Détermine si l’analyseur de format doit vérifier que les types de données des données d’entrée correspondent à ceux de la table cible. Formats pris en charge : Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
insert_distributed_one_random_shard

Active ou désactive l’insertion dans un shard choisi aléatoirement dans une table Distributed lorsqu’aucune clé de distribution n’est définie. Par défaut, lors de l’insertion de données dans une table Distributed comportant plus d’un shard, le serveur ClickHouse rejette toute requête d’insertion si aucune clé de distribution n’est définie. Lorsque insert_distributed_one_random_shard = 1, les insertions sont autorisées et les données sont transmises aléatoirement à l’un des shards. Valeurs possibles :
  • 0 — L’insertion est rejetée s’il y a plusieurs shards et qu’aucune clé de distribution n’est définie.
  • 1 — L’insertion est effectuée aléatoirement parmi tous les shards disponibles lorsqu’aucune clé de distribution n’est définie.

​
interval_output_format

Permet de choisir différents formats de sortie pour la représentation textuelle des types d’intervalle. Valeurs possibles :
  • kusto - Format de sortie de style KQL. ClickHouse affiche les intervalles au format KQL. Par exemple, toIntervalDay(2) est formaté sous la forme 2.00:00:00. Veuillez noter que, pour les types d’intervalle de longueur variable (c.-à-d. IntervalMonth et IntervalYear), le nombre moyen de secondes par intervalle est pris en compte.
  • numeric - Format de sortie numérique. ClickHouse affiche les intervalles selon leur représentation numérique sous-jacente. Par exemple, toIntervalDay(2) est formaté sous la forme 2.
Voir aussi :

​
into_outfile_create_parent_directories

Crée automatiquement les répertoires parents lors de l’utilisation de INTO OUTFILE s’ils n’existent pas encore.

​
json_type_escape_dots_in_keys

Lorsqu’il est activé, les points dans les clés JSON sont échappés lors de l’analyse.

​
max_dynamic_subcolumns_in_json_type_parsing

Nombre maximal de sous-colonnes dynamiques pouvant être créées dans chaque colonne lors de l’analyse d’une colonne JSON. Il permet de contrôler le nombre de sous-colonnes dynamiques lors de l’analyse, indépendamment des paramètres dynamiques spécifiés dans le type de données.

​
output_format_always_write_decimal_point_in_float_and_decimal

Afficher systématiquement un séparateur décimal pour les nombres à virgule flottante et les nombres Decimal dans les formats texte, même lorsque la valeur est un nombre entier. Par exemple, afficher 1. au lieu de 1. Désactivé par défaut.

​
output_format_arrow_compression_method

Méthode de compression du format de sortie Arrow. Codecs pris en charge : lz4_frame, zstd, none (sans compression)

​
output_format_arrow_date_as_uint16

Écrit les valeurs Date sous forme de nombres 16 bits bruts (relus comme UInt16), au lieu de les convertir en type DATE32 Arrow 32 bits (relu comme Date32).

​
output_format_arrow_fixed_string_as_fixed_byte_array

Utilise le type Arrow FIXED_SIZE_BINARY au lieu de Binary pour les colonnes FixedString.

​
output_format_arrow_low_cardinality_as_dictionary

Active la sortie du type LowCardinality sous forme de type Arrow Dictionary

​
output_format_arrow_string_as_string

Utiliser le type String d’Arrow au lieu de Binary pour les colonnes String

​
output_format_arrow_unsupported_types_as_binary

Renvoie les types sans conversion sous forme de données binaires brutes. Si false, ces types lèvent une exception UNKNOWN_TYPE.

​
output_format_arrow_use_64_bit_indexes_for_dictionary

Toujours utiliser des entiers 64 bits pour les index de dictionnaire au format Arrow

​
output_format_arrow_use_signed_indexes_for_dictionary

Utiliser des entiers signés pour les index de dictionnaire au format Arrow

​
output_format_avro_codec

Codec de compression utilisé en sortie. Valeurs possibles : ‘null’, ‘deflate’, ‘snappy’, ‘zstd’.

​
output_format_avro_confluent_subject

Pour le format de sortie AvroConfluent : nom du subject sous lequel le schéma est enregistré dans Confluent Schema Registry. Obligatoire lors de l’écriture au format de sortie AvroConfluent.

​
output_format_avro_rows_in_file

Nombre maximal de lignes dans un fichier (si le stockage le permet)

​
output_format_avro_string_column_pattern

Pour le format Avro : expression régulière des colonnes de type String à sélectionner en tant que chaîne AVRO.

​
output_format_avro_sync_interval

Intervalle de synchronisation, en octets.

​
output_format_binary_encode_types_in_binary_format

Écrire les types de données au format binaire plutôt que les noms de type dans le format de sortie RowBinaryWithNamesAndTypes

​
output_format_binary_write_json_as_string

Écrit les valeurs de type JSON sous forme de valeurs JSON String dans le format de sortie RowBinary.

​
output_format_bson_string_as_string

Utilise le type BSON String au lieu de Binary pour les colonnes de type String.

​
output_format_compression_level

Niveau de compression par défaut lorsque la sortie de la requête est compressée. Ce paramètre s’applique lorsque la requête SELECT utilise INTO OUTFILE ou lors de l’écriture dans les fonctions de table file, url, hdfs, s3 ou azureBlobStorage. Valeurs possibles : de 1 à 22

​
output_format_compression_zstd_window_log

Peut être utilisé lorsque la méthode de compression de sortie est zstd. Si elle est supérieure à 0, ce paramètre définit explicitement la taille de la fenêtre de compression (puissance de 2) et active un mode longue portée pour la compression zstd. Cela peut aider à obtenir un meilleur taux de compression. Valeurs possibles : nombres non négatifs. Notez que si la valeur est trop petite ou trop grande, zstdlib lèvera une exception. Les valeurs typiques vont de 20 (taille de fenêtre = 1MB) à 30 (taille de fenêtre = 1GB).

​
output_format_csv_crlf_end_of_line

Si ce paramètre est défini sur true, la fin de ligne au format CSV sera \r\n au lieu de \n.

​
output_format_csv_serialize_tuple_into_separate_columns

Si ce paramètre est défini sur true, les Tuples au format CSV sont sérialisés dans des colonnes distinctes (c’est-à-dire que leur imbrication dans le tuple est perdue)

​
output_format_decimal_trailing_zeros

Afficher les zéros non significatifs lors de l’affichage des valeurs Decimal. Par exemple, 1.230000 au lieu de 1.23. Désactivé par défaut.

​
output_format_float_precision

Lorsque cette valeur est non nulle, la sortie des nombres à virgule flottante (Float32, Float64, BFloat16) est formatée avec au plus ce nombre de chiffres après la virgule (les zéros finaux sont supprimés). Lorsqu’elle vaut 0 (valeur par défaut), la représentation la plus courte permettant un aller-retour est utilisée. Les valeurs trop grandes pour la notation fixe, ainsi que les valeurs dont la valeur absolue est si faible qu’un arrondi à la précision demandée ferait perdre tous les chiffres significatifs (la mantisse deviendrait ±0), sont émises en notation scientifique à la place. Dans ces cas, la mantisse peut comporter plus de chiffres fractionnaires que le nombre demandé. Plage valide : 0 à 100.

​
output_format_image_height

Hauteur, en pixels, de l’image de sortie pour les formats de sortie d’image tels que PNG. Valeur par défaut : 1024.

​
output_format_image_terminal_mode

Pour les formats de sortie d’image tels que PNG, affiche l’image directement dans le terminal à l’aide d’un protocole d’image intégré au lieu d’écrire les octets bruts de l’image. Valeurs possibles :
  • “ (vide) — écrire les octets bruts de l’image (par défaut).
  • iterm — utiliser le protocole d’image intégré d’iTerm2.
  • kitty — utiliser le protocole graphique Kitty.
  • sixel — utiliser le protocole Sixel.
  • auto — si la sortie est un terminal, détecter ses capacités et utiliser iterm, kitty ou sixel (dans cet ordre) ; sinon, écrire les octets bruts de l’image.
Valeur par défaut : “ (vide).

​
output_format_image_width

Largeur, en pixels, de l’image de sortie pour les formats de sortie d’image tels que PNG. Valeur par défaut : 1024.

​
output_format_json_array_of_rows

Permet de générer toutes les lignes sous la forme d’un tableau JSON au format JSONEachRow. Valeurs possibles :
  • 1 — ClickHouse génère toutes les lignes sous la forme d’un tableau, chaque ligne étant au format JSONEachRow.
  • 0 — ClickHouse génère chaque ligne séparément au format JSONEachRow.
Exemple de requête avec ce paramètre activé Requête :
Résultat :
Exemple de requête avec le paramètre désactivé Requête :
Résultat :

​
output_format_json_escape_forward_slashes

Contrôle l’échappement des barres obliques / dans les sorties de chaînes au format de sortie JSON. Ce paramètre vise à assurer la compatibilité avec JavaScript. Ne pas confondre avec les backslashes, qui sont toujours échappés. Activé par défaut.

​
output_format_json_map_as_array_of_tuples

Sérialise les colonnes Map sous forme de tableaux JSON de tuples. Désactivé par défaut.

​
output_format_json_named_tuples_as_objects

Sérialise les colonnes de tuples nommés sous forme d’objets JSON. Activé par défaut.

​
output_format_json_pretty_print

Ce paramètre détermine comment les structures imbriquées telles que les Tuples, les Maps et les Arrays sont affichées dans le tableau data lors de l’utilisation du format de sortie JSON. Par exemple, au lieu d’obtenir :
La sortie aura le format suivant :
Activé par défaut.

​
output_format_json_quote_64bit_floats

Contrôle la mise entre guillemets des valeurs à virgule flottante 64 bits lors de leur sortie dans les formats JSON*. Désactivé par défaut.

​
output_format_json_quote_64bit_integers

Contrôle la mise entre guillemets des entiers 64 bits ou supérieurs (comme UInt64 ou Int128) lorsqu’ils sont affichés au format JSON. Par défaut, ces entiers sont entourés de guillemets. Ce comportement est compatible avec la plupart des implémentations JavaScript. Valeurs possibles :
  • 0 — Les entiers sont affichés sans guillemets.
  • 1 — Les entiers sont entourés de guillemets.

​
output_format_json_quote_decimals

Contrôle la mise entre guillemets des valeurs décimales dans les formats de sortie JSON. Désactivé par défaut.

​
output_format_json_quote_denormals

Permet d’inclure les valeurs +nan, -nan, +inf, -inf dans le format de sortie JSON. Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.
Exemple Considérez la table account_orders suivante :
Lorsque output_format_json_quote_denormals = 0, la requête renvoie des valeurs null dans la sortie :
Lorsque output_format_json_quote_denormals = 1, la requête renvoie :

​
output_format_json_skip_null_value_in_named_tuples

Ignorer les paires clé-valeur dont la valeur est NULL lors de la sérialisation des colonnes de tuples nommés en objets JSON. Ce paramètre n’est valide que lorsque output_format_json_named_tuples_as_objects est true.

​
output_format_json_validate_utf8

Contrôle la validation des séquences UTF-8 dans les formats de sortie JSON ; n’affecte pas les formats JSON/JSONCompact/JSONColumnsWithMetadata, qui valident toujours l’UTF-8. Désactivé par défaut.

​
output_format_markdown_escape_special_characters

Lorsqu’il est activé, les caractères spéciaux dans Markdown sont échappés. Common Mark définit les caractères spéciaux suivants, qui peuvent être échappés :
Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

​
output_format_msgpack_uuid_representation

Définit la manière dont un UUID est généré au format MsgPack.

​
output_format_native_encode_types_in_binary_format

Écrit les types de données au format binaire au lieu des noms de type dans le format de sortie Native

​
output_format_native_use_flattened_dynamic_and_json_serialization

Écrit les données des colonnes JSON et Dynamic dans un format aplati (tous les types/chemins sous forme de sous-colonnes distinctes).

​
output_format_native_write_json_as_string

Écrit les données d’une colonne JSON sous forme de colonne String contenant des chaînes JSON, au lieu de la sérialisation JSON native par défaut.

​
output_format_orc_compression_block_size

Taille, en octets, du bloc de compression pour le format de sortie ORC.

​
output_format_orc_compression_method

Méthode de compression pour le format de sortie ORC. Codecs pris en charge : lz4, snappy, zlib, zstd, none (non compressé)

​
output_format_orc_dictionary_key_size_threshold

Pour une colonne de type chaîne de caractères au format de sortie ORC, si le nombre de valeurs distinctes dépasse cette fraction du nombre total de lignes non NULL, l’encodage par dictionnaire est désactivé. Sinon, l’encodage par dictionnaire est activé

​
output_format_orc_row_index_stride

Pas cible de l’index de ligne dans le format de sortie ORC

​
output_format_orc_string_as_string

Utiliser le type String d’ORC au lieu de Binary pour les colonnes String

​
output_format_orc_writer_time_zone_name

Nom du fuseau horaire du writer ORC ; le fuseau horaire par défaut du writer ORC est GMT.

​
output_format_parallel_formatting

Active ou désactive la mise en forme parallèle des données. Pris en charge uniquement pour les formats TSV, TSKV, CSV et JSONEachRow. Valeurs possibles :
  • 1 — Activé.
  • 0 — Désactivé.

​
output_format_parquet_batch_size

Vérifie la taille de la page toutes les x lignes. Envisagez de la diminuer si vous avez des colonnes dont la taille moyenne des valeurs dépasse quelques Ko.

​
output_format_parquet_bloom_filter_bits_per_value

Nombre approximatif de bits à utiliser pour chaque valeur distincte dans les filtres de Bloom Parquet. Taux de faux positifs estimés :
  • 6 bits - 10%
  • 10.5 bits - 1%
  • 16.9 bits - 0.1%
  • 26.4 bits - 0.01%
  • 41 bits - 0.001%

​
output_format_parquet_bloom_filter_flush_threshold_bytes

Emplacement des filtres de Bloom dans le fichier Parquet. Les filtres de Bloom seront écrits par groupes d’environ cette taille. Plus précisément :
  • si 0, les filtres de Bloom de chaque groupe de lignes sont écrits immédiatement après le groupe de lignes,
    • si cette valeur est supérieure à la taille totale de tous les filtres de Bloom, les filtres de Bloom de tous les groupes de lignes seront accumulés en mémoire, puis écrits ensemble vers la fin du fichier,
    • sinon, les filtres de Bloom seront accumulés en mémoire et écrits dès que leur taille totale dépasse cette valeur.

​
output_format_parquet_compression_method

Méthode de compression pour le format de sortie Parquet. Codecs pris en charge : snappy, lz4, brotli, zstd, gzip, none (non compressé)

​
output_format_parquet_data_page_size

Taille cible de la page, en octets, avant compression.

​
output_format_parquet_date_as_uint16

Écrit les valeurs Date sous forme de nombres 16 bits bruts (relus comme UInt16), au lieu de les convertir en type DATE Parquet 32 bits (relu comme Date32).

​
output_format_parquet_datetime_as_uint32

Écrit les valeurs DateTime sous forme de timestamp Unix brut (relues comme UInt32), au lieu de les convertir en millisecondes (relues comme DateTime64(3)).

​
output_format_parquet_enum_as_byte_array

Écrire enum avec le type physique Parquet : BYTE_ARRAY et le type logique : ENUM

​
output_format_parquet_fixed_string_as_fixed_byte_array

Utiliser le type Parquet FIXED_LEN_BYTE_ARRAY au lieu de Binary pour les colonnes FixedString.

​
output_format_parquet_geometadata

Permet d’écrire des informations sur les colonnes Geo dans les métadonnées Parquet et d’encoder les colonnes au format WKB.

​
output_format_parquet_max_dictionary_size

Si la taille du dictionnaire dépasse ce nombre d’octets, utilisez un encodage sans dictionnaire. Définissez cette valeur sur 0 pour désactiver l’encodage par dictionnaire.

​
output_format_parquet_parallel_encoding

Effectue l’encodage Parquet en parallèle sur plusieurs threads.

​
output_format_parquet_row_group_size

Taille cible du groupe de lignes, en lignes.

​
output_format_parquet_row_group_size_bytes

Taille cible du groupe de lignes, en octets, avant la compression.

​
output_format_parquet_string_as_string

Utiliser le type String de Parquet au lieu de Binary pour les colonnes String.

​
output_format_parquet_write_bloom_filter

Écrit des filtres de Bloom dans les fichiers Parquet.

​
output_format_parquet_write_checksums

Ajoute des sommes de contrôle CRC32 aux en-têtes de page Parquet.

​
output_format_parquet_write_page_index

Écrit l’index de colonne et l’index d’offset (c.-à-d. des statistiques sur chaque page de données, qui peuvent être utilisées pour le pushdown des filtres lors de la lecture) dans des fichiers Parquet.

​
output_format_pretty_color

Utilise les séquences d’échappement ANSI dans les formats Pretty. 0 - désactivé, 1 - activé, ‘auto’ - activé si la sortie est un terminal. Affiche les noms de colonnes dans le pied de page lorsqu’une table contient de nombreuses lignes. Valeurs possibles :
  • 0 — Aucun nom de colonne n’est affiché dans le pied de page.
  • 1 — Les noms de colonnes sont affichés dans le pied de page si le nombre de lignes est supérieur ou égal à la valeur seuil définie par output_format_pretty_display_footer_column_names_min_rows (50 par défaut).
Exemple Requête :
Résultat :
Définit le nombre minimal de lignes à partir duquel un pied de page contenant les noms des colonnes s’affiche si le paramètre output_format_pretty_display_footer_column_names est activé.

​
output_format_pretty_fallback_to_vertical

Si ce paramètre est activé et que la table est large mais peu haute, le format Pretty l’affiche comme le format Vertical. Consultez output_format_pretty_fallback_to_vertical_max_rows_per_chunk et output_format_pretty_fallback_to_vertical_min_table_width pour ajuster finement ce comportement.

​
output_format_pretty_fallback_to_vertical_max_rows_per_chunk

Le basculement vers le format Vertical (voir output_format_pretty_fallback_to_vertical) n’est activé que si le nombre de lignes dans un chunk ne dépasse pas la valeur spécifiée.

​
output_format_pretty_fallback_to_vertical_min_columns

Le basculement vers le format Vertical (voir output_format_pretty_fallback_to_vertical) ne s’active que si le nombre de colonnes est supérieur à la valeur spécifiée.

​
output_format_pretty_fallback_to_vertical_min_table_width

Le passage au format Vertical (voir output_format_pretty_fallback_to_vertical) ne sera activé que si la somme des longueurs des colonnes d’une table est au moins égale à la valeur spécifiée, ou si au moins une valeur contient un caractère de saut de ligne.

​
output_format_pretty_glue_chunks

Si les données affichées au format Pretty arrivent en plusieurs chunks, même avec un délai, mais que le chunk suivant a les mêmes largeurs de colonnes que le précédent, utilisez des séquences d’échappement ANSI pour revenir à la ligne précédente et écraser le pied de page du chunk précédent afin de le prolonger avec les données du nouveau chunk. Le résultat est ainsi plus agréable à l’œil. 0 - désactivé, 1 - activé, ‘auto’ - activé dans un terminal.

​
output_format_pretty_grid_charset

Jeu de caractères utilisé pour l’affichage des bordures de la grille. Jeux de caractères disponibles : ASCII, UTF-8 (par défaut). En mode interactif, clickhouse-client bascule automatiquement vers ASCII si le terminal ne prend pas en charge UTF-8 (tel que déterminé par les variables d’environnement LC_ALL, LC_CTYPE et LANG), sauf si ce paramètre est explicitement défini.

​
output_format_pretty_highlight_digit_groups

Si cette option est activée et si la sortie est un terminal, chaque chiffre correspondant aux milliers, millions, etc. est mis en évidence par soulignement.

​
output_format_pretty_highlight_trailing_spaces

Si cette option est activée et que la sortie est un terminal, les espaces de fin de ligne sont mis en évidence en gris et soulignés.

​
output_format_pretty_max_column_name_width_cut_to

Si le nom de la colonne est trop long, il est tronqué à cette longueur. La colonne est tronquée si sa longueur dépasse output_format_pretty_max_column_name_width_cut_to plus output_format_pretty_max_column_name_width_min_chars_to_cut.

​
output_format_pretty_max_column_name_width_min_chars_to_cut

Nombre minimum de caractères à tronquer si le nom de la colonne est trop long. Le nom de la colonne sera tronqué s’il dépasse output_format_pretty_max_column_name_width_cut_to plus output_format_pretty_max_column_name_width_min_chars_to_cut.

​
output_format_pretty_max_column_pad_width

Largeur maximale du remplissage appliqué à toutes les valeurs d’une colonne dans les formats Pretty.

​
output_format_pretty_max_rows

Limite du nombre de lignes pour les formats Pretty.

​
output_format_pretty_max_value_width

Largeur maximale de la valeur affichée dans les formats Pretty. Au-delà, elle sera tronquée. La valeur 0 signifie : ne jamais tronquer.

​
output_format_pretty_max_value_width_apply_for_single_value

Ne tronquez les valeurs (voir le paramètre output_format_pretty_max_value_width) que lorsqu’il ne s’agit pas d’une valeur seule dans un bloc. Sinon, affichez-la en entier, ce qui est utile pour la requête SHOW CREATE TABLE.

​
output_format_pretty_multiline_fields

Si cette option est activée, les formats Pretty afficheront les champs sur plusieurs lignes à l’intérieur des cellules du tableau, de sorte que les bordures du tableau soient préservées. Sinon, ils seront affichés tels quels, ce qui peut déformer le tableau (l’un des avantages de laisser cette option désactivée est qu’il sera plus facile de copier-coller des valeurs sur plusieurs lignes).

​
output_format_pretty_named_tuples_as_json

Contrôle si les tuples nommés dans le format Pretty sont affichés sous forme d’objets JSON mis en forme de manière lisible.

​
output_format_pretty_row_numbers

Ajouter les numéros de ligne avant chaque ligne pour le format de sortie Pretty

​
output_format_pretty_single_large_number_tip_threshold

Afficher une indication lisible du nombre sur le côté droit de la table si le bloc ne contient qu’un seul nombre dépassant cette valeur (hors 0)

​
output_format_pretty_squash_consecutive_ms

Attendre le bloc suivant pendant le nombre de millisecondes spécifié et le fusionner avec le précédent avant l’écriture. Cela évite d’émettre trop souvent des blocs trop petits, tout en permettant d’afficher les données en continu.

​
output_format_pretty_squash_max_wait_ms

Affiche le bloc en attente dans les formats Pretty si le nombre de millisecondes écoulées depuis la sortie précédente dépasse la valeur spécifiée.

​
output_format_pretty_use_nbsp_for_padding

S’il est activé, l’espacement de remplissage dans les formats de sortie Pretty est rendu avec U+00A0 au lieu d’un espace ASCII. La sortie reste visuellement identique dans une police à chasse fixe, mais cet espacement de remplissage est préservé par les outils qui compressent ou suppriment les suites d’espaces ordinaires. Ne prend effet que lorsque output_format_pretty_grid_charset vaut UTF-8.

​
output_format_protobuf_nullables_with_google_wrappers

Lors de la sérialisation de colonnes Nullable avec des wrappers Google, sérialisez les valeurs par défaut sous forme de wrappers vides. Si ce paramètre est désactivé, les valeurs par défaut et les valeurs NULL ne sont pas sérialisées

​
output_format_schema

Chemin du fichier dans lequel le schéma généré automatiquement sera enregistré aux formats Cap’n Proto ou Protobuf.

​
output_format_sql_insert_include_column_names

Inclut les noms de colonnes dans la requête INSERT

​
output_format_sql_insert_max_batch_size

Le nombre maximal de lignes dans une seule instruction INSERT.

​
output_format_sql_insert_quote_names

Met les noms de colonnes entre apostrophes inversées (« ` »)

​
output_format_sql_insert_table_name

Le nom de la table dans la requête INSERT en sortie

​
output_format_sql_insert_use_replace

Utiliser l’instruction REPLACE au lieu d’INSERT

​
output_format_trim_fixed_string

Supprime les octets nuls de fin des valeurs FixedString dans les formats de sortie textuels. Par exemple, toFixedString('John', 8) s’affiche sous la forme John au lieu de John\0\0\0\0.

​
output_format_tsv_crlf_end_of_line

Si cette option est définie sur true, la fin de ligne au format TSV sera \r\n au lieu de \n.

​
output_format_values_escape_quote_with_quote

Si true, échapper ’ en ”, sinon avec \‘

​
output_format_write_statistics

Écrit des statistiques concernant les lignes lues, les octets et le temps écoulé dans les formats de sortie compatibles. Activé par défaut

​
precise_float_parsing

Privilégier un algorithme d’analyse des nombres à virgule flottante plus précis (mais plus lent)

​
schema_inference_hints

La liste des noms de colonnes et des types à utiliser comme indications lors de l’inférence de schéma pour les formats sans schéma. Exemple : Requête :
Résultat :
Si schema_inference_hints n’est pas correctement formaté, ou s’il contient une faute de frappe, un type de données erroné, etc., l’intégralité de schema_inference_hints sera ignorée.

​
schema_inference_make_columns_nullable

Contrôle si les types inférés sont rendus Nullable lors de l’inférence de schéma. Valeurs possibles :
  • 0 - le type inféré ne sera jamais Nullable (utilisez input_format_null_as_default pour définir le comportement à adopter avec les valeurs nulles dans ce cas),
  • 1 - tous les types inférés seront Nullable,
  • 2 ou auto - le type inféré sera Nullable uniquement si la colonne contient NULL dans un échantillon analysé lors de l’inférence de schéma, ou si les métadonnées du fichier contiennent des informations sur la nullabilité de la colonne,
  • 3 - la nullabilité du type inféré correspondra aux métadonnées du fichier si le format la prend en charge (par ex. Parquet) ; sinon, il sera toujours Nullable (par ex. CSV).

​
schema_inference_make_json_columns_nullable

Contrôle si les types JSON inférés sont rendus Nullable lors de l’inférence de schéma. Si ce paramètre est activé avec schema_inference_make_columns_nullable, le type JSON inféré sera Nullable.

​
schema_inference_mode

Mode d’inférence de schéma. ‘default’ - suppose que tous les fichiers ont le même schéma et que celui-ci peut être inféré à partir de n’importe quel fichier, ‘union’ - les fichiers peuvent avoir des schémas différents et le schéma résultant doit être l’union des schémas de tous les fichiers

​
show_create_query_identifier_quoting_rule

Définit la règle de mise entre guillemets des identifiants pour la requête SHOW CREATE

​
show_create_query_identifier_quoting_style

Définit le style de citation des identifiants dans la requête SHOW CREATE

​
type_json_allow_duplicated_key_with_literal_and_nested_object

Lorsqu’elle est activée, cette option permet d’analyser des JSON tels que {"a" : 42, "a" : {"b" : 42}}, dans lesquels une clé est dupliquée mais où l’une des occurrences est un objet imbriqué.

​
type_json_skip_duplicated_paths

Lorsqu’il est activé, lors de l’analyse d’un objet JSON vers le type JSON, les chemins dupliqués sont ignorés et seul le premier est inséré au lieu de provoquer une exceptio

​
type_json_skip_invalid_typed_paths

Lorsqu’il est activé, les champs dont les valeurs ne peuvent pas être converties vers leur type déclaré dans des colonnes de type JSON avec des chemins typés sont ignorés au lieu de générer une erreur. Les champs ignorés sont traités comme des valeurs manquantes et utiliseront des valeurs par défaut ou NULL selon la définition du chemin typé. Ce paramètre s’applique uniquement aux colonnes de type JSON (par ex., JSON(a Int64, b String)) pour lesquelles des chemins spécifiques ont des types déclarés. Il ne s’applique pas aux formats d’entrée JSON ordinaires comme JSONEachRow lors d’un insert dans des colonnes typées ordinaires. Valeurs possibles :
  • 0 — Désactiver (générer une erreur en cas d’incompatibilité de type).
  • 1 — Activer (ignorer le champ en cas d’incompatibilité de type).

​
type_json_use_partial_match_to_skip_paths_by_regexp

Lorsqu’il est activé, lors de l’analyse d’un objet JSON vers le type JSON, les expressions régulières spécifiées à l’aide de SKIP REGEXP doivent présenter une correspondance partielle pour ignorer un chemin. Lorsqu’il est désactivé, une correspondance complète est requise.

​
validate_experimental_and_suspicious_types_inside_nested_types

Valider l’utilisation de types expérimentaux et suspects dans des types imbriqués tels que Array/Map/Tuple
Dernière modification le 2 juillet 2026