OpenMLDB SQL 与标准 SQL 的主要差异

本文将 OpenMLDB SQL 的主要使用方式（SELECT 查询语句）与标准 SQL （以 MySQL 支持的语法为例）进行比较，让有 SQL 使用经验的开发者快速上手 OpenMLDB SQL。​

面向 OpenMLDB 版本：>= v0.7.1

支持总览

下表根据 SELECT 语句元素对 OpenMLDB SQL 在三种执行模式下（关于执行模式参考使用流程和执行模式 — OpenMLDB documentation）与标准 SQL 整体性的差异做了汇总。OpenMLDB SQL 目前部分兼容标准 SQL，考虑实际业务场景需求还新增了部分语法，下表加粗部分为新增语法。

注：✓ 表示支持该语句，✕ 表示不支持。

	OpenMLDB SQL 离线模式	OpenMLDB SQL 在线预览模式	OpenMLDB SQL 在线请求模式	标准 SQL	备注
WHERE 子句	✓	✓	✕	✓
HAVING 子句	✓	✓	X	✓
JOIN 子句	✓	✕	✓	✓	OpenMLDB 仅支持特有的 LAST JOIN
GROUP BY 分组	✓	✕	✕	✓
ORDER BY 排序	✕	✕	✕	✓
LIMIT 限制行数	✓	✓	✕	✓
WINDOW 子句	✓	✓	✓	✓	OpenMLDB 增加了特有的 WINDOW ... UNION 和 WINDOW ATTRIBUTES 语法
WITH 子句	✕	✕	✕	✓	OpenMLDB 将会在版本 v0.8.0开始支持
聚合函数	✓	✓	✓	✓	OpenMLDB 有较多扩展函数

差异详解

差异维度

与标准 SQL 比较，OpenMLDB SQL 的差异性主要会从三个维度进行说明：​

1.
执行模式：在三种不同执行模式下（离线模式，在线预览模式，在线请求模式），不同的 SQL 的支持程度不一样，需要分开考察。普遍的，为了最终可以让 SQL 实现实时计算，最终需要上线的业务 SQL 需要符合在线请求模式的要求。​

2.
子句组合：不同子句的组合会带来额外的限制，下文描述形式 A 应用于 B，表示 A 子句在 B 子句的结果上运行。比如 LIMIT 应用于 WHERE，则其 SQL 类似为：SELECT * FROM (SELECT * FROM t1 WHERE id >= 2) LIMIT 2 。​
a.
下文中的“表引用”是指FROM TableRef，不是 subquery 也不是带有 join/union的复杂FROM子句。​

3.
特殊限制：不归于以上两类的特殊限制，会进行单独说明，一般是由于功能支持不完善或者程序已知问题所引起。​

扫描限制的配置

为了避免用户误操作而影响到在线性能，OpenMLDB 有相关参数来限制在离线模式和在线预览模式下的全表扫描次数。如果打开了这些参数的限制，将会导致部分涉及到多个记录扫描的操作（比如 SELECT *, 聚合操作等）可能出现结果截断，而最终产生错误结果。注意，这些参数不会影响到在线请求模式的结果正确性。​

相关参数会在 tablet 配置文件 conf/tablet.flags 里进行配置，详见文档配置文件 — OpenMLDB documentation 。影响到扫描限制的参数为：

•
最大扫描条数 --max_traverse_cnt​

•
最大扫描 key 的个数 --max_traverse_pk_cnt​

•
返回的结果大小限制 --scan_max_bytes_size​

预计在 v0.7.3 以及以后版本中，以上参数的默认值都为 0，即不做相关限制。之前的版本需要注意相关参数的设置。​

WHERE 子句

WHERE 应用于	离线模式	在线预览模式	在线请求模式
表引用	✓	✓	✕
LAST JOIN	✓	✓	✕
子查询 / WITH 子句	✓	✓	✕

LIMIT 子句

后面跟一个 INT literal, 不支持其它表达式，表示返回数据的最大行数。LIMIT 不支持上线。​

应用于	离线模式	在线预览模式	在线请求模式
表引用	✓	✓	✕

OpenMLDB SQL 与标准 SQL 的主要差异​

OpenMLDB SQL 与标准 SQL 的主要差异