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

output_format_always_write_decimal_point_in_float_and_decimal

Toujours afficher un point décimal pour les nombres en virgule flottante et 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 pour le 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 simples nombres 16 bits (relus en tant que UInt16), au lieu de les convertir en type Arrow DATE32 32 bits (relu en tant que Date32).

output_format_arrow_fixed_string_as_fixed_byte_array

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

output_format_arrow_low_cardinality_as_dictionary

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

output_format_arrow_string_as_string

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

output_format_arrow_unsupported_types_as_binary

Les types de sortie sans conversion sont émis sous forme de données binaires brutes. Si false, ces types génèrent une exception UNKNOWN_TYPE.

output_format_arrow_use_64_bit_indexes_for_dictionary

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

output_format_arrow_use_native_writer

Utilisez le module d’écriture natif de ClickHouse pour les formats Arrow et ArrowStream au lieu de celui basé sur la bibliothèque Apache 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é pour la sortie. Valeurs possibles : ‘null’, ‘deflate’, ‘snappy’, ‘zstd’.

output_format_avro_confluent_subject

Pour le format de sortie AvroConfluent : le nom du sujet 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 comme chaînes 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 au lieu des 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 String contenant du JSON 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 si la sortie de la requête est compressée. Ce paramètre s’applique lorsque la requête SELECT contient 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 ce paramètre est supérieur à 0, il 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 permettre d’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 cette option est réglée sur true, la fin de ligne au format CSV sera \r\n au lieu de \n.

output_format_csv_header_serialize_tuple_into_separate_columns

Lorsque output_format_csv_serialize_tuple_into_separate_columns est activé, les lignes d’en-tête de CSVWithNames et CSVWithNamesAndTypes développent chaque colonne Tuple en ses champs feuilles (noms pointés comme t.a, t.b, ainsi que les noms de type des feuilles), de sorte que l’en-tête comporte le même nombre de colonnes que les données. Pour CustomSeparated*, ce développement s’applique uniquement lorsque format_custom_escaping_rule = 'CSV' et que format_custom_field_delimiter est un caractère unique identique à format_csv_delimiter ; sinon (par exemple avec le délimiteur de tabulation par défaut ou format_custom_field_delimiter = '|'), l’en-tête n’est pas développé afin de continuer à correspondre aux données. Définissez-le sur 0 pour conserver le comportement précédent, où l’en-tête garde le nom et le type uniques du Tuple de niveau supérieur. Remarque : un en-tête développé n’est pas relu dans un Tuple par nom lorsque input_format_with_names_use_header = 1. Pour relire ces données dans un Tuple, définissez soit ce paramètre sur 0 en sortie, soit lisez-les avec input_format_with_names_use_header = 0 (et, pour les formats *WithNamesAndTypes CSVWithNamesAndTypes et CustomSeparatedWithNamesAndTypes, également input_format_with_types_use_header = 0, car la ligne de types développée est sinon validée par rapport à l’unique champ Tuple d’entrée de niveau supérieur, puis rejetée).

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 en colonnes distinctes (c’est-à-dire que leur imbrication au sein du tuple est perdue)

output_format_decimal_trailing_zeros

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

output_format_float_precision

Lorsqu’elle est différente de zéro, formate la sortie des nombres à virgule flottante (Float32, Float64, BFloat16) avec au plus ce nombre de chiffres après le séparateur décimal (les zéros de fin sont supprimés). Lorsque la valeur est 0 (par défaut), utilise la représentation aller-retour la plus courte. 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 : de 0 à 100.

output_format_image_height

Hauteur, en pixels, de l’image produite 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, affichez 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 renvoyer toutes les lignes sous la forme d’un tableau JSON au format JSONEachRow. Valeurs possibles :
  • 1 — ClickHouse renvoie toutes les lignes sous la forme d’un tableau, chaque ligne étant au format JSONEachRow.
  • 0 — ClickHouse renvoie chaque ligne séparément au format JSONEachRow.
Exemple de requête avec le 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 slashs dans les chaînes de sortie au format de sortie JSON. Ce paramètre vise à assurer la compatibilité avec JavaScript. Ne pas confondre avec les antislashs, qui sont toujours échappés. Activé par défaut.

output_format_json_map_as_array_of_tuples

Sérialise les colonnes de type 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 la manière dont 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 de la sortie suivante :
La sortie se présentera comme suit :
Activé par défaut.

output_format_json_quote_64bit_floats

Contrôle la mise entre guillemets des Float 64 bits lorsqu’ils sont générés dans les formats JSON*. Désactivé par défaut.

output_format_json_quote_64bit_integers

Contrôle la mise entre guillemets des entiers de 64 bits ou plus (par exemple UInt64 ou Int128) lorsqu’ils sont renvoyé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 renvoyé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’afficher les sorties +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 en sortie :
Lorsque output_format_json_quote_denormals = 1, la requête renvoie :

output_format_json_skip_null_value_in_named_tuples

Ignore les paires clé-valeur dont la valeur est nulle 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 vaut 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 sont échappés en Markdown. 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 représenté en sortie au format MsgPack.

output_format_native_encode_types_in_binary_format

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

output_format_native_use_flattened_dynamic_and_json_serialization

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

output_format_native_write_json_as_string

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

output_format_orc_compression_block_size

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

output_format_orc_compression_method

Méthode de compression du 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 chaînes au format de sortie ORC, si le nombre de valeurs distinctes est supérieur à 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 du format de sortie ORC

output_format_orc_string_as_string

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

