一、常用備份:
下面的方法是比較簡(jiǎn)單且常用的SQLite數(shù)據(jù)庫(kù)備份方式,見(jiàn)如下步驟:
1). 使用SQLite API或Shell工具在源數(shù)據(jù)庫(kù)文件上加共享鎖。
2). 使用Shell工具(cp或copy)拷貝數(shù)據(jù)庫(kù)文件到備份目錄。
3). 解除數(shù)據(jù)庫(kù)文件上的共享鎖。
以上3個(gè)步驟可以應(yīng)用于大多數(shù)場(chǎng)景,而且速度也比較快,然而卻存在一定的剛性缺陷,如:
1). 所有打算在源數(shù)據(jù)庫(kù)上執(zhí)行寫操作的連接都不得不被掛起,直到整個(gè)拷貝過(guò)程結(jié)束并釋放文件共享鎖。
2). 不能拷貝數(shù)據(jù)到in-memory數(shù)據(jù)庫(kù)。
3). 在拷貝過(guò)程中,一旦備份數(shù)據(jù)庫(kù)所在的主機(jī)出現(xiàn)任何突發(fā)故障,備份數(shù)據(jù)庫(kù)可能會(huì)被破壞。
在SQLite中提供了一組用于在線數(shù)據(jù)庫(kù)備份的APIs函數(shù)(C接口),可以很好的解決上述方法存在的不足。通過(guò)該組函數(shù),可以將源數(shù)據(jù)庫(kù)中的內(nèi)容拷貝到另一個(gè)數(shù)據(jù)庫(kù),同時(shí)覆蓋目標(biāo)數(shù)據(jù)庫(kù)中的數(shù)據(jù)。整個(gè)拷貝過(guò)程可以以增量的方式完成,在此情況下,源數(shù)據(jù)庫(kù)也不需要在整個(gè)拷貝過(guò)程中都被加鎖,而只是在真正讀取數(shù)據(jù)時(shí)加共享鎖。這樣,其它的用戶在訪問(wèn)源數(shù)據(jù)庫(kù)時(shí)就不會(huì)被掛起。
二、在線備份APIs簡(jiǎn)介:
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對(duì)象,該對(duì)象將作為本次拷貝操作的句柄傳給其余兩個(gè)函數(shù)。
2). 函數(shù)sqlite3_backup_step()用于數(shù)據(jù)拷貝,如果該函數(shù)的第二個(gè)參數(shù)為-1,那么整個(gè)拷貝過(guò)程都將在該函數(shù)的一次調(diào)用中完成。
3). 函數(shù)sqlite3_backup_finish()用于釋放sqlite3_backup_init()函數(shù)申請(qǐng)的資源,以避免資源泄露。
在整個(gè)拷貝過(guò)程中如果出現(xiàn)任何錯(cuò)誤,我們都可以通過(guò)調(diào)用目的數(shù)據(jù)庫(kù)連接的sqlite3_errcode()函數(shù)來(lái)獲取具體的錯(cuò)誤碼。此外,如果sqlite3_backup_step()調(diào)用失敗,由于sqlite3_backup_finish()函數(shù)并不會(huì)修改當(dāng)前連接的錯(cuò)誤碼,因此我們可以在調(diào)用sqlite3_backup_finish()之后再獲取錯(cuò)誤碼,從而在代碼中減少了一次錯(cuò)誤處理。見(jiàn)如下代碼示例(來(lái)自SQLite官網(wǎng)):
/* 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;
}
三、高級(jí)應(yīng)用技巧:
在上面的例子中,我們是通過(guò)sqlite3_backup_step()函數(shù)的一次調(diào)用完成了整個(gè)拷貝過(guò)程。該實(shí)現(xiàn)方式仍然存在之前說(shuō)過(guò)的掛起其它寫訪問(wèn)連接的問(wèn)題,為了解決該問(wèn)題,這里我們將繼續(xù)介紹另外一種更高級(jí)的實(shí)現(xiàn)方式--分片拷貝,其實(shí)現(xiàn)步驟如下:
1). 函數(shù)sqlite3_backup_init()用于創(chuàng)建sqlite3_backup對(duì)象,該對(duì)象將作為本次拷貝操作的句柄傳給其余兩個(gè)函數(shù)。
2). 函數(shù)sqlite3_backup_step()被調(diào)用用于拷貝數(shù)據(jù),和之前方法不同的是,該函數(shù)的第二個(gè)參數(shù)不再是-1,而是一個(gè)普通的正整數(shù),表示每次調(diào)用將會(huì)拷貝的頁(yè)面數(shù)量,如5。
3). 如果在函數(shù)sqlite3_backup_step()調(diào)用結(jié)束后,仍然有更多的頁(yè)面需要被拷貝,那么我們將主動(dòng)休眠250ms,然后再重復(fù)步驟2).
4). 函數(shù)sqlite3_backup_finish()用于釋放sqlite3_backup_init()函數(shù)申請(qǐng)的資源,以避免資源泄露。
在上述步驟3)中我們主動(dòng)休眠250ms,此期間,該拷貝操作不會(huì)在源數(shù)據(jù)庫(kù)上持有任何讀鎖,這樣其它的數(shù)據(jù)庫(kù)連接在進(jìn)行寫操作時(shí)亦將不會(huì)被掛起。然而在休眠期間,如果另外一個(gè)線程或進(jìn)程對(duì)源數(shù)據(jù)庫(kù)進(jìn)行了寫操作,SQLite將會(huì)檢測(cè)到該事件的發(fā)生,從而在下一次調(diào)用sqlite3_backup_step()函數(shù)時(shí)重新開(kāi)始整個(gè)拷貝過(guò)程。唯一的例外是,如果源數(shù)據(jù)庫(kù)不是in-memory數(shù)據(jù)庫(kù),同時(shí)寫操作是在與拷貝操作同一個(gè)進(jìn)程內(nèi)完成,并且在操作時(shí)使用的也是同一個(gè)數(shù)據(jù)庫(kù)連接句柄,那么目的數(shù)據(jù)庫(kù)中數(shù)據(jù)也將被此操作同時(shí)自動(dòng)修改。在下一次調(diào)用sqlite3_backup_step()時(shí),也將不會(huì)有任何影響發(fā)生。
事實(shí)上,在SQLite中仍然提供了另外兩個(gè)輔助性函數(shù)backup_remaining()和backup_pagecount(),其中前者將返回在當(dāng)前備份操作中還有多少頁(yè)面需要被拷貝,而后者將返回本次操作總共需要拷貝的頁(yè)面數(shù)量。顯而易見(jiàn)的是,通過(guò)這兩個(gè)函數(shù)的返回結(jié)果,我們可以實(shí)時(shí)顯示本次備份操作的整體進(jìn)度,計(jì)算公式如下:
Completion = 100% * (pagecount() - remaining()) / pagecount()
見(jiàn)以下代碼示例(來(lái)自SQLite官網(wǎng)):
/* 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;
}
標(biāo)簽:通化 泰州 那曲 臨滄 阜陽(yáng) 荊州 海北 齊齊哈爾
巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《SQLite學(xué)習(xí)手冊(cè)(SQLite在線備份)》,本文關(guān)鍵詞 SQLite,學(xué)習(xí),手冊(cè),在線,備份,;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問(wèn)題,煩請(qǐng)?zhí)峁┫嚓P(guān)信息告之我們,我們將及時(shí)溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無(wú)關(guān)。上一篇:SQLite3 命令行操作指南