PL/SQL 方言

运行时名称：PL/SQL；CLI --dialect procedural（旧值 oracle 仍兼容）；需要 libdbsql_oracle_plugin.so。 先读 总览 了解方言隔离、事务模型和共享函数表。

1. 调用方式

cd /path/to/dbsql
./target/release/dbsql --root /data --dialect procedural sql mydb "SELECT 1 FROM DUAL"

插件按 plugins/libdbsql_oracle_plugin.so → plugins/dbsql_oracle_plugin.so → 当前目录 的顺序探测；也可以用 --plugin <路径>（必须写在子命令前）。

2. 支持的语法

2.1 查询

• SELECT … FROM DUAL 与不带 FROM 的 SELECT 都可执行：SELECT 1 AS x 返回 1。
• || 字符串拼接：SELECT 'a' || 'b' FROM DUAL → ab。
• 分页：既支持通用写法，也支持 Oracle 写法：

SELECT id FROM t ORDER BY id LIMIT 2 OFFSET 0;
SELECT id FROM t ORDER BY id FETCH FIRST 2 ROWS ONLY;
SELECT id FROM t ORDER BY id OFFSET 0 ROWS FETCH NEXT 2 ROWS ONLY;

注意：FETCH NEXT 必须跟在 OFFSET 后面；单独写 FETCH NEXT 2 ROWS ONLY 报 期望关键字 'FIRST'，实际遇到 'NEXT'，此时用 FETCH FIRST。

• 集合运算：UNION / UNION ALL / INTERSECT，以及 Oracle 的 MINUS（解析成集合差，实测可用）。
• EXCEPT 关键字不识别：SELECT … EXCEPT SELECT … 报 只支持单条语句；语句结束后仍有多余内容：'SELECT'（位于 25）；用 MINUS 代替。
• 非递归 CTE：WITH x AS (SELECT …) SELECT … FROM x 可用。
• JOIN / GROUP BY / HAVING / ORDER BY 序号 / DISTINCT 与另两方言一致。
• NULLS FIRST / NULLS LAST 可写。

2.2 DDL

不支持的对象：CREATE INDEX / TRIGGER / SEQUENCE / SYNONYM / PACKAGE（报 CREATE 后不支持的对象类型）；TRUNCATE 也不是合法语句。

2.3 类型映射

map_oracle_type（crates/dbsql-sql-oracle/src/parser.rs）：

2.4 约束

• 单列主键：id INT PRIMARY KEY 可直接建。
• 复合主键：每个主键列必须显式 NOT NULL，否则报 列 'a' 声明为 NULL，不能做复合主键的一部分；请改成 NOT NULL。
• UNIQUE、CHECK 真校验；DEFAULT 只接受字面量。
• 普通列默认可空（不写 NOT NULL 时，省略值可插入）。
• 外键不支持，报错见 总览第 5 节。

2.5 写入

INSERT INTO t (id, nm) VALUES (1, 'a');          -- 字面量
INSERT INTO t (id, nm) VALUES (1+3, 'c');        -- 算术表达式可用
INSERT INTO t (id, nm) VALUES (2, NULL);         -- NULL 可用
INSERT INTO t (id, nm) VALUES (20, 'x'), (21, 'y');  -- 多行可用
UPDATE t SET nm = 'z' WHERE id = 1;              -- 右侧只写值
DELETE FROM t WHERE id = 1;

• UPDATE 的 SET 右侧必须是字面量：SET nm = nm 报 期望字面量，实际遇到 'nm'；WHERE 里可以用子查询（WHERE id IN (SELECT …) 实测可用）。
• INSERT … VALUES 不接受函数调用：VALUES (2, UPPER('a')) 报 期望字面量，实际遇到 'UPPER'。
• INSERT … SELECT 不支持：期望关键字 'VALUES'，实际遇到 'SELECT'。

2.6 匿名块与存储过程

-- 匿名块：可执行
BEGIN NULL; END;

-- 带声明
DECLARE
    n INT;
BEGIN
    n := 1;
END;

-- 存储过程
CREATE OR REPLACE PROCEDURE pz ()
AS
BEGIN
    INSERT INTO pt (id, nm) VALUES (10, 'p');
END;

CALL pz();

• 过程名后带空参数括号；用 CALL p() 调用。
• 过程体内的字符串字面量正常工作（实测插入 'ok' 成功）。
• EXCEPTION 块不支持：无法识别的 PL/SQL 语句：EXCEPTION WHEN OTHERS THEN NULL。
• 一次只能提交一条顶层语句；多条会报 只支持单条语句；语句结束后仍有多余内容：'SELECT'。

2.7 字面量

2.8 事务

COMMIT / ROLLBACK 只能在活动事务内执行；CLI 单独执行报 错误：没有活动事务。事务模型见 总览第 7 节。

3. 不支持的功能

4. 与 Oracle 有差异的地方

5. 迁移建议

1. 所有 ROWNUM 分页改 LIMIT / FETCH FIRST；ROWNUM = 1 改 LIMIT 1。
2. 把 '' 当 NULL 的判断改成显式 NULL（本引擎里两者不同）。
3. INSERT … SELECT 拆成逐行 VALUES（或走导入工具）；INSERT/UPDATE 里的函数先算好。
4. DECODE 改 CASE；TO_DATE 改直接写 'YYYY-MM-DD' 字符串。
5. NUMBER(p,s) / VARCHAR2(n) 的精度与长度在应用层补校验。
6. 复合主键列逐个补 NOT NULL。
7. 触发器、索引、序列、包不在本方言落地；需要触发器时改用 T-SQL 方言建（但语法不同，见 tsql.md）。
8. EXCEPTION 块删除或改到调用方处理。
9. 匿名块可以保留，但不要依赖一次提交整个脚本。

6. 复现

cd /path/to/dbsql
./target/release/dbsql --root /tmp/dbsql-dialect-verify create database pdb
./target/release/dbsql --root /tmp/dbsql-dialect-verify --dialect procedural sql pdb \
  "SELECT q'[it''s]' AS s FROM DUAL"
# s = it''s

./target/release/dbsql --root /tmp/dbsql-dialect-verify --dialect procedural sql pdb \
  "SELECT ROWNUM, id FROM pt"
# 错误：SELECT 列 'ROWNUM' 不存在

完整清单：verify.sh。