當您想將 PostgreSQL 封存備份還原到現有資料庫,或在其他環境中重建內容時,請使用 連線 樹狀結構中的 從檔案還原資料庫。 webview 會為您建立指令 pg_restore ,顯示有效的還原範圍,並要求在開始前先進行預檢確認。
Prerequisites
- PostgreSQL 擴充套件中已連線的伺服器。
- 啟用備份與還原介面(
pgsql.enablePgDumpRestoreUI預設為true)。 - 安裝於擴充主機上的 PostgreSQL 用戶端工具,包括
pg_restore與歸檔及目標伺服器相容的版本。 請使用與建立壓縮檔相同的pg_dump主要用戶端版本,或使用較新且受支援的版本。 舊客戶端可以拒絕較新的歸檔格式。 如果擴充功能找不到已安裝的二進位檔,請設定pgsql.pgBinaryDirs並重新啟動編輯器。 此設定不會安裝這些工具。 - 一個資料庫角色,具有所選還原作業所需的權限與擁有權;若已啟用 「建立資料庫」,還必須包括
CREATEDB。 - 以
pg_restore支援的封存格式(如自訂、tar 或目錄)進行備份。 偵測到的是純 SQL 檔案,但頁面警告應該改用psql還原。
在另一台伺服器還原時,請先建立或遷移歸檔所參考的任何角色,再恢復所有權與授權。 每個資料庫的封存不包含全域角色定義。 缺少目標角色可能導致擁有權或權限還原錯誤。 請參閱 「以傾印與還原方式移轉使用者與角色」。
Warning
僅還原來自受信任來源的封存檔。 還原可以執行來源伺服器上超級使用者所選擇的 SQL,包括在部分還原期間。 命令預覽會顯示命令列參數,而非封存中的所有 SQL。 若要在還原前檢查該 SQL,請使用--file參考pg_restore中描述的選項。
還原資料庫
- 在 連線 樹狀結構中,對目標伺服器或資料庫按右鍵。
- 選擇「備份與還原>>」。
- 在 「還原您的資料庫」 中,選擇 目標資料庫 與 備份檔案。
- 選擇 還原模式:
- 完整 則會還原封存內容。
- 僅結構 僅還原結構,不含資料。
- 僅資料 會還原資料,不包含結構描述物件。
- 選取備份檔案後,請檢視偵測到的 「格式」 與 「資料庫」(存於封存中) 欄位。
使用 進階選項 來細化還原指令。 抽屜面板會將設定群組成 範圍、還原行為、效能與日誌、輸出、資料庫層級設定,以及 安全性。 根據所選模式與歸檔格式,部分選項會變得無法使用,並會說明原因。
頁面啟動時,也會顯示指令預覽,讓您在執行前先檢視產生 pg_restore 的參數。
確認還原操作
Warning
啟用 「建立資料庫 」時,存於壓縮檔中的資料庫名稱即為還原目的地。 在此模式下,所選的連線/資料庫僅用於初始維護指令。 如果同時啟用 「清理」,則 pg_restore 會丟棄並重建整個以歸檔名稱命名的資料庫,刪除其現有的物件與資料,包括備份中不存在的任何物件和資料。 請確認伺服器與歸檔資料庫名稱,並在繼續前保留可復原的備份。
選擇 「開始還原 」以開啟 「確認還原操作」。 預檢對話方塊會在擴充功能執行任何動作前總結還原目標:
- 還原目標 顯示伺服器、目標或維護連線、存於封存中的資料庫、備份檔案、還原模式及啟用區段。
- 範圍 顯示包含多少結構描述、資料表、索引、函數及觸發器。
- 安全設定 總結了選項,例如錯誤停止、單交易模式、擁有權還原、訂閱、發佈、權限及觸發行為。
如果還原具有破壞性,對話方塊會加入更強烈的警告。 例如:
- 若未啟用 建立資料庫,使用 「清除」 進行還原會警告可丟棄並重新建立相符的還原物件。
- 使用 建立資料庫 還原會檢查該歸檔資料庫是否已存在。 如果有,且未啟用 清理 ,擴充功能會阻擋還原,而非允許合併到現有資料庫。
- 當需要輸入確認時,您必須先輸入與資料庫名稱完全相符的名稱,「確認並開始還原」才會變為可用。
確認後,狀態檢視會顯示進度與日誌。 如果還原失敗,頁面會保留指令預覽和收集的輸出,方便您檢視錯誤或使用 Copilot 除錯。