全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

支持的SQL语法

最近更新时间:2026-11-18 17:42:29

SelectObject 支持一条标准 SELECT 语句,从虚拟表 KS3Object 查询数据,语法为 MySQL 兼容方言。

支持的语句与子句

语句/子句

说明

SELECT

投影:列、*、表达式、函数、聚合函数、列别名 AS

FROM

固定 KS3Object,可带别名(FROM KS3Object s / AS s)

WHERE

行过滤;支持比较、逻辑、模式匹配、集合、范围、NULL/布尔判断;不支持聚合

LIMIT

LIMIT n 限制返回行数

不支持的语句与子句

以下均返回 400 SQLParsingError:

  • JOIN(所有变体)

  • GROUP BY、HAVING

  • ORDER BY、OFFSET

  • DISTINCT

  • UNION、INTERSECT、EXCEPT、WITH(CTE)

  • 子查询

  • QUALIFY、STREAM

  • 多语句(分号分隔);末尾分号

  • 非查询语句(INSERT/UPDATE/DELETE/MERGE)

  • CASE WHEN

  • 窗口函数

不支持 ORDER BY,结果顺序取决于对象内数据的物理顺序。

列引用

CSV

列引用方式由 FileHeaderInfo 决定:

FileHeaderInfo

首行处理

列引用方式

USE

首行作为列名,不作为数据返回

用表头名:column_name 或 s.column_name

IGNORE

首行丢弃,不作为列名

用位置列:_N 或 s._N

NONE(默认)

无表头

用位置列:_N 或 s._N

位置列从 1 开始:_1 表示第 1 列,_2 表示第 2 列,最大到 _999。

JSON

  • 仅支持首个对象的顶层字段名作为列:name、s.name。

  • 不支持嵌套对象/数组路径(如 s.projects[0].project_name);嵌套值在结果中为 NULL。

  • 后续行中新增、但首对象中不存在的字段不可查询;缺失字段取 NULL。

特殊列名

  • 列名含点号、空格、连字符等特殊字符时,使用反引号整体引用:

SELECT `t.name` FROM KS3Object
  • 列名是 SQL 保留字(如 CAST、SELECT)时,同样建议使用反引号整体引用。

  • 不建议用 s."列名" 形式引用特殊字符或保留字列名,可能报错;请使用反引号整体引用。

大小写敏感

写法

行为

裸列名(name、s.name)

大小写不敏感,name 可命中 Name、NAME

s."列名"(如 s."name")

大小写敏感,仅精确匹配

重要规则:

  1. 双引号限定列必须带表别名前缀;裸双引号 SELECT "name" 不是列引用,会解析失败。

  2. SQL 中只要出现一处合法的 s."列名",整条 SQL 的大小写匹配模式即切换为敏感(包括裸列名与表名)。

  3. 字符串字面量使用单引号 '...'。

  4. 表名默认大小写不敏感;进入敏感模式后必须写 KS3Object。

示例(文件字段为 Name):

SELECT s.name   FROM KS3Object s   -- 命中
SELECT s."Name" FROM KS3Object s   -- 命中
SELECT s."name" FROM KS3Object s   -- 不命中,SQLParsingError

数据类型与 CAST

  • 所有输入列均视为字符串类型,无论文件中看起来是数字、布尔还是日期。

  • 做数值比较、算术、聚合前请显式 CAST:

SELECT name FROM KS3Object WHERE CAST(age AS INTEGER) > 26
SELECT name, CAST(score AS DOUBLE) * 1.1 AS weighted FROM KS3Object
  • CAST 目标类型以 MySQL 兼容类型为准,建议使用 INTEGER、DOUBLE、DECIMAL、BOOLEAN、CHAR/VARCHAR 等常用类型。

  • 非数字内容参与数值 CAST、算术或比较返回400 SQLExecutionError;除零同理。

  • 输出始终为文本:即使 CAST(... AS INTEGER),JSON 输出也是字符串({"total":"3"}),不是数字。

支持的函数

函数名大小写不敏感。不支持聚合与非聚合列混用

类别

函数

聚合

COUNT、SUM、AVG、MAX、MIN

条件

COALESCE、NULLIF

转换

CAST

字符串

CHARACTER_LENGTH、CHAR_LENGTH、LOWER、UPPER、SUBSTRING、TRIM

说明:

  • 不在支持范围内的函数返回 SQLParsingError(Unsupported function: XXX)。

  • 聚合函数只能出现在 SELECT 列表;WHERE 中使用聚合返回 SQLParsingError。

  • 不支持 GROUP BY,聚合为全表聚合,结果为一行。

  • 聚合未加别名时,输出列名为自动生成的名称(通常为 EXPR$0),建议用 AS 指定别名。

运算符

类别

运算符

逻辑

AND、OR、NOT

比较

=、!=、<>、<、<=、>、>=

范围/集合

BETWEEN ... AND ...、IN (...)、NOT BETWEEN、NOT IN

模式匹配

LIKE、NOT LIKE(% 匹配任意字符,_ 匹配单字符)

算术

+、-、*、/、%,支持一元正负号

NULL/布尔判断

IS NULL、IS NOT NULL、IS TRUE、IS FALSE、IS NOT TRUE、IS NOT FALSE

LIKE 的 %/_ 与 IN 列表中的常量数量受 SQL 表达式 16KB 上限约束,不做额外数量限制。

LIMIT 与坏行

  • 坏行若位于 LIMIT 之外,查询可干净返回 n 行、HTTP 200。

  • 坏行在 LIMIT 范围内或无 LIMIT 时,返回 400 CSVParsingError / JSONParsingError。

  • JSON LINES坏行静默跳过,最大支持连续 1000 坏行,坏行如连续超过1000则提前结束请求

  • 无 LIMIT 的查询以整个对象为范围。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