Start a read transaction on an historical snapshot
int sqlite3_snapshot_open(
sqlite3 *db,
const char *zSchema,
sqlite3_snapshot *pSnapshot
);
重要提示:该界面是实验性的,如有更改,恕不另行通知。
sqlite3_snapshot_open(D,S,P) 接口为数据库连接D的模式S启动读取事务,以使读取事务引用历史快照P,而不是对数据库的最新更改。sqlite3_snapshot_open()接口在成功时返回SQLITE_OK,如果失败则返回相应的错误代码。
为了成功,对sqlite3_snapshot_open(D,S,P)的调用必须是BEGIN之后的第一个将模式S置于自动提交模式之外的操作。换句话说,模式S当前不能在sqlite3_snapshot_open(D,S,P)的事务中工作,但数据库连接D必须超出自动提交模式。如果快照被检查点覆盖,快照将无法打开。如果数据库连接D不知道模式S的数据库文件处于WAL模式,则对sqlite3_snapshot_open(D,S,P)的调用将失败。如果数据库连接上没有先前的I/O ,或者数据库连接上最近的I / O之后数据库进入了WAL模式,则数据库连接可能不知道数据库文件处于WAL模式。(提示: 对新打开的数据库连接运行 "PRAGMA application_id " 以使其可以使用快照。)
sqlite3_snapshot_open()接口仅在使用SQLITE_ENABLE_SNAPSHOT编译时选项时可用。
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com