T-SQL 方言

运行时名称：T-SQL；CLI --dialect standard（默认），旧值 mssql 仍兼容；不需要插件。 先读 总览 了解方言隔离、事务模型和共享函数表。

1. 调用方式

dbsql --root /data sql mydb "SELECT TOP 5 id, name FROM users ORDER BY id"

T-SQL 是 CLI 的默认方言，可省略 --dialect。HTTP 侧 /api/sql、/api/select 的 "dialect" 留空或写 standard/mssql 都走这里。

2. 支持的语法

2.1 DDL

2.2 类型映射

解析器把 SQL Server 常见类型名归一成引擎类型（crates/dbsql-sql/src/parser.rs 的 map_std_type）：

引擎原生名（byte/bool/guid/string/int/long/datetime/dateonly/float/decimal/char/short/double/json/blob）也可直接写。

反直觉点：DDL 里的 FLOAT 落单精度；但 CONVERT(FLOAT, x) 落双精度（与 SQL Server 的 float(53) 对齐）。要单精度请用 REAL。

2.3 约束

• 列级：PRIMARY KEY、NOT NULL、NULL、UNIQUE、CHECK (表达式)、DEFAULT <字面量>。
• 表级：PRIMARY KEY (a, b)（复合）、UNIQUE (…)、CHECK (…)。
• 主键、UNIQUE、CHECK 都是真校验；复合主键冲突示例： 错误：主键 (a, b) 冲突：列 (a, b) 的值 ('1', '1') 与表中已存在的行重复
• CHECK 示例：错误：检查约束 (v > 0) 未通过：表达式 \v > 0` 为假`

2.4 查询

• SELECT：DISTINCT、表达式/别名、t.*、派生表、标量子查询、EXISTS / IN / BETWEEN / LIKE / IS NULL。
• JOIN：INNER / LEFT / RIGHT / FULL，ON 任意布尔表达式。CROSS JOIN 不支持。
• GROUP BY 列/序号/表达式；HAVING；ORDER BY 列/序号/表达式 + ASC/DESC + NULLS FIRST/NULLS LAST。
• 分页三种写法都可用：

SELECT TOP 2 id FROM t ORDER BY id;
SELECT id FROM t ORDER BY id OFFSET 0 ROWS FETCH NEXT 2 ROWS ONLY;
SELECT id FROM t ORDER BY id LIMIT 2 OFFSET 0;   -- 兼容写法

• 集合运算：UNION / UNION ALL / INTERSECT / EXCEPT。连续链式只能同一种运算符，混用报 连续集合运算只支持同一种运算符（UNION / UNION ALL / INTERSECT / EXCEPT）；不同运算符请用 CTE 分组。
• CTE：WITH x AS (…)，递归需 WITH r (n) AS (SELECT … UNION ALL SELECT … FROM r …)。
• 窗口：ROW_NUMBER() OVER (ORDER BY …) 可用；PARTITION BY 报 ROW_NUMBER 的 PARTITION BY 暂不支持。
• UPDATE … SET … FROM 表 WHERE … 可用（实测按 FROM 正确过滤）。
• INSERT … SELECT … 可用。

2.5 字面量与标识符

2.6 存储过程与流程控制

CREATE PROCEDURE pc ()
AS
BEGIN
    DECLARE @i INT;
    DECLARE cur CURSOR FOR SELECT id FROM src;
    OPEN cur;
    FETCH NEXT FROM cur INTO @i;
    CLOSE cur;
    DEALLOCATE cur;
    INSERT INTO t (id, v) VALUES (100, 'p');
END

• 过程名后必须带空参数括号：CREATE PROCEDURE p () AS …；调用同样带括号：CALL p()。
• 过程体支持：DECLARE、SET、SELECT @变量 = …、IF / ELSEIF / ELSE / END IF、WHILE / END、RETURN、游标（DECLARE CURSOR / OPEN / FETCH NEXT / CLOSE / DEALLOCATE）、EXEC '<动态 SQL>'、EXEC <过程>、INSERT … EXEC、PRINT（求值但不输出）。
• 会话级临时表 #t 可在过程体内使用。
• 顶层 EXEC p 不支持：错误：不支持的 SQL 语句类型：EXEC；顶层调用请用 CALL p()。

