数据库原理与选型 / 系统课时

使用 RETURNING 获取写入结果

使用 RETURNING 获取写入结果

本课解决“写入完成后怎样立即拿到主键和变更数据”这个问题。你将让 INSERT、UPDATE 和 DELETE 直接返回结果集,减少额外查询,并理解 RETURNING 的版本要求与事务边界。

学习目标

  • 使用 RETURNING 获取新增记录
  • 获取 UPDATE 和 DELETE 实际影响的数据
  • 理解返回结果与事务提交之间的区别

版本与示例表

SQLite 从 3.35.0 开始支持 RETURNING。先确认运行版本,再创建任务表。

sql
SELECT sqlite_version() AS version;

DROP TABLE IF EXISTS tasks;

CREATE TABLE tasks (
    id INTEGER PRIMARY KEY,
    title TEXT NOT NULL,
    status TEXT NOT NULL DEFAULT 'todo'
);

预期结果:版本号取决于本机环境。

text
version
<SQLITE_VERSION>

实际版本必须不低于 3.35.0,否则包含 RETURNING 的语句会产生语法错误。

INSERT RETURNING

新增记录时,可以只返回需要的列,也可以使用 RETURNING * 返回全部列。下面显式指定主键,保证示例结果确定。

sql
INSERT INTO tasks (id, title)
VALUES (101, '整理 SQLite 笔记')
RETURNING id, title, status;

预期结果:

text
id  | title             | status
101 | 整理 SQLite 笔记 | todo

应用程序可以直接读取这行结果,不必再执行 SELECT ... WHERE id = 101。

UPDATE RETURNING

UPDATE RETURNING 只返回实际匹配并更新的行。它适合同时完成状态变更和结果回传。

sql
UPDATE tasks
SET status = 'done'
WHERE id = 101
RETURNING id, title, status;

预期结果:

text
id  | title             | status
101 | 整理 SQLite 笔记 | done

如果 WHERE 没有匹配任何记录,语句不会返回数据行。调用方应把“空结果”视为未更新,而不是默认成功。

DELETE RETURNING

DELETE RETURNING 返回的是被删除行在删除前的内容,适合记录审计信息或把删除结果返回给调用方。

sql
DELETE FROM tasks
WHERE id = 101
RETURNING id, title, status;

预期结果:

text
id  | title             | status
101 | 整理 SQLite 笔记 | done

语句完成后,该记录已经从表中删除。再次查询应返回零行。

sql
SELECT COUNT(*) AS remaining_rows
FROM tasks
WHERE id = 101;

预期结果:

text
remaining_rows
0

RETURNING 与事务

RETURNING 提供的是写语句产生的结果集,但不等于事务已经提交。若后续执行 ROLLBACK,数据变化仍会撤销。

sql
BEGIN;

INSERT INTO tasks (id, title)
VALUES (102, '临时任务')
RETURNING id, title, status;

ROLLBACK;

SELECT COUNT(*) AS remaining_rows
FROM tasks
WHERE id = 102;

预期结果:

text
id  | title    | status
102 | 临时任务 | todo

remaining_rows
0

应用读取 RETURNING 结果后,仍要正确处理提交失败、回滚和连接异常,不能仅凭已收到结果就认定事务永久生效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 RETURNING 获取写入结果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通