SELECT 查询

SELECT 查询执行数据检索。默认情况下，请求的数据会返回给客户端，而与 INSERT INTO 结合使用时，可以转发到不同的表。

语法

[WITH expr_list(subquery)]
SELECT [DISTINCT [ON (column1, column2, ...)]] expr_list
[FROM [db.]table | (subquery) | table_function] [FINAL]
[SAMPLE sample_coeff]
[ARRAY JOIN ...]
[GLOBAL] [ANY|ALL|ASOF] [INNER|LEFT|RIGHT|FULL|CROSS] [OUTER|SEMI|ANTI] JOIN (subquery)|table [(alias1 [, alias2 ...])] (ON <expr_list>)|(USING <column_list>)
[PREWHERE expr]
[WHERE expr]
[GROUP BY expr_list] [WITH ROLLUP|WITH CUBE] [WITH TOTALS]
[HAVING expr]
[WINDOW window_expr_list]
[QUALIFY expr]
[ORDER BY expr_list] [WITH FILL] [FROM expr] [TO expr] [STEP expr] [INTERPOLATE [(expr_list)]]
[LIMIT [offset_value, ]n BY columns]
[LIMIT [n, ]m] [WITH TIES]
[SETTINGS ...]
[UNION  ...]
[INTO OUTFILE filename [COMPRESSION type [LEVEL level]] ]
[FORMAT format]

除了 SELECT 后面所需的表达式列表之外，所有子句都是可选的，详细信息如下 下文。

每个可选子句的细节在单独的部分中介绍，这些部分按执行顺序列出：

• WITH 子句
• SELECT 子句
• DISTINCT 子句
• FROM 子句
• SAMPLE 子句
• JOIN 子句
• PREWHERE 子句
• WHERE 子句
• WINDOW 子句
• GROUP BY 子句
• LIMIT BY 子句
• HAVING 子句
• QUALIFY 子句
• LIMIT 子句
• OFFSET 子句
• UNION 子句
• INTERSECT 子句
• EXCEPT 子句
• INTO OUTFILE 子句
• FORMAT 子句

SELECT 子句

在 SELECT 子句中指定的表达式 在上述子句中的所有操作完成后计算。这些表达式的作用是应用于结果中的单独行。如果 SELECT 子句中的表达式包含聚合函数，则 ClickHouse 在执行 GROUP BY 聚合时处理聚合函数及其参数所用的表达式。

如果您想在结果中包含所有列，可以使用星号 (*) 符号。例如，SELECT * FROM ...。

动态列选择

动态列选择（也称为 COLUMNS 表达式）允许您将结果中的某些列与 re2 正则表达式进行匹配。

COLUMNS('regexp')

例如，考虑这个表：

CREATE TABLE default.col_names (aa Int8, ab Int8, bc Int8) ENGINE = TinyLog

以下查询选择所有名称中包含 a 符号的列的数据。

SELECT COLUMNS('a') FROM col_names

┌─aa─┬─ab─┐
│  1 │  1 │
└────┴────┘

选中的列不会按字母顺序返回。

您可以在一个查询中使用多个 COLUMNS 表达式并对它们应用函数。

例如：

SELECT COLUMNS('a'), COLUMNS('c'), toTypeName(COLUMNS('c')) FROM col_names

┌─aa─┬─ab─┬─bc─┬─toTypeName(bc)─┐
│  1 │  1 │  1 │ Int8           │
└────┴────┴────┴────────────────┘

通过 COLUMNS 表达式返回的每一列都作为单独的参数传递给函数。如果函数支持，您还可以传递其他参数。在使用函数时要小心。如果函数不支持您传递的参数数量，ClickHouse 将抛出异常。

例如：

SELECT COLUMNS('a') + COLUMNS('c') FROM col_names

Received exception from server (version 19.14.1):
Code: 42. DB::Exception: Received from localhost:9000. DB::Exception: Number of arguments for function plus does not match: passed 3, should be 2.

在此示例中，COLUMNS('a') 返回两列：aa 和 ab。COLUMNS('c') 返回 bc 列。+ 运算符无法应用于 3 个参数，因此 ClickHouse 抛出异常并给出相关消息。

匹配 COLUMNS 表达式的列可以具有不同的数据类型。如果 COLUMNS 没有匹配任何列，并且是 SELECT 中的唯一表达式，ClickHouse 将抛出异常。

星号

您可以在查询的任何部分使用星号来代替表达式。当查询被分析时，星号会展开为所有表列的列表（不包括 MATERIALIZED 和 ALIAS 列）。只有在少数几种情况下，使用星号是合理的：

