数据库原理与选型 / 系统课时
使用 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
0RETURNING 与事务
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 结果后,仍要正确处理提交失败、回滚和连接异常,不能仅凭已收到结果就认定事务永久生效。
按自己的节奏,确认真正理解。