0

0

SQLite 中使用 RETURNING 子句获取插入行 ID 的完整指南

碧海醫心

碧海醫心

发布时间:2026-01-15 17:00:10

|

924人浏览过

|

来源于php中文网

原创

SQLite 中使用 RETURNING 子句获取插入行 ID 的完整指南

sqlite 不支持 sql server 风格的 `output` 子句,但自 3.35.0 版本起原生支持标准 sql 的 `returning` 子句,可直接在 `insert` 语句后返回新插入行的指定字段(包括自增主键),无需额外查询。

SQLite 是轻量级嵌入式数据库,其语法与 PostgreSQL、SQL Server 等有明显差异。你遇到的 SQLITE_ERROR: near "OUTPUT": syntax error 错误,根本原因是 OUTPUT 是 SQL Server/T-SQL 特有语法,SQLite 完全不识别。正确替代方案是使用 SQLite 原生支持的 RETURNING 子句(自 SQLite 3.35.0 起正式引入)。

✅ 正确用法:RETURNING 替代 OUTPUT

将原代码中错误的 OUTPUT INSERTED.* 删除,并在 VALUES 后添加 RETURNING *:

INSERT INTO articles(
  creation_date, publish_date, last_modified_date,
  title, subtitle, article_text, likes, author_id, published
)
VALUES (
  CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP,
  ?, ?, ?, ?, ?, ?
)
RETURNING *;

对应 Node.js(如使用 sqlite3 模块)调用示例:

global.db.all(
  `INSERT INTO articles(
     creation_date, publish_date, last_modified_date,
     title, subtitle, article_text, likes, author_id, published
   )
   VALUES (CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, ?, ?, ?, ?, ?, ?)
   RETURNING rowid, id, title, created_at;`,
  newValues,
  function (err, rows) {
    if (err) {
      return next(err);
    }
    // rows 是一个包含返回字段的对象数组(即使只插一行,也是 [{...}])
    res.json({ message: "Saved", newRow: rows[0] });
  }
);
? 注意:RETURNING 返回的是一个数组(即使仅插入单行),因此取结果需用 rows[0]。若只需主键(假设表有 INTEGER PRIMARY KEY 列,即 rowid 别名),可明确写 RETURNING rowid 或 RETURNING id,提升性能和可读性。

?️ 进阶优化:简化时间戳字段

若 creation_date、publish_date、last_modified_date 始终为当前时间,推荐在建表时设置默认值,避免每次 INSERT 重复写 CURRENT_TIMESTAMP:

Open Voice OS
Open Voice OS

OpenVoiceOS是一个社区驱动的开源语音AI平台

下载
CREATE TABLE articles (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  title TEXT NOT NULL,
  subtitle TEXT,
  article_text TEXT,
  likes INTEGER DEFAULT 0,
  author_id INTEGER,
  published BOOLEAN DEFAULT 0,
  creation_date TEXT DEFAULT CURRENT_TIMESTAMP,
  publish_date TEXT DEFAULT CURRENT_TIMESTAMP,
  last_modified_date TEXT DEFAULT CURRENT_TIMESTAMP
);

此时插入语句可大幅精简:

INSERT INTO articles(title, subtitle, article_text, likes, author_id, published)
VALUES (?, ?, ?, ?, ?, ?)
RETURNING id, title, creation_date;

⚠️ 注意事项

  • ✅ RETURNING 仅适用于 SQLite ≥ 3.35.0(2021 年 3 月发布)。请运行 SELECT sqlite_version(); 确认版本。
  • ❌ 不支持 INSERT ... SELECT ... RETURNING 中的 RETURNING(SQLite 当前限制),仅支持 INSERT ... VALUES ... RETURNING。
  • ? RETURNING 后可指定具体列(如 RETURNING id, title),比 RETURNING * 更高效、更安全。
  • ? 若需兼容旧版 SQLite(同一事务中执行以避免竞态。

✅ 总结

方案 是否推荐 说明
OUTPUT INSERTED.* ❌ 不可用 SQLite 语法错误,完全不支持
RETURNING * ✅ 推荐(新版) 简洁、原子、符合 SQL 标准,首选方案
last_insert_rowid() ⚠️ 备选(旧版兼容) 需手动查 ID,非原子操作,注意事务隔离

拥抱 RETURNING,告别冗余查询——这是现代 SQLite 应用提升健壮性与可维护性的关键一步。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

678

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

320

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

346

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1095

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

357

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

675

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

572

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

414

2024.04.29

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

6

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号