SQLite之rowid与sqlite3_last_insert_rowid()

最新推荐文章于 2024-04-05 21:07:36 发布

原创最新推荐文章于 2024-04-05 21:07:36 发布 · 1.3w 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#SQLite #rowid #sqlite3_last_insert_

SQLite那点事专栏收录该内容

2 篇文章

订阅专栏

本文详细介绍了SQLite数据库中的rowid字段特性，包括其自动递增、隐藏性及使用方式，以及如何通过SQL获取rowid值。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SQLite数据库中的表均有一个特殊的rowid字段，它是一个不重复的64位有符号整数，默认起始值为1。rowid别名为oid或_rowid_，但在创建表的SQL声明语句中只能使用rowid作为关键字。如果在创建表的时候设置了类型为integer的具有自动增长性的主键，那么这时的主键相当于是rowid的别名。

rowid只能是单调递增的，它由SQLite内部维护，不能自己指定。对于失败的插入操作，rowid也可能在原来的基础上执行了自增。删除或回滚操作并不会减小rowid的值。当rowid达到所能表示的最大值时，这时如果有新纪录要插入，系统就会从之前没有被使用过的（或从已经被删除的记录的)rowid中随机取出一个作为rowid。若没有可用的rowid，系统就会抛出SQLITE_FULL的错误。

rowid字段在表中默认是隐藏的，也就是说，除非SQL查询语句中指定返回rowid，否则查询结果不会包含有rowid字段。

可以在创建表时使用WITHOUT ROWID以声明不生成rowid字段，例如：

CREATE TABLE IF NOT EXISTS wordcount(

word TEXT PRIMARY KEY，

cnt INTEGER

) WITHOUT ROWID;

将关键字AUTOINCREMENT使用在声明为WITHOUT ROWID的表不但不起作用，还将引发一个错误。

SQLiteAPI 函数sqlite3_last_insert_rowid()可以取得最后一条插入的记录的rowid。但sqlite3_last_insert_rowid()是基于当前进程的。也就是说，sqlite3_last_insert_rowid()取到的是当前进程最后一次插入记录的rowid。对于不是当前进程插入的记录，sqlite3_last_insert_rowi()均返回0。sqlite3_last_insert_rowi()对应的SQL声明为last_insert_rowid()，例如：

select last_insert_rowid() from exam_tbl