output_format_orc_writer_time_zone_name

Le nom du fuseau horaire utilisé par le writer ORC ; par défaut, le writer ORC utilise le fuseau horaire GMT.

output_format_parallel_formatting

Active ou désactive le formatage parallèle des formats de 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 N lignes. Envisagez de diminuer cette valeur 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 filtre de Bloom de 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 la valeur est 0, les filtres de Bloom de chaque groupe de lignes sont écrits immédiatement après le groupe de lignes,
    • si elle 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 du format de sortie Parquet. Codecs pris en charge : snappy, lz4, brotli, zstd, gzip, none (non compressé)

output_format_parquet_data_page_size

Taille de page cible, en octets, avant compression.

output_format_parquet_date_as_uint16

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

output_format_parquet_datetime_as_uint32

Écrire les valeurs DateTime sous forme d’horodatage Unix brut (relues comme UInt32), au lieu de les convertir en millisecondes (relues comme DateTime64(3)).

output_format_parquet_enum_as_byte_array

Écrire les enum en utilisant 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, l’encodage bascule vers un mode 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 nombre de lignes.

output_format_parquet_row_group_size_bytes

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

output_format_parquet_string_as_string

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

output_format_parquet_write_bloom_filter

Écrire des filtres de Bloom dans les fichiers Parquet.

output_format_parquet_write_checksums

Insère des sommes de contrôle CRC32 dans les en-têtes de page Parquet.

output_format_parquet_write_page_index

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

output_format_pretty_color

Utilise les séquences d’échappement ANSI dans les format Pretty. 0 - désactivé, 1 - activé, ‘auto’ - activé si la sortie se fait dans un terminal. Afficher les noms de colonnes dans le pied de page lorsqu’il y a beaucoup de lignes dans le tableau. 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 de 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 affichant les noms des colonnes est présenté si le paramètre output_format_pretty_display_footer_column_names est activé.

output_format_pretty_fallback_to_vertical

S’il est activé et que la table est large mais comporte peu de lignes, 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 régler ce comportement plus finement.

output_format_pretty_fallback_to_vertical_max_rows_per_chunk

Le basculement vers le format Vertical (voir output_format_pretty_fallback_to_vertical) ne s’active que si le nombre d’enregistrements dans un chunk est inférieur ou égal à 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) s’active uniquement si le nombre de colonnes est supérieur à la valeur spécifiée.

output_format_pretty_fallback_to_vertical_min_table_width

Le basculement vers le 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 retour à la ligne.

output_format_pretty_glue_chunks

Si les données affichées dans les formats 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 remplacer 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é si la sortie se fait 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 lorsque le terminal ne prend pas en charge UTF-8 (selon 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 souligné.

output_format_pretty_highlight_trailing_spaces

Si ce paramètre est activé 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, tronquez-le à cette longueur. La colonne sera 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 minimal de caractères à supprimer 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 de remplissage appliquée à toutes les valeurs d’une colonne dans les formats Pretty.

output_format_pretty_max_rows

Limite 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 tronquer les valeurs (voir le paramètre output_format_pretty_max_value_width) que lorsqu’il ne s’agit pas d’une valeur isolée dans un bloc. Sinon, les afficher intégralement, 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 risque de déformer le tableau (l’un des avantages de laisser cette option désactivée est que le copier-coller de valeurs sur plusieurs lignes sera plus facile).

output_format_pretty_named_tuples_as_json

Détermine si les tuples nommés au format Pretty sont affichés sous forme d’objets JSON avec une mise en forme lisible.

output_format_pretty_row_numbers

Ajoute des numéros de ligne avant chaque ligne pour le format de sortie Pretty

output_format_pretty_single_large_number_tip_threshold

Affiche, à droite du tableau, une indication lisible pour un nombre si le bloc est constitué d’un seul nombre supérieur à cette valeur (sauf 0)

output_format_pretty_squash_consecutive_ms

Attend le bloc suivant pendant le nombre de millisecondes spécifié au maximum, puis le fusionne avec le précédent avant l’écriture. Cela évite de produire trop souvent des blocs trop petits, tout en permettant d’afficher les données en mode streaming.

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é, les espaces de remplissage dans les formats de sortie Pretty sont rendus avec U+00A0 au lieu d’un espace ASCII. La sortie reste visuellement identique avec une police à chasse fixe, mais ces espaces de remplissage sont préservés 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 les wrappers Google, sérialisez les valeurs par défaut sous forme de wrappers vides. Si cette option est désactivée, 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

Inclure les noms de colonnes dans la requête INSERT

output_format_sql_insert_max_batch_size

Le nombre maximal de lignes dans une instruction INSERT.

output_format_sql_insert_quote_names

Mettre les noms de colonnes entre des caractères ’`‘

output_format_sql_insert_table_name

Le nom de la table dans la requête INSERT générée en sortie

output_format_sql_insert_use_replace

Utiliser l’instruction REPLACE au lieu de l’instruction INSERT

output_format_trim_fixed_string

Supprime les octets nuls en fin de valeur FixedString dans les formats de sortie textuels. Par ex., toFixedString('John', 8) s’affiche comme John au lieu de John\0\0\0\0.

output_format_tsv_crlf_end_of_line

Si ce paramètre est défini 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, échappe ’ par ”, sinon avec \‘

output_format_write_statistics

Écrit des statistiques sur le nombre de lignes et d’octets lus, ainsi que sur le temps écoulé, dans les formats de sortie appropriés. Activé par défaut
Dernière modification le 23 juillet 2026