记录数据库快照_SQlite中文网

Small. Fast. Reliable.
Choose any three.

SQLite C接口

int sqlite3_snapshot_get（
  sqlite3 * db，
  const char * zSchema，
  sqlite3_snapshot ** ppSnapshot
）;

该sqlite3_snapshot_get（d，S，P）接口尝试建立一个新sqlite3_snapshot对象，记录模式S的数据库连接D.如果成功了当前的状态， sqlite3_snapshot_get（d，S，P）接口写入指针到新创建的将sqlite3_snapshot对象转换为* P并返回SQLITE_OK。如果在调用此函数时在模式S上尚未打开读取事务，则会自动打开该事务。

要使此功能成功，必须满足以下条件。如果调用sqlite3_snapshot_get（）时以下任何语句为false，则返回SQLITE_ERROR。* P的最终值在这种情况下是不确定的。

数据库句柄不得处于自动提交模式。
数据库连接D的模式S必须是WAL模式数据库。
在数据库连接D的模式S上一定不能打开写事务。
自从它在磁盘上创建（通过任何连接）以来，必须已将一个或多个事务写入当前的wal文件。这意味着快照在第一次打开后就无法立即在没有wal文件的wal模式数据库上拍摄。首先必须至少写入一个事务。

此函数还可能返回SQLITE_NOMEM。如果使用数据库句柄在自动提交模式下调用它，但是由于其他原因而失败，则未定义是否在模式S上打开读取事务。

成功调用sqlite3_snapshot_get（）返回的sqlite3_snapshot对象必须使用sqlite3_snapshot_free（）释放，以避免内存泄漏。

所述sqlite3_snapshot_get（）的接口时仅可 SQLITE_ENABLE_SNAPSHOT用于编译时选择。