Values

Values 格式文档

输入	输出	别名
✔	✔

​

描述

Values 格式会将每行输出为方括号括起来的形式。

• 各行之间以逗号分隔，最后一行后不加逗号。
• 方括号内的值也以逗号分隔。
• 数字以十进制格式输出，不带引号。
• 数组输出为 []。
• 字符串、日期和日期时间会带引号输出。
• 转义规则和解析方式与 TabSeparated 格式类似。

格式化时不会插入额外空格；但解析时允许空格并会将其跳过 (数组值内部的空格除外，此处不允许空格) 。 NULL 表示为 NULL。

以 Values 格式传递数据时，至少需要转义以下字符：

• 单引号
• 反斜杠

这是 INSERT INTO t VALUES ... 中使用的格式，但也可以用来格式化查询结果。

​

示例用法

​

插入数据

Values 格式就是 INSERT 使用的格式，因此任何 INSERT ... VALUES 语句 实际上都已经在使用这种格式。也可以显式指定 FORMAT Values 子句，并且 这些行可以通过 stream 或文件提供。每一行都是一个用括号括起来、以逗号分隔的元组， 而元组之间也同样用逗号分隔：

Query

CREATE TABLE t (id UInt32, name String, values Array(UInt32)) ENGINE = Memory;

INSERT INTO t FORMAT Values (1, 'a', [10, 20]), (2, 'b', [30]);

SELECT * FROM t ORDER BY id;

Response

┌─id─┬─name─┬─values──┐
│  1 │ a    │ [10,20] │
│  2 │ b    │ [30]    │
└────┴──────┴─────────┘

​

在输入中使用表达式

与大多数输入格式不同，Values 可以对每个字段中的 SQL 表达式求值， 而不只是接受字面量。这由 input_format_values_interpret_expressions 控制 (默认 启用) ：当某个字段无法由快速流式解析器解析时，ClickHouse 会回退到 SQL 解析器，并将该字段作为表达式来解释。

Query

CREATE TABLE prices (item String, total UInt32) ENGINE = Memory;

INSERT INTO prices FORMAT Values ('apple', 3 * 4), ('pear', length('hello') + 10);

SELECT * FROM prices ORDER BY total;

Response

┌─item──┬─total─┐
│ apple │    12 │
│ pear  │    15 │
└───────┴───────┘

​

查询数据

Values 格式也可用于格式化查询结果。数字 不加引号，数组写在 [] 中，字符串和日期用单引号括起； 字符串中的单引号和反斜杠需要用反斜杠转义，而 NULL 则写作 NULL：

Query

SELECT 1 AS a, 'O''Reilly' AS b, NULL::Nullable(String) AS c FORMAT Values;

Response

(1,'O\'Reilly',NULL)

​

格式设置

设置	描述	默认值
input_format_values_interpret_expressions	如果字段无法由流式解析器解析，则运行 SQL 解析器并尝试将其解释为 SQL 表达式。	true
input_format_values_deduce_templates_of_expressions	如果字段无法由流式解析器解析，则运行 SQL 解析器，推导出 SQL 表达式的模板，尝试使用该模板解析所有行，然后将其作为表达式解释应用到所有行。	true
input_format_values_accurate_types_of_literals	在使用模板解析和解释表达式时，检查字面量的实际类型，以避免可能出现的溢出和精度问题。	true