RETURNING子句必须配合INTO或BULK COLLECT使用,不能单独返回结果集;它不自动输出到客户端,仅将值赋给PL/SQL变量,且要求类型严格匹配、字段可读、仅限基表普通列。

RETURNING子句必须配合INTO或BULK COLLECT使用,不能单独返回结果集
Oracle没有真正的“自增主键”,通常用SEQUENCE + TRIGGER或IDENTITY列模拟。但无论哪种方式,RETURNING子句本身**不会自动输出到客户端**,它只是把值“抓”出来交给PL/SQL变量——所以你执行一条带RETURNING的INSERT语句(比如在SQL*Plus或JDBC中直接跑),如果没接INTO,就什么也看不到,还可能报错:ORA-00933: SQL command not properly ended。
常见错误写法:INSERT INTO users(name) VALUES ('Alice') RETURNING id;
这行不通。必须绑定接收目标:
- 在PL/SQL块里用
INTO接收单行(最常用) - 批量插入时用
BULK COLLECT INTO接收多行 - 在支持的驱动里(如Oracle JDBC 12.2+),可用
getGeneratedKeys()间接利用RETURNING,但底层仍是驱动帮你做了INTO封装
用INTO获取单条插入的主键值,注意数据类型必须严格匹配
如果表主键是NUMBER,你就得用NUMBER型PL/SQL变量接;如果是INTEGER或PLS_INTEGER,也可能因隐式转换失败而报ORA-06502。别图省事全用VARCHAR2——RETURNING不干类型转换的事,它只原样赋值。
正确示例:
DECLARE
v_new_id NUMBER;
BEGIN
INSERT INTO users(name) VALUES ('Bob')
RETURNING id INTO v_new_id;
DBMS_OUTPUT.PUT_LINE('New ID: ' || v_new_id);
END;
-
id字段必须可读(非INVISIBLE,且用户有SELECT权限) - 如果
INSERT触发了BEFORE ROW触发器修改了id,RETURNING拿到的是触发器改完后的值 - 不能对视图或含复杂表达式的列用
RETURNING,只能针对基表的普通列
IDENTITY列和SEQUENCE+TRIGGER下RETURNING行为一致,但初始化逻辑不同
Oracle 12c起支持GENERATED ALWAYS AS IDENTITY,看起来像MySQL的AUTO_INCREMENT,但它底层仍是基于SEQUENCE。关键点:无论你用IDENTITY还是手建SEQUENCE+TRIGGER,RETURNING子句的行为完全一样——它取的是最终插入到表里的那个值,跟生成逻辑无关。
所以这两条语句效果等价(假设users.id是IDENTITY列):
INSERT INTO users(name) VALUES ('Charlie') RETURNING id INTO v_new_id;
INSERT INTO users(id, name) VALUES (users_seq.NEXTVAL, 'Charlie') RETURNING id INTO v_new_id;
- 用
IDENTITY时,显式插入id值会报ORA-32795(除非用GENERATED BY DEFAULT ON NULL) - 但
RETURNING不关心你是怎么生成的,只认最终落库的值 - 如果事务回滚,
SEQUENCE已跳号,RETURNING拿到的ID也不会“退还”
JDBC中调用RETURNING需启用RETURN_GENERATED_KEYS,且驱动版本不能太低
Java里想用RETURNING拿主键,不能只靠Statement.RETURN_GENERATED_KEYS常量——那只是告诉驱动“我要取生成的键”,真正生效还得看驱动是否把RETURNING编译进底层SQL。Oracle JDBC 12.1之前版本根本不支持这个特性,12.2+才正式支持RETURNING与getGeneratedKeys()联动。
典型代码片段:
String sql = "INSERT INTO users(name) VALUES (?) RETURNING id";
PreparedStatement ps = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS);
ps.setString(1, "David");
ps.executeUpdate();
ResultSet rs = ps.getGeneratedKeys(); // 这里才真正触发RETURNING执行
if (rs.next()) {
long id = rs.getLong(1);
}
- 必须用
PreparedStatement,不能用Statement拼字符串(否则RETURNING会被当语法错误) - Oracle驱动会把
RETURNING重写为匿名PL/SQL块再执行,所以getGeneratedKeys()实际开销略高于普通插入 - 如果表有多个主键列,
RETURNING可以写多个字段,但getGeneratedKeys()默认只返回第一列——要全取就得手动查ResultSetMetaData
RETURNING不是“查询语法糖”,它是PL/SQL级的数据搬运指令。漏掉INTO、类型不匹配、驱动版本过低——这三个点卡住的人最多。真要稳定取ID,不如先确认你的环境到底走的是IDENTITY还是SEQUENCE,再决定是写PL/SQL块还是信JDBC封装。


















