SQLite教程（九）：在線備份
一、常用備份：
下面的方法是比較簡單且常用的SQLite數(shù)據(jù)庫備份方式，見如下步驟：
1). 使用SQLite API或Shell工具在源數(shù)據(jù)庫文件上加共享鎖。
2). 使用Shell工具(cp或copy)拷貝數(shù)據(jù)庫文件到備份目錄。
3). 解除數(shù)據(jù)庫文件上的共享鎖。
以上3個(gè)步驟可以應(yīng)用于大多數(shù)場景，而且速度也比較快，然而卻存在一定的剛性缺陷，如：
1). 所有打算在源數(shù)據(jù)庫上執(zhí)行寫操作的連接都不得不被掛起，直到整個(gè)拷貝過程結(jié)束并釋放文件共享鎖。
2). 不能拷貝數(shù)據(jù)到in-memory數(shù)據(jù)庫。
3). 在拷貝過程中，一旦備份數(shù)據(jù)庫所在的主機(jī)出現(xiàn)任何突發(fā)故障，備份數(shù)據(jù)庫可能會(huì)被破壞。
在SQLite中提供了一組用于在線數(shù)據(jù)庫備份的APIs函數(shù)(C接口)，可以很好的解決上述方法存在的不足。通過該組函數(shù)，可以將源數(shù)據(jù)庫中的內(nèi)容拷貝到另一個(gè)數(shù)據(jù)庫，同時(shí)覆蓋目標(biāo)數(shù)據(jù)庫中的數(shù)據(jù)。整個(gè)拷貝過程可以以增量的方式完成，在此情況下，源數(shù)據(jù)庫也不需要在整個(gè)拷貝過程中都被加鎖，而只是在真正讀取數(shù)據(jù)時(shí)加共享鎖。這樣，其它的用戶在訪問源數(shù)據(jù)庫時(shí)就不會(huì)被掛起。
二、在線備份APIs簡介：
SQLite提供了以下3個(gè)APIs函數(shù)用于完成此操作，這里僅僅給出它們的基本用法，至于使用細(xì)節(jié)可以參考SQLite官方網(wǎng)站"APIs Reference"(http://www.sqlite.org/c3ref/backup_finish.html)。
1). 函數(shù)sqlite3_backup_init()用于創(chuàng)建sqlite3_backup對象，該對象將作為本次拷貝操作的句柄傳給其余兩個(gè)函數(shù)。
2). 函數(shù)sqlite3_backup_step()用于數(shù)據(jù)拷貝，如果該函數(shù)的第二個(gè)參數(shù)為-1，那么整個(gè)拷貝過程都將在該函數(shù)的一次調(diào)用中完成。
3). 函數(shù)sqlite3_backup_finish()用于釋放sqlite3_backup_init()函數(shù)申請的資源，以避免資源泄露。
在整個(gè)拷貝過程中如果出現(xiàn)任何錯(cuò)誤，我們都可以通過調(diào)用目的數(shù)據(jù)庫連接的sqlite3_errcode()函數(shù)來獲取具體的錯(cuò)誤碼。此外，如果sqlite3_backup_step()調(diào)用失敗，由于sqlite3_backup_finish()函數(shù)并不會(huì)修改當(dāng)前連接的錯(cuò)誤碼，因此我們可以在調(diào)用sqlite3_backup_finish()之后再獲取錯(cuò)誤碼，從而在代碼中減少了一次錯(cuò)誤處理。見如下代碼示例(來自SQLite官網(wǎng))：
/*
** This function is used to load the contents of a database file on disk
** into the "main" database of open database connection pInMemory, or
** to save the current contents of the database opened by pInMemory into
** a database file on disk. pInMemory is probably an in-memory database,
** but this function will also work fine if it is not.
**
** Parameter zFilename points to a nul-terminated string containing the
** name of the database file on disk to load from or save to. If parameter
** isSave is non-zero, then the contents of the file zFilename are
** overwritten with the contents of the database opened by pInMemory. If
** parameter isSave is zero, then the contents of the database opened by
** pInMemory are replaced by data loaded from the file zFilename.
**
** If the operation is successful, SQLITE_OK is returned. Otherwise, if
** an error occurs, an SQLite error code is returned.
*/
int loadOrSaveDb(sqlite3 *pInMemory, const char *zFilename, int isSave){
int rc; /* Function return code */
sqlite3 *pFile; /* Database connection opened on zFilename */
sqlite3_backup *pBackup; /* Backup object used to copy data */
sqlite3 *pTo; /* Database to copy to (pFile or pInMemory) */
sqlite3 *pFrom; /* Database to copy from (pFile or pInMemory) */
/* Open the database file identified by zFilename. Exit early if this fails
** for any reason. */
rc = sqlite3_open(zFilename, &pFile);
if( rc==SQLITE_OK ){
/* If this is a 'load' operation (isSave==0), then data is copied
** from the database file just opened to database pInMemory.
** Otherwise, if this is a 'save' operation (isSave==1), then data
** is copied from pInMemory to pFile. Set the variables pFrom and
** pTo accordingly. */
pFrom = (isSave ? pInMemory : pFile);
pTo = (isSave ? pFile : pInMemory);
/* Set up the backup procedure to copy from the "main" database of
** connection pFile to the main database of connection pInMemory.
** If something goes wrong, pBackup will be set to NULL and an error
** code and message left in connection pTo.
**
** If the backup object is successfully created, call backup_step()
** to copy data from pFile to pInMemory. Then call backup_finish()
** to release resources associated with the pBackup object. If an
** error occurred, then an error code and message will be left in
** connection pTo. If no error occurred, then the error code belonging
** to pTo is set to SQLITE_OK.
*/
pBackup = sqlite3_backup_init(pTo, "main", pFrom, "main");
if( pBackup ){
(void)sqlite3_backup_step(pBackup, -1);
(void)sqlite3_backup_finish(pBackup);
}
rc = sqlite3_errcode(pTo);
}
/* Close the database connection opened on database file zFilename
** and return the result of this function. */
(void)sqlite3_close(pFile);
return rc;
}
三、高級應(yīng)用技巧：
在上面的例子中，我們是通過sqlite3_backup_step()函數(shù)的一次調(diào)用完成了整個(gè)拷貝過程。該實(shí)現(xiàn)方式仍然存在之前說過的掛起其它寫訪問連接的問題，為了解決該問題，這里我們將繼續(xù)介紹另外一種更高級的實(shí)現(xiàn)方式--分片拷貝，其實(shí)現(xiàn)步驟如下：
1). 函數(shù)sqlite3_backup_init()用于創(chuàng)建sqlite3_backup對象，該對象將作為本次拷貝操作的句柄傳給其余兩個(gè)函數(shù)。
2). 函數(shù)sqlite3_backup_step()被調(diào)用用于拷貝數(shù)據(jù)，和之前方法不同的是，該函數(shù)的第二個(gè)參數(shù)不再是-1，而是一個(gè)普通的正整數(shù)，表示每次調(diào)用將會(huì)拷貝的頁面數(shù)量，如5。
3). 如果在函數(shù)sqlite3_backup_step()調(diào)用結(jié)束后，仍然有更多的頁面需要被拷貝，那么我們將主動(dòng)休眠250ms，然后再重復(fù)步驟2).
4). 函數(shù)sqlite3_backup_finish()用于釋放sqlite3_backup_init()函數(shù)申請的資源，以避免資源泄露。
在上述步驟3)中我們主動(dòng)休眠250ms，此期間，該拷貝操作不會(huì)在源數(shù)據(jù)庫上持有任何讀鎖，這樣其它的數(shù)據(jù)庫連接在進(jìn)行寫操作時(shí)亦將不會(huì)被掛起。然而在休眠期間，如果另外一個(gè)線程或進(jìn)程對源數(shù)據(jù)庫進(jìn)行了寫操作，SQLite將會(huì)檢測到該事件的發(fā)生，從而在下一次調(diào)用sqlite3_backup_step()函數(shù)時(shí)重新開始整個(gè)拷貝過程。唯一的例外是，如果源數(shù)據(jù)庫不是in-memory數(shù)據(jù)庫，同時(shí)寫操作是在與拷貝操作同一個(gè)進(jìn)程內(nèi)完成，并且在操作時(shí)使用的也是同一個(gè)數(shù)據(jù)庫連接句柄，那么目的數(shù)據(jù)庫中數(shù)據(jù)也將被此操作同時(shí)自動(dòng)修改。在下一次調(diào)用sqlite3_backup_step()時(shí)，也將不會(huì)有任何影響發(fā)生?！ ?br />
事實(shí)上，在SQLite中仍然提供了另外兩個(gè)輔助性函數(shù)backup_remaining()和backup_pagecount()，其中前者將返回在當(dāng)前備份操作中還有多少頁面需要被拷貝，而后者將返回本次操作總共需要拷貝的頁面數(shù)量。顯而易見的是，通過這兩個(gè)函數(shù)的返回結(jié)果，我們可以實(shí)時(shí)顯示本次備份操作的整體進(jìn)度，計(jì)算公式如下：
Completion = 100% * (pagecount() - remaining()) / pagecount()
見以下代碼示例(來自SQLite官網(wǎng))：
/*
** Perform an online backup of database pDb to the database file named
** by zFilename. This function copies 5 database pages from pDb to
** zFilename, then unlocks pDb and sleeps for 250 ms, then repeats the
** process until the entire database is backed up.
**
** The third argument passed to this function must be a pointer to a progress
** function. After each set of 5 pages is backed up, the progress function
** is invoked with two integer parameters: the number of pages left to
** copy, and the total number of pages in the source file. This information
** may be used, for example, to update a GUI progress bar.
**
** While this function is running, another thread may use the database pDb, or
** another process may access the underlying database file via a separate
** connection.
**
** If the backup process is successfully completed, SQLITE_OK is returned.
** Otherwise, if an error occurs, an SQLite error code is returned.
*/
int backupDb(
sqlite3 *pDb, /* Database to back up */
const char *zFilename, /* Name of file to back up to */
void(*xProgress)(int, int) /* Progress function to invoke */
){
int rc; /* Function return code */
sqlite3 *pFile; /* Database connection opened on zFilename */
sqlite3_backup *pBackup; /* Backup handle used to copy data */
/* Open the database file identified by zFilename. */
rc = sqlite3_open(zFilename, &pFile);
if( rc==SQLITE_OK ){
/* Open the sqlite3_backup object used to accomplish the transfer */
pBackup = sqlite3_backup_init(pFile, "main", pDb, "main");
if( pBackup ){
/* Each iteration of this loop copies 5 database pages from database
** pDb to the backup database. If the return value of backup_step()
** indicates that there are still further pages to copy, sleep for
** 250 ms before repeating. */
do {
rc = sqlite3_backup_step(pBackup, 5);
xProgress(
sqlite3_backup_remaining(pBackup),
sqlite3_backup_pagecount(pBackup)
);
if( rc==SQLITE_OK || rc==SQLITE_BUSY || rc==SQLITE_LOCKED ){
sqlite3_sleep(250);
}
} while( rc==SQLITE_OK || rc==SQLITE_BUSY || rc==SQLITE_LOCKED );
/* Release resources allocated by backup_init(). */
(void)sqlite3_backup_finish(pBackup);
}
rc = sqlite3_errcode(pFile);
}
/* Close the database connection opened on database file zFilename
** and return the result of this function. */
(void)sqlite3_close(pFile);
return rc;
}
相關(guān)文章
這篇文章主要介紹了SQLite教程（三）：數(shù)據(jù)表和視圖簡介,本文講解了創(chuàng)建數(shù)據(jù)表、表的修改、表的刪除、創(chuàng)建視圖、刪除視圖等內(nèi)容,需要的朋友可以參考下2015-05-05
SQLite的數(shù)據(jù)庫本質(zhì)上來講就是一個(gè)磁盤上的文件，所以一切的數(shù)據(jù)庫操作其實(shí)都會(huì)轉(zhuǎn)化為對文件的操作，而頻繁的文件操作將會(huì)是一個(gè)很好時(shí)的過程，會(huì)極大地影響數(shù)據(jù)庫存取的速度。2008-09-09
增刪改查操作，其中增刪改操作被稱為數(shù)據(jù)操作語言 DML，相對來說簡單一點(diǎn)。 查操作相對來說復(fù)雜一點(diǎn)，涉及到很多子句，所以這篇先講增刪改操作，以例子為主，后面再講查操作2013-12-12
SQLite是一個(gè)軟件庫，實(shí)現(xiàn)了自給自足的、無服務(wù)器的、零配置的、事務(wù)性的 SQL 數(shù)據(jù)庫引擎。這篇文章主要介紹了CentOS下更新SQLite版本，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2021-12-12
SQLite高手晉級教程:調(diào)試與性能優(yōu)化以及常見問題
SQLite 是一個(gè)輕量級的數(shù)據(jù)庫,廣泛用于各種應(yīng)用中,包括移動(dòng)應(yīng)用和嵌入式系統(tǒng),盡管它非常靈活和強(qiáng)大,但在處理大規(guī)模數(shù)據(jù)或高并發(fā)請求時(shí),性能優(yōu)化變得非常重要,本篇文章將重點(diǎn)講解 SQLite 的調(diào)試工具和性能優(yōu)化技巧,以幫助您解決常見問題并進(jìn)一步提升數(shù)據(jù)庫性能2025-03-03
Sqlite3 的確很好用。小巧、速度快。但是因?yàn)榉俏④浀漠a(chǎn)品，幫助文檔總覺得不夠。這些天再次研究它，又有一些收獲，這里把我對 sqlite3 的研究列出來，以備忘記2013-12-12
SQLite 入門教程二 SQLite的創(chuàng)建、修改、刪除表
今天這一篇只涉及到表的相關(guān)內(nèi)容，視圖、觸發(fā)器等到后面再講2013-12-12
SQLite教程（十）：內(nèi)存數(shù)據(jù)庫和臨時(shí)數(shù)據(jù)庫
這篇文章主要介紹了SQLite教程（十）：內(nèi)存數(shù)據(jù)庫和臨時(shí)數(shù)據(jù)庫,本文講解了它們的創(chuàng)建方法和相關(guān)知識(shí),需要的朋友可以參考下2015-05-05
基于sqlite特殊字符轉(zhuǎn)義的實(shí)現(xiàn)方法
本篇文章是對sqlite特殊字符轉(zhuǎn)義的實(shí)現(xiàn)方法進(jìn)行了詳細(xì)的分析介紹，需要的朋友參考下2013-05-05
sQlite常用語句以及sQlite developer的使用與注冊
sQlite數(shù)據(jù)庫對大家來說應(yīng)該都不陌生，下面這篇文章主要給大家介紹了關(guān)于sQlite常用語句以及sQlite developer使用與注冊的相關(guān)資料，文中通過示例代碼與圖片給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，下面來一起看看吧。2017-10-10