2.7 触发器

CREATE TRIGGER trg_bi BEFORE INSERT ON t
AS RAISE '不允许插入';

CREATE TRIGGER trg_ai AFTER INSERT ON t
AS INSERT INTO audit (v) VALUES (NEW.v);
-- 可跟多条语句：INSERT …; INSERT …;

DROP TRIGGER trg_ai;

• 语法固定为 CREATE TRIGGER <名> BEFORE|AFTER INSERT|UPDATE|DELETE ON <表> AS <语句>[; <语句>]。
• 伪行：NEW.col / OLD.col；RAISE '消息' 中断并回滚。
• 体语句只允许 INSERT / UPDATE / DELETE / RAISE，不接受 BEGIN … END。
• 触发器按语句触发；多语句体按顺序执行（实测一次插入写入了预期行数）。

2.8 SET 选项

只有下列选项会被接受；除 IDENTITY_INSERT 外都是校验后空操作：

SET NOCOUNT ON|OFF
SET ANSI_NULLS ON|OFF
SET ANSI_PADDING ON|OFF
SET ANSI_WARNINGS ON|OFF
SET ARITHABORT ON|OFF
SET CONCAT_NULL_YIELDS_NULL ON|OFF
SET NUMERIC_ROUNDABORT ON|OFF
SET IDENTITY_INSERT <表> ON|OFF      -- 空操作

SET QUOTED_IDENTIFIER 明确拒绝：

错误：SET QUOTED_IDENTIFIER 暂不支持：本引擎不能按会话切换双引号的解释口径。请删掉这一行，脚本里的字符串统一用单引号

2.9 自增列

CREATE TABLE idt (id INT IDENTITY PRIMARY KEY, v VARCHAR(5));
INSERT INTO idt (v) VALUES ('a');   -- id 自动为 1

隐式列清单会剔除自增列；显式给自增列赋值会因列数/顺序不匹配报错。

2.10 事务

BEGIN [TRANSACTION] / COMMIT / ROLLBACK 只允许平台管理员；事务是进程级单事务，CLI 每条命令一个进程，见 总览第 7 节。

3. 不支持的功能

4. 与 SQL Server 有差异的地方

5. 迁移建议

1. 把 ISNULL 换成 COALESCE；把 TOP n PERCENT 改成先算行数再 LIMIT。
2. 建表脚本里显式写出可空性：本引擎默认 NOT NULL，与 SQL Server 相反。
3. 依赖 CHAR(n) 定长语义的列，改用 VARCHAR 并在应用层补位/裁剪。
4. 长度/精度约束在应用层再校验一遍（VARCHAR(n)、DECIMAL(p,s) 中只有后者生效）。
5. 双引号标识符改成 [名字] 或裸名字；SET QUOTED_IDENTIFIER 整行删掉。
6. 触发器重写成 BEFORE|AFTER … AS <stmt> 形式，伪表改 NEW/OLD。
7. 顶层 EXEC p 改成 CALL p()；过程定义补空参数括号。
8. 去掉 dbo. 前缀与跨库引用。

6. 复现

cd /path/to/dbsql
./target/release/dbsql --root /tmp/dbsql-dialect-verify create database tdb
./target/release/dbsql --root /tmp/dbsql-dialect-verify sql tdb "CREATE TABLE t (id INT PRIMARY KEY, v VARCHAR(5))"
./target/release/dbsql --root /tmp/dbsql-dialect-verify sql tdb "INSERT INTO t (id) VALUES (1)"
# 错误：第 1 行的列 'v' 不允许为空（未提供值且无默认值）

完整清单：verify.sh。