From 646733046292fd7616e7412106ca6c8e31a3665f Mon Sep 17 00:00:00 2001 From: Alexander Tokmakov Date: Fri, 19 Jul 2019 16:57:50 +0300 Subject: [PATCH] update docs --- docs/en/interfaces/formats.md | 2 +- docs/en/operations/settings/settings.md | 9 +++++++++ docs/ru/interfaces/formats.md | 2 +- docs/ru/operations/settings/settings.md | 8 ++++++++ 4 files changed, 19 insertions(+), 2 deletions(-) diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md index 71f2826327..7a93d0614a 100644 --- a/docs/en/interfaces/formats.md +++ b/docs/en/interfaces/formats.md @@ -173,7 +173,7 @@ Empty unquoted input values are replaced with default values for the respective [input_format_defaults_for_omitted_fields](../operations/settings/settings.md#session_settings-input_format_defaults_for_omitted_fields) is enabled. -`NULL` is formatted as `\N`. +`NULL` is formatted as `\N` or `NULL` or an empty unquoted string (see settings [format_csv_unquoted_null_literal_as_null](../operations/settings/settings.md#settings-format_csv_unquoted_null_literal_as_null) and [input_format_defaults_for_omitted_fields](../operations/settings/settings.md#settings-input_format_defaults_for_omitted_fields)). The CSV format supports the output of totals and extremes the same way as `TabSeparated`. diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md index c68643d387..7de2d86120 100644 --- a/docs/en/operations/settings/settings.md +++ b/docs/en/operations/settings/settings.md @@ -211,6 +211,11 @@ Possible values: Default value: 0. +## input_format_null_as_default {#settings-input_format_null_as_default} + +Enables or disables using default values if input data contain `NULL`, but data type of corresponding column in not `Nullable(T)` (for CSV format). + + ## input_format_skip_unknown_fields {#settings-input_format_skip_unknown_fields} Enables or disables skipping insertion of extra data. @@ -689,6 +694,10 @@ If the value is true, integers appear in quotes when using JSON\* Int64 and UInt The character interpreted as a delimiter in the CSV data. By default, the delimiter is `,`. +## format_csv_unquoted_null_literal_as_null {#settings-format_csv_unquoted_null_literal_as_null} + +For CSV input format enables or disables parsing of unquoted `NULL` as literal (synonym for `\N`). + ## insert_quorum {#settings-insert_quorum} Enables quorum writes. diff --git a/docs/ru/interfaces/formats.md b/docs/ru/interfaces/formats.md index c02ed3d499..70a4e608e2 100644 --- a/docs/ru/interfaces/formats.md +++ b/docs/ru/interfaces/formats.md @@ -165,7 +165,7 @@ clickhouse-client --format_csv_delimiter="|" --query="INSERT INTO test.csv FORMA При парсинге, все значения могут парситься как в кавычках, так и без кавычек. Поддерживаются как двойные, так и одинарные кавычки. Строки также могут быть без кавычек. В этом случае они парсятся до символа-разделителя или перевода строки (CR или LF). В нарушение RFC, в случае парсинга строк не в кавычках, начальные и конечные пробелы и табы игнорируются. В качестве перевода строки, поддерживаются как Unix (LF), так и Windows (CR LF) и Mac OS Classic (LF CR) варианты. -`NULL` форматируется в виде `\N`. +`NULL` форматируется в виде `\N` или `NULL` или пустой неэкранированной строки (см. настройки [format_csv_unquoted_null_literal_as_null](../operations/settings/settings.md#settings-format_csv_unquoted_null_literal_as_null) и [input_format_defaults_for_omitted_fields](../operations/settings/settings.md#settings-input_format_defaults_for_omitted_fields)). Формат CSV поддерживает вывод totals и extremes аналогично `TabSeparated`. diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md index e320231d39..53a4eb181e 100644 --- a/docs/ru/operations/settings/settings.md +++ b/docs/ru/operations/settings/settings.md @@ -203,6 +203,10 @@ Ok. Значение по умолчанию: 0. +## input_format_null_as_default {#settings-input_format_null_as_default} + +Включает или отключает использование значений по-умолчанию в случаях, когда во входных данных содержится `NULL`, но тип соответствующего столбца не `Nullable(T)` (для фомата CSV). + ## input_format_skip_unknown_fields {#settings-input_format_skip_unknown_fields} Включает или отключает пропускание вставки неизвестных данных. @@ -609,6 +613,10 @@ load_balancing = first_or_random Символ, интерпретируемый как разделитель в данных формата CSV. По умолчанию — `,`. +## format_csv_unquoted_null_literal_as_null {#settings-format_csv_unquoted_null_literal_as_null} + +Для формата CSV включает или выключает парсинг неэкранированной строки `NULL` как литерала (синоним для `\N`) + ## insert_quorum {#settings-insert_quorum} Включает кворумную запись. -- GitLab