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
Oracle的RETURNING不是“查询语法糖”，它是PL/SQL级的数据搬运指令。漏掉INTO、类型不匹配、驱动版本过低——这三个点卡住的人最多。真要稳定取ID，不如先确认你的环境到底走的是IDENTITY还是SEQUENCE，再决定是写PL/SQL块还是信JDBC封装。