• 创建表转储时。
• 对于只包含少数列的表，例如系统表。
• 获取表中哪些列的信息。在这种情况下，设置 LIMIT 1。但是，最好使用 DESC TABLE 查询。
• 当使用 PREWHERE 对少数列进行强过滤时。
• 在子查询中（因为不需要用于外部查询的列会被排除在子查询之外）。

在所有其他情况下，我们不建议使用星号，因为它只会带来列式数据库管理系统的缺点，而不是优点。换句话说，不推荐使用星号。

极值

除了结果之外，您还可以获取结果列的最小值和最大值。要做到这一点，请将 extremes 设置为 1。最小值和最大值适用于数值类型、日期和带时间的日期。对于其他列，输出默认值。

额外计算两行 - 最小值和最大值。以 XML、JSON*、TabSeparated*、CSV*、Vertical、Template 和 Pretty* 格式 输出这两行，且与其他行分开。对于其他格式，则不会输出。

在 JSON* 和 XML 格式中，极值在单独的 'extremes' 字段中输出。在 TabSeparated*、CSV* 和 Vertical 格式中，该行位于主结果之后，并在 'totals' 之后（如果存在）。该行前面有一空行（在其他数据之后）。在 Pretty* 格式中，该行作为主结果之后的单独表输出，并在 'totals' 之后（如果存在）。在 Template 格式中，极值根据指定模板输出。

在 LIMIT 之前计算极值行，但在 LIMIT BY 之后。然而，当使用 LIMIT offset, size 时，offset 之前的行包括在 extremes 中。在流请求中，结果还可能包括通过 LIMIT 的少量行。

注意事项

您可以在查询的任何部分使用同义词（AS 别名）。

GROUP BY、ORDER BY 和 LIMIT BY 子句可以支持位置参数。要启用此功能，请打开 enable_positional_arguments 设置。例如，ORDER BY 1,2 将按第一列和第二列对表中的行进行排序。

实现细节

如果查询省略了 DISTINCT、GROUP BY 和 ORDER BY 子句以及 IN 和 JOIN 子查询，则查询将完全通过流处理，使用 O(1) 的内存。否则，如果未指定适当的限制，查询可能消耗大量内存：

• max_memory_usage
• max_rows_to_group_by
• max_rows_to_sort
• max_rows_in_distinct
• max_bytes_in_distinct
• max_rows_in_set
• max_bytes_in_set
• max_rows_in_join
• max_bytes_in_join
• max_bytes_before_external_sort
• max_bytes_ratio_before_external_sort
• max_bytes_before_external_group_by
• max_bytes_ratio_before_external_group_by

有关更多信息，请参阅“设置”部分。可以使用外部排序（将临时表保存到磁盘）和外部聚合。

SELECT 修饰符

您可以在 SELECT 查询中使用以下修饰符。

修饰符	描述
APPLY	允许您对查询外部表表达式返回的每一行调用某个函数。
EXCEPT	指定要从结果中排除的一个或多个列的名称。所有匹配的列名都将从输出中省略。
REPLACE	指定一个或多个表达式别名。每个别名必须与 SELECT * 语句中的列名匹配。在输出列列表中，与别名匹配的列被该 REPLACE 中的表达式替换。此修饰符不会更改列的名称或顺序。但是，它可以更改值和值类型。

修饰符组合

您可以分别使用每个修饰符或将它们组合在一起。

示例：

多次使用同一修饰符。

SELECT COLUMNS('[jk]') APPLY(toString) APPLY(length) APPLY(max) FROM columns_transformers;

┌─max(length(toString(j)))─┬─max(length(toString(k)))─┐
│                        2 │                        3 │
└──────────────────────────┴──────────────────────────┘

在单个查询中使用多个修饰符。

SELECT * REPLACE(i + 1 AS i) EXCEPT (j) APPLY(sum) from columns_transformers;

┌─sum(plus(i, 1))─┬─sum(k)─┐
│             222 │    347 │
└─────────────────┴────────┘

SELECT 查询中的 SETTINGS

您可以在 SELECT 查询中直接指定必要的设置。设置值仅应用于此查询，并在查询执行后重置为默认值或之前的值。

有关设置的其他方式，请参见 这里。

对于布尔设置，如果设置为 true，可以通过省略值分配的简写语法来使用。当仅指定设置名称时，它会自动设置为 1（true）。

示例

SELECT * FROM some_table SETTINGS optimize_read_in_order=1, cast_keep_nullable=1;