最近更新时间:2026-11-18 17:42:29
SelectObject 支持一条标准 SELECT 语句,从虚拟表 KS3Object 查询数据,语法为 MySQL 兼容方言。
语句/子句 | 说明 |
| 投影:列、 |
| 固定 |
| 行过滤;支持比较、逻辑、模式匹配、集合、范围、NULL/布尔判断;不支持聚合 |
|
|
以下均返回 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,结果顺序取决于对象内数据的物理顺序。
列引用方式由 FileHeaderInfo 决定:
| 首行处理 | 列引用方式 |
| 首行作为列名,不作为数据返回 | 用表头名: |
| 首行丢弃,不作为列名 | 用位置列: |
| 无表头 | 用位置列: |
位置列从 1 开始:_1 表示第 1 列,_2 表示第 2 列,最大到 _999。
仅支持首个对象的顶层字段名作为列:name、s.name。
不支持嵌套对象/数组路径(如 s.projects[0].project_name);嵌套值在结果中为 NULL。
后续行中新增、但首对象中不存在的字段不可查询;缺失字段取 NULL。
列名含点号、空格、连字符等特殊字符时,使用反引号整体引用:
SELECT `t.name` FROM KS3Object列名是 SQL 保留字(如 CAST、SELECT)时,同样建议使用反引号整体引用。
不建议用 s."列名" 形式引用特殊字符或保留字列名,可能报错;请使用反引号整体引用。
写法 | 行为 |
裸列名( | 大小写不敏感, |
| 大小写敏感,仅精确匹配 |
重要规则:
双引号限定列必须带表别名前缀;裸双引号 SELECT "name" 不是列引用,会解析失败。
SQL 中只要出现一处合法的 s."列名",整条 SQL 的大小写匹配模式即切换为敏感(包括裸列名与表名)。
字符串字面量使用单引号 '...'。
表名默认大小写不敏感;进入敏感模式后必须写 KS3Object。
示例(文件字段为 Name):
SELECT s.name FROM KS3Object s -- 命中
SELECT s."Name" FROM KS3Object s -- 命中
SELECT s."name" FROM KS3Object s -- 不命中,SQLParsingError所有输入列均视为字符串类型,无论文件中看起来是数字、布尔还是日期。
做数值比较、算术、聚合前请显式 CAST:
SELECT name FROM KS3Object WHERE CAST(age AS INTEGER) > 26
SELECT name, CAST(score AS DOUBLE) * 1.1 AS weighted FROM KS3ObjectCAST 目标类型以 MySQL 兼容类型为准,建议使用 INTEGER、DOUBLE、DECIMAL、BOOLEAN、CHAR/VARCHAR 等常用类型。
非数字内容参与数值 CAST、算术或比较返回400 SQLExecutionError;除零同理。
输出始终为文本:即使 CAST(... AS INTEGER),JSON 输出也是字符串({"total":"3"}),不是数字。
函数名大小写不敏感。不支持聚合与非聚合列混用
类别 | 函数 |
聚合 |
|
条件 |
|
转换 |
|
字符串 |
|
说明:
不在支持范围内的函数返回 SQLParsingError(Unsupported function: XXX)。
聚合函数只能出现在 SELECT 列表;WHERE 中使用聚合返回 SQLParsingError。
不支持 GROUP BY,聚合为全表聚合,结果为一行。
聚合未加别名时,输出列名为自动生成的名称(通常为 EXPR$0),建议用 AS 指定别名。
类别 | 运算符 |
逻辑 |
|
比较 |
|
范围/集合 |
|
模式匹配 |
|
算术 |
|
NULL/布尔判断 |
|
LIKE 的 %/_ 与 IN 列表中的常量数量受 SQL 表达式 16KB 上限约束,不做额外数量限制。
坏行若位于 LIMIT 之外,查询可干净返回 n 行、HTTP 200。
坏行在 LIMIT 范围内或无 LIMIT 时,返回 400 CSVParsingError / JSONParsingError。
JSON LINES坏行静默跳过,最大支持连续 1000 坏行,坏行如连续超过1000则提前结束请求
无 LIMIT 的查询以整个对象为范围。
纯净模式
