PostgreSQ pg_verifybackup

簡(jiǎn)介

pg_verifybackup用于根據(jù)備份時(shí)服務(wù)器生成的backup_manifest檢查使用pg_basebackup進(jìn)行的數(shù)據(jù)庫(kù)群集備份的完整性。備份必須以“普通”格式存儲(chǔ)；“tar”格式的備份可以在解壓縮后進(jìn)行檢查。

需要注意的是，由pg_verifybackup執(zhí)行的驗(yàn)證不包括也不可能包括運(yùn)行中的服務(wù)器在嘗試使用備份時(shí)執(zhí)行的所有檢查。 即使使用此工具，也應(yīng)執(zhí)行測(cè)試還原，并驗(yàn)證生成的數(shù)據(jù)庫(kù)是否按預(yù)期工作，以及它們是否包含正確的數(shù)據(jù)。但是，pg_verifybackup可以檢測(cè)到由于存儲(chǔ)問(wèn)題或用戶錯(cuò)誤而經(jīng)常出現(xiàn)的許多問(wèn)題。

備份驗(yàn)證分四個(gè)階段進(jìn)行。首先，pg_verifybackup讀取backup_manifest文件。如果該文件不存在、無(wú)法讀取、格式不正確或無(wú)法根據(jù)其內(nèi)部校驗(yàn)和進(jìn)行驗(yàn)證，pg_verifybackup 將以致命錯(cuò)誤終止。

其次，pg_verifybackup 將嘗試驗(yàn)證當(dāng)前存儲(chǔ)在磁盤(pán)上的數(shù)據(jù)文件是否與服務(wù)器打算發(fā)送的數(shù)據(jù)文件完全相同，下面將介紹一些例外情況。 除了少數(shù)例外，額外和丟失的文件將被檢測(cè)到。此步驟將忽略 postgresql.auto.conf、standby.signal 和 recovery.signal 的存在與否或?qū)ζ涞娜魏涡薷?，因?yàn)轭A(yù)計(jì)這些文件可能是在備份過(guò)程中創(chuàng)建或修改的。它也不會(huì)抱怨目標(biāo)目錄中的 backup_manifest文件或 pg_wal 中的任何內(nèi)容，即使這些文件不會(huì)列在備份清單中。只檢查文件；不驗(yàn)證目錄的存在與否，除非間接驗(yàn)證：如果目錄丟失，則它應(yīng)該包含的任何文件也必然會(huì)丟失。

接下來(lái)，pg_verifybackup將對(duì)所有文件進(jìn)行校驗(yàn)和計(jì)算，將校驗(yàn)和與清單中的值進(jìn)行比較，并對(duì)計(jì)算出的校驗(yàn)和與清單中存儲(chǔ)的校驗(yàn)和不匹配的任何文件發(fā)出錯(cuò)誤。對(duì)于在上一步中產(chǎn)生錯(cuò)誤的任何文件，不執(zhí)行此步驟，因?yàn)橐阎@些文件存在問(wèn)題。在上一步中被忽略的文件在此步驟中也被忽略。

最后，pg_verifybackup 將使用清單來(lái)驗(yàn)證恢復(fù)備份所需的預(yù)寫(xiě)式日志記錄是否存在，并且它們可以被讀取和解析。 backup_manifest 包含有關(guān)需要哪些預(yù)寫(xiě)式日志記錄的信息，并且 pg_verifybackup 將使用該信息來(lái)調(diào)用 pg_waldump 來(lái)解析這些預(yù)寫(xiě)式日志記錄。 --quiet標(biāo)志將被使用，因此 pg_waldump 只會(huì)報(bào)告錯(cuò)誤，而不會(huì)產(chǎn)生任何其他輸出。雖然這種級(jí)別的驗(yàn)證足以檢測(cè)明顯的問(wèn)題，例如丟失的文件或內(nèi)部校驗(yàn)和不匹配的問(wèn)題，但它們還不足以檢測(cè)嘗試恢復(fù)時(shí)可能出現(xiàn)的所有問(wèn)題。例如，此方法無(wú)法檢測(cè)到產(chǎn)生具有正確校驗(yàn)和但指定無(wú)意義操作的預(yù)寫(xiě)式日志記錄的服務(wù)器錯(cuò)誤。

請(qǐng)注意，如果存在不需要恢復(fù)備份的額外 WAL 文件，則此工具不會(huì)檢查它們，盡管可以為此使用單獨(dú)的 pg_waldump 調(diào)用。 另請(qǐng)注意，WAL 驗(yàn)證是特定于版本的：您必須使用 pg_verifybackup 的版本，因此是 pg_waldump 的版本，它與正在檢查的備份有關(guān)。 相比之下，數(shù)據(jù)文件完整性檢查應(yīng)適用于生成 backup_manifest 文件的任何版本的服務(wù)器。

選項(xiàng)

pg_verifybackup 接受以下命令行參數(shù)：

其他選項(xiàng)也可用：

示例

要在 mydbserver 上創(chuàng)建服務(wù)器的基本備份并驗(yàn)證備份的完整性：

$ pg_basebackup -h mydbserver -D /usr/local/pgsql/data
$ pg_verifybackup /usr/local/pgsql/data

要在 mydbserver 上創(chuàng)建服務(wù)器的基本備份，請(qǐng)將清單移動(dòng)到備份目錄之外的某個(gè)位置，并驗(yàn)證備份：

$ pg_basebackup -h mydbserver -D /usr/local/pgsql/backup1234
$ mv /usr/local/pgsql/backup1234/backup_manifest /my/secure/location/backup_manifest.1234
$ pg_verifybackup -m /my/secure/location/backup_manifest.1234 /usr/local/pgsql/backup1234

要在忽略手動(dòng)添加到備份目錄的文件的同時(shí)驗(yàn)證備份，并跳過(guò)校驗(yàn)和驗(yàn)證：

$ pg_basebackup -h mydbserver -D /usr/local/pgsql/data
$ edit /usr/local/pgsql/data/note.to.self
$ pg_verifybackup --ignore=note.to.self --skip-checksums /usr/local/pgsql/data

另見(jiàn)