SQL语法

    含INSERT INTO t VALUES 的部分由完整SQL解析器处理，包含数据的部分 (1, 'Hello, world'), (2, 'abc'), (3, 'def') 交给快速流式解析器解析。通过设置参数 input_format_values_interpret_expressions，你也可以对数据部分开启完整SQL解析器。当 input_format_values_interpret_expressions = 1 时，ClickHouse优先采用快速流式解析器来解析数据。如果失败，ClickHouse再尝试用完整SQL解析器来处理，就像处理SQL 一样。

    数据可以采用任何格式。当CH接收到请求时，服务端先在内存中计算不超过 max_query_size 字节的请求数据（默认1 mb），然后剩下部分交给快速流式解析器。

    当 INSERT 语句中使用 Values 格式时，看起来数据部分的解析和解析SELECT 中的表达式相同，但并不是这样的。 Values 格式有非常多的限制。

    本文的剩余部分涵盖了完整SQL解析器。关于格式解析的更多信息，参见 章节。

    sql语句的语法结构部分之间（标识符之间、部分符号之间、包括sql的起始和结束）可以有任意的空白字符，这些空字符类型包括：空格字符，tab制表符，换行符，CR符，换页符等。

    注释

    ClickHouse支持SQL风格或C语言风格的注释：

    • SQL风格的注释以 -- 开始，直到行末，-- 后紧跟的空格可以忽略
    • C语言风格的注释以 /* 开始，以 */ 结束，可以跨行，同样可以省略 /* 后的空格

    关键字

    以下场景的关键字是大小写不敏感的：

    • 标准SQL。例如，SELECT, select 和 SeLeCt 都是允许的

    你可以在系统表 system.data_type_families 中检查某个数据类型的名称是否是大小写敏感型。

    和标准SQL相反，所有其它的关键字都是 大小写敏感的，包括函数名称。

    关键字不是保留的；它们仅在相应的上下文中才会被认为是关键字。如果你使用和关键字同名的 ，需要使用双引号或反引号将它们包含起来。例如：如果表 table_name 包含列 "FROM"，那么 SELECT "FROM" FROM table_name 是合法的

    标识符包括：

    • 集群、数据库、表、分区、列的名称
    • 函数
    • 数据类型
    • 表达式别名

    变量名可以被括起或不括起，后者是推荐做法。

    没有括起的变量名，必须匹配正则表达式 ^[a-zA-Z_][0-9a-zA-Z_]*$，并且不能和 相同，合法的标识符名称：x，_1，X_y__Z123_等。

    字符

    字符包含数字，字母，括号，NULL值等字符。

    数字类型字符会被做如下解析：

    • 首先，当做64位的有符号整数，使用函数

    • 如果失败，解析成64位无符号整数，同样使用函数 strtoull

    • 如果还失败了，试图解析成浮点型数值，使用函数

    • 最后，以上情形都不符合时，返回异常

    数字类型的值类型为能容纳该值的最小数据类型。
    例如：1 解析成 UInt8型，256 则解析成 。更多信息，参见 数据类型

    例如: 1, 18446744073709551615, 0xDEADBEEF, 01, 0.1, 1e100, -1e-100, inf, nan.

    ClickHouse只支持用单引号包含的字符串。特殊字符可通过反斜杠进行转义。下列转义字符都有相应的实际值： \b, \f, \r, \n, \t, \0, \a, \v, \xHH。其它情况下，以 \c形式出现的转义字符，当c表示任意字符时，转义字符会转换成c。这意味着你可以使用 \'和\\。该值将拥有类型。

    在字符串中，你至少需要对 ' 和 \ 进行转义。单引号可以使用单引号转义，例如 'It\'s' 和 'It''s' 是相同的。

    数组都是使用方括号进行构造 [1, 2, 3]，元组则使用圆括号
    从技术上来讲，这些都不是字符串，而是包含创建数组和元组运算符的表达式。
    创建一个数组必须至少包含一个元素，创建一个元组至少包含2个元素
    当元组出现在 SELECT 查询的 IN 部分时，是一种例外情形。查询结果可以包含元组，但是元组类型不能保存到数据库中（除非表采用 内存表引擎）

    代表不存在的值。

    为了能在表字段中存储NULL值，该字段必须声明为 类型。
    根据数据的格式（输入或输出），NULL值有不同的表现形式。更多信息参见文档 数据格式

    在处理 NULL时存在很多细微差别。例如，比较运算的至少一个参数为 NULL ，则该结果也是 NULL 。与之类似的还有乘法运算, 加法运算,以及其它运算。更多信息，请参阅每种运算的文档部分。

    函数

    函数调用的写法，类似于一个标识符后接被圆括号包含的参数列表（可能为空）。与标准SQL不同，圆括号是必须的，不管参数列表是否为空。例如： now()。

    函数分为常规函数和聚合函数（参见“Aggregate functions”一章）。有些聚合函数包含2个参数列表，第一个参数列表中的参数被称为“parameters”。不包含“parameters”的聚合函数语法和常规函数是一样的。

    在查询解析阶段，运算符会被转换成对应的函数，使用时请注意它们的优先级。例如：
    表达式 1 + 2 * 3 + 4 会被解析成 plus(plus(1, multiply(2, 3)), 4).

    数据类型及数据库/表引擎

    CREATE 语句中的数据类型和表引擎写法与变量或函数类似。
    换句话说，它们可以包含或不包含用括号包含的参数列表。更多信息，参见“数据类型,” “数据表引擎” 和 “CREATE语句”等章节

    表达式别名

    别名是用户对表达式的自定义名称

    • AS — 用于定义别名的关键字。可以对表或select语句中的列定义别名(AS 可以省略）
      例如, SELECT table_name_alias.column_name FROM table_name table_name_alias.

    在 CAST函数 中，AS有其它含义。请参见该函数的说明部分。

    例如, SELECT column_name * 2 AS double FROM some_table.

    • alias — expr 的名称。别名必须符合 语法.

    例如, SELECT "table t".column_name FROM table_name AS "table t".

    别名在当前查询或子查询中是全局可见的，你可以在查询语句的任何位置对表达式定义别名

    别名在当前查询的子查询及不同子查询中是不可见的。例如，执行如下查询SQL: SELECT (SELECT sum(b.a) + num FROM b) - a.a AS num FROM a ,ClickHouse会提示异常 Unknown identifier: num.

    如果给select子查询语句的结果列定义其别名，那么在外层可以使用该别名。例如, SELECT n + m FROM (SELECT 1 AS n, 2 AS m).

    注意列的别名和表的别名相同时的情形，考虑如下示例：

    在这个示例中，先声明了表 t 以及列 b。然后，在查询数据时，又定义了别名 sum(b) AS b。由于别名是全局的，ClickHouse使用表达式 sum(b) 来替换表达式 中的变量 b。这种替换导致出现异常。

    表达式

    表达式是函数、标识符、字符、使用运算符的语句、括号中的表达式、子查询或星号。它也可以包含别名。
    表达式列表是用逗号分隔的一个或多个表达式。
    反过来，函数和运算符可以将表达式作为参数。