使用 pg_dump、pg_dumpall 和 pg_restore 匯出及匯入

本頁說明如何使用 pg_dump、pg_dumpall 和 pg_restore，將資料匯出並匯入至 Cloud SQL 執行個體。

事前準備

匯出作業會使用資料庫資源，但除非執行個體的資源不足，否則不會干擾正常的資料庫作業。

如需最佳做法，請參閱「匯入及匯出資料的最佳做法」。

完成匯入作業後，請驗證結果。

進一步瞭解 pg_dump、pg_dumpall 和 pg_restore 公用程式。

從 PostgreSQL 適用的 Cloud SQL 匯出資料

您可以使用 Cloud SQL 從 Google Cloud 控制台、gcloud CLI 或 API 執行匯出作業。

  • 如要匯出單一 PostgreSQL 資料庫，請使用 pg_dump 公用程式。
  • 如要匯出叢集中的所有 PostgreSQL 資料庫，請使用 pg_dumpall 公用程式。

使用任一公用程式時，請務必使用必要選項，確保產生的匯出檔案有效，可匯回至 Cloud SQL。

使用 pg_dump 從內部部署 PostgreSQL 伺服器匯出資料

如要匯出非由 Cloud SQL 管理的資料庫，以便日後匯入至 Cloud SQL，請使用 pg_dump 公用程式，並搭配下列旗標：

  • --no-owner

    傾印檔案中不得包含擁有權變更指令。

  • --format

    如果轉儲檔案是用於搭配 pg_restore 使用，則允許使用 custom 和 directory 格式。

    針對 plain-text 格式，請改為匯出至 SQL dump file。這個格式與 pg_restore 不相容，必須使用 Google Cloud 主控台匯入指令或 psql 用戶端進行匯入。

  • --no-acl

    如果您的傾印包含授予或撤銷 SUPERUSER 角色成員資格的陳述式，則需要這個標記。

  • --clean

    這個選用旗標可讓您加入 DROP <object> SQL 陳述式，在匯入資料庫物件前先將其刪除 (清除)。

  • --if-exists

    這個選用標記可讓您在 clean 標記產生的每個 DROP 陳述式中，加入 IF EXISTS SQL 陳述式。

此外，您必須移除下列所有內容：

  • 擴充功能相關陳述式 (如果 Cloud SQL 不支援該擴充功能)。如需支援的擴充功能清單，請參閱「PostgreSQL 擴充功能」。
  • CREATE EXTENSION 或 DROP EXTENSION 陳述式參照 plpgsql。這個擴充功能會預先安裝在 Cloud SQL Postgres 執行個體中。
  • COMMENT ON EXTENSION 陳述式來變更這些使用者的權限。

確認資料庫設定所決定的預設編碼是否適用於您的資料。如有需要，您可以使用 --encoding 旗標覆寫預設值。

使用 custom 格式從 PostgreSQL 適用的 Cloud SQL 匯出資料

如要使用自訂格式，請透過指令列執行 pg_dump：

pg_dump \
-U USERNAME \
--format=custom \
--no-owner \
--no-acl \
DATABASE_NAME > DATABASE_NAME.dmp

從 PostgreSQL 適用的 Cloud SQL 並行匯出多個檔案中的資料

您只能使用 directory 輸出格式，平行匯出多個檔案的資料。

如要同時匯出，請使用 -j NUM_CORES 旗標。NUM_CORES 是來源執行個體的核心數量。

匯出所有資料庫

pg_dumpall 是一種公用程式，可將叢集中的所有 PostgreSQL 資料庫擷取至單一指令碼檔案。這個檔案包含可用來還原資料庫的 SQL 指令。

如要匯出 Cloud SQL 執行個體中的所有 PostgreSQL 資料庫，請使用 pg_dumpall 公用程式，並加上下列必要標記：

  • exclude-database=cloudsqladmin
  • exclude-database=template*

pg_dumpall 公用程式無法存取 cloudsqladmin 或 template 資料庫。

如要匯出所有 PostgreSQL 資料庫，請執行下列指令：

pg_dumpall \
-h HOST_NAME -l DATABASE_NAME –exclude-database=cloudsqladmin \
–exclude-database=template* > pg_dumpall.sql

如要在使用 pg_dumpall 轉儲角色時查看角色密碼，請將 cloudsql.pg_authid_select_role 標記設為 PostgreSQL 角色名稱。如果角色存在，則該角色對 pg_authid 資料表有唯讀 (SELECT) 存取權。這個表格包含角色密碼。

匯入

使用 pg_restore 公用程式將封存檔匯入 Cloud SQL 資料庫。pg_restore 僅適用於由 pg_dump 以 custom 或 directory 格式建立的封存檔。進一步瞭解 pg_restore。

從使用 custom 格式建立的傾印檔案匯入 PostgreSQL 適用的 Cloud SQL

如果您使用自訂格式建立轉儲檔案，請執行下列指令：

pg_restore \
--list DATABASE_NAME.dmp | sed -E 's/(.* EXTENSION )/; \1/g' >  DATABASE_NAME.toc

sed 的後置處理程序會註解 SQL 傾印檔案中的所有擴充功能陳述式。

使用 pg_restore 匯入時，請使用指令列引數「--use-list=DATABASE_NAME.toc」指定已處理的目錄表。

將資料從多個檔案並行匯入 PostgreSQL 適用的 Cloud SQL

您只能針對使用 directory 和 custom 輸出格式建立的封存檔，並行匯入多個檔案的資料。

如要並行匯入，請使用 -j NUM_CORES 標記。NUM_CORES 是目的地執行個體的核心數量。

在 PostgreSQL 適用的 Cloud SQL 上匯入資料的效能

後續步驟