CSV

描述

逗号分隔值格式 (RFC) 。进行格式化时，行会用双引号括起来。字符串内的双引号会输出为两个连续的双引号。没有其他字符转义规则。

Date 和 date-time 会用双引号括起来。
数字输出时不加引号。
值之间由分隔符字符分隔，默认为 ,。分隔符字符由设置 format_csv_delimiter 定义。
行之间使用 Unix 换行符 (LF) 分隔。
Array 在 CSV 中按如下方式序列化：
- 首先，数组会像在 TabSeparated 格式中一样被序列化为字符串
- 然后，将生成的字符串用双引号括起来输出到 CSV。
Tuple 在 CSV 格式中会被序列化为单独的列 (也就是说，会丢失其在 Tuple 中的嵌套结构) 。

$ clickhouse-client --format_csv_delimiter="|" --query="INSERT INTO test.csv FORMAT CSV" < data.csv

默认情况下，分隔符为 , 更多信息请参见设置 format_csv_delimiter。

解析时，所有值都可以带引号或不带引号。支持双引号和单引号。行也可以不带引号。在这种情况下，会一直解析到分隔符或换行符 (CR 或 LF) 为止。不过，这不符合 RFC：解析不带引号的行时，会忽略行首和行尾的空格与制表符。支持以下换行类型：Unix (LF)、Windows (CR LF) 和 Mac OS Classic (CR LF)。 NULL 按照设置 format_csv_null_representation 进行格式化 (默认值为 \N) 。在输入数据中，ENUM 值可以表示为名称或 id。首先，我们会尝试将输入值与 ENUM 名称匹配。如果失败，且输入值是数值，则会尝试将该数值与 ENUM id 匹配。如果输入数据仅包含 ENUM id，建议启用设置 input_format_csv_enum_as_number 以优化 ENUM 解析。

使用示例

格式设置

设置	描述	默认值	备注
format_csv_delimiter	在 CSV 数据中用作分隔符的字符。	`,`
format_csv_allow_single_quotes	允许使用单引号括起来的字符串。	`true`
format_csv_allow_double_quotes	允许使用双引号括起来的字符串。	`true`
format_csv_null_representation	CSV 格式中自定义的 NULL 表示形式。	`\N`
input_format_csv_empty_as_default	将 CSV 输入中的空字段视为默认值。	`true`	对于复杂的默认表达式，还必须启用 input_format_defaults_for_omitted_fields。
input_format_csv_missing_nullable_as_empty_string	将缺失的 `Nullable(String)` 值读取为空字符串而不是 NULL，而不受 `input_format_csv_empty_as_default` 的影响。	`false`
input_format_csv_enum_as_number	将在 CSV 格式中插入的枚举值视为枚举索引。	`false`
input_format_csv_use_best_effort_in_schema_inference	在 CSV 格式的 schema inference 中使用一些优化和 heuristic。如果禁用，所有字段都会被推断为 String。	`true`
input_format_csv_arrays_as_nested_csv	从 CSV 读取数组时，要求其 elements 先按嵌套 CSV 进行序列化，再放入字符串中。	`false`
output_format_csv_crlf_end_of_line	如果设置为 true，CSV output format 的行尾将使用 `\r\n` 而不是 `\n`。	`false`
input_format_csv_skip_first_lines	跳过数据开头指定数量的行。	`0`
input_format_csv_detect_header	自动检测 CSV 格式中包含 names 和 types 的 header。	`true`
input_format_csv_skip_trailing_empty_lines	跳过数据末尾的 trailing empty lines。	`false`
input_format_csv_trim_whitespaces	去除未加引号的 CSV 字符串中的空格和制表符。	`true`
input_format_csv_allow_whitespace_or_tab_as_delimiter	允许在 CSV 字符串中使用空白字符或制表符作为字段分隔符。	`false`
input_format_csv_allow_variable_number_of_columns	允许 CSV 格式中的列数可变，忽略多余的列，并为缺失列使用默认值。	`false`
input_format_csv_use_default_on_bad_values	当 CSV field 因错误值导致 deserialization 失败时，允许为该列设置默认值。	`false`
input_format_csv_try_infer_numbers_from_strings	在 schema inference 期间，尝试从 string fields 中推断数值。	`false`

SQL 参考

数据类型

引擎

函数

格式

接口

设置

系统表

数据湖

描述

使用示例

格式设置

​描述

​使用示例

​格式设置

描述

使用示例

格式设置