SQLite 中使用 RETURNING 子句获取插入记录的 ID 和数据

13次阅读

SQLite 中使用 RETURNING 子句获取插入记录的 ID 和数据

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

sqlite 是轻量级嵌入式数据库,其语法严格遵循 SQLite 自身规范,不兼容 SQL Server、postgresql 或 SQL Server 的 OUTPUT INSERTED.* 语法。你遇到的 SQLITE_Error: near “OUTPUT”: syntax error 正是因为 SQLite 解析器完全不认识 OUTPUT 关键字。

✅ 正确做法:使用 RETURNING 子句(SQLite 3.35.0+)

RETURNING 是 SQLite 原生支持的标准扩展(官方文档),语法简洁且功能强大。以下是你原始代码的修正版本:

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 *;`, // ✅ 替换 OUTPUT 为 RETURNING   newValues,   function (err, rows) {     if (err) {       next(err);     } else {       // rows 是一个包含单个对象的数组(如 [{ id: 123, title: "...", ... }])       res.json({ message: "Saved", newRow: rows[0] });     }   } );

? 注意事项:

  • RETURNING * 返回整行;也可精确指定字段,例如 RETURNING id, title, creation_date,提升性能与可读性;
  • RETURNING 必须紧接在 VALUES(或 select)子句之后,不能加分号隔开
  • 确保你的 SQLite 版本 ≥ 3.35.0(可通过 SELECT sqlite_version(); 检查);node.js 中若使用 sqlite3 包,请确认底层绑定版本(推荐使用最新版 sqlite3@5.1.6+ 或考虑 better-sqlite3);
  • 若仅需主键 ID,可简化为 RETURNING id,避免传输冗余字段。

? 进阶优化:利用默认值减少重复逻辑
如 creation_date、publish_date、last_modified_date 均默认为当前时间,建议在建表时声明默认值,让 SQL 更简洁、健壮:

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;

这样不仅降低出错概率,也使业务逻辑更聚焦于核心字段。

? 小结:
不要尝试在 SQLite 中模拟 OUTPUT;拥抱 RETURNING —— 它是 SQLite 原生、标准、高效且被广泛验证的解决方案。升级驱动、更新语法、善用默认约束,即可安全、优雅地获取插入结果。

text=ZqhQzanResources