# eKuiper 词汇元素

# 注释

注释被当作文档。注释以字符序列 /* 开始，并终止于对应的 */。

# 令牌（Tokens）

eKuiper SQL 由令牌构建。令牌分为四类：

标识符
关键字
运算符
字面量

由空格、水平制表符、回车符和换行符组成的空白符将被忽略，除非它将分隔的令牌分开，否则这些令牌会合并为一个令牌。在将输入分成令牌时，下一个令牌是形成有效令牌的最长字符序列。

# 标识符（Identifiers）

程序中的标识符命名实体。标识符是一个或多个字母和数字的序列。标识符必须以字母开头。

如果要将保留字用作列名和流名等，它们必须用反撇号将其括起来。您还可以在反引号中使用各种 unicode 字符串作为 SQL 元素。例如，运算符 -，空格和各种语言字符（例如中文）。

SELECT `select`, `and` from demo
SELECT `a-b`, `hello world`, `中文Chinese` from demo

1
2

# 关键字（Keywords）

规则 SQL 的保留关键字：如果您想在规则 SQL 中使用以下关键字，则必须使用反撇号将其括起来。

SELECT, FROM, JOIN, LEFT, INNER, ON, WHERE, GROUP, ORDER, HAVING, BY, ASC, DESC, AND, OR, CASE, WHEN, THEN, ELSE, END, IN, NOT, BETWEEN, LIKE, OVER, PARTITION

以下是使用名为 from 的流的示例，from 是 eKuiper 中的保留关键字。

SELECT * FROM demo1 where `from`="device1"

以下是如何在流创建语句中使用保留关键字的示例。

CREATE STREAM `stream` (
                    USERID BIGINT,
                    FIRST_NAME STRING,
                    LAST_NAME  STRING,
                    NICKNAMES  ARRAY(STRING),
                    Gender     BOOLEAN,
                    `地址`      STRUCT(STREET_NAME STRING, NUMBER BIGINT),
                ) WITH (DATASOURCE="users", FORMAT="JSON");

1
2
3
4
5
6
7
8

# 运算法（Operators）

提供了以下运算符。

+, -, *, /, %, &amp;, |, ^, =, !=, &lt;, &lt;=, >, >=, [], ->, (), IN, NOT IN, BETWEEN, NOT BETWEEN

# 字面量（Literals）

布尔字面量

TRUE, FALSE

例如，SELECT TRUE AS field1 FROM demo，field1字段总是返回 true。

时间字面量：下面的字面量在时间窗口中使用，用于标识窗口的时间单位。

DD, HH, MI, SS, MS

字符串字面量：

"user", 'user'

请注意，在命令行中使用单引号字符串字面量时可能会遇到以下问题：

$ bin/kuiper create rule myrule '{"sql": "SELECT lower('abc') FROM demo"...}'

在使用上述命令创建规则时，单引号字符串字面量中的 'abc' 会被识别为变量 abc，这是由于 Shell 的引用机制导致的：

$ echo '{"sql": "SELECT lower('abc') FROM demo"}'
{"sql": "SELECT lower(abc) FROM demo"}

1
2

如果遇到以上问题，建议使用双引号字符串字面量 "abc" 来代替单引号字符串字面量 'abc'，以避免变量替代的情况发生。

← 查询语句数据类型 →