總覽
選擇將資料庫遷移至 Cloud SQL 前,請務必考量這項遷移情境的已知限制。
使用 PostgreSQL 資料庫做為來源的已知限制包括:
pglogical
擴充功能不支援 PostgreSQL 12 以上版本的產生資料欄複製作業。表格結構 (DDL) 的變更不會透過標準 DDL 指令複製,而是透過使用用於複製的
pglogical
擴充功能執行的指令複製。包括 對enum
類型的變更。舉例來說,
pglogical
提供函式pglogical.replicate_ddl_command
,可在來源資料庫和複本上執行 DDL,且時間點一致。在來源上執行此指令的使用者必須已在副本上存在。如要複製新資料表的資料,您必須使用
pglogical.replication_set_add_table
指令將新資料表新增至現有的複製組合。如要進一步瞭解在遷移期間進行 DDL 複製作業,請參閱「遷移準確度」一節。
如果資料表沒有主鍵,資料庫移轉服務支援在變更資料擷取 (CDC) 階段遷移初始快照和
INSERT
陳述式。您應手動遷移UPDATE
和DELETE
陳述式。資料庫移轉服務不會遷移物化檢視畫面中的資料,只會遷移檢視畫面結構定義。如要填入檢視畫面,請執行下列指令:
REFRESH MATERIALIZED VIEW view_name
。新 Cloud SQL 目的地的
SEQUENCE
狀態 (例如last_value
) 可能與來源SEQUENCE
狀態不同。UNLOGGED
和TEMPORARY
資料表不會複製,也無法複製。不支援大型物件資料類型。詳情請參閱「遷移精確度」一節。
只有 Cloud SQL 支援的 PostgreSQL 擴充功能和程序語言可以遷移。資料庫移轉服務不會遷移 Cloud SQL 不支援的擴充功能。這些擴充功能不會阻止遷移作業,但為了確保遷移程序順利進行,請確認您的物件或應用程式不會參照任何不支援的擴充功能。建議您先從來源資料庫中移除這些擴充功能和參照,再繼續操作。
資料庫移轉服務不會遷移
pg_cron
擴充功能 (或與擴充功能相關聯的任何cron
設定),但 Cloud SQL for PostgreSQL 目的地支援這項功能。如果您在來源資料庫中使用pg_cron
擴充功能,可以在遷移完成後,在目標執行個體上重新安裝該擴充功能。
資料庫移轉服務不支援從處於復原模式的讀取備用資料庫進行遷移。
資料庫移轉服務不支援已套用 AWS SCT 擴充功能包的 Amazon RDS 來源。
- 使用者定義的函式必須以 C 編寫,才能遷移,但如果您在安裝 Cloud SQL 支援的擴充功能時,在 PostgreSQL 資料庫中安裝的函式除外。
如果來源資料庫中存在其他擴充功能和程序設計語言,或是系統不支援這些語言的版本,則測試或啟動遷移工作時會失敗。
系統不會遷移在遷移工作開始後新增的資料庫。
- 使用資料庫移轉服務遷移資料時,您無法選取特定資料表或結構定義。資料庫移轉服務會遷移所有資料表和結構定義,但下列資料表和結構定義除外:
- 資訊結構定義 (
information_schema
)。 - 開頭為
pg
的任何資料表,例如pg_catalog
。如需pg
開頭的 PostgreSQL 目錄完整清單,請參閱 PostgreSQL 說明文件中的 PostgreSQL 系統目錄。 - 使用者和使用者角色的相關資訊未遷移。
- 資訊結構定義 (
如果加密資料庫需要客戶自行管理的加密金鑰才能解密,而資料庫移轉服務無法存取這些金鑰,則無法遷移資料庫。
不過,如果客戶資料已由
pgcrypto
擴充功能加密,則可透過資料庫移轉服務遷移資料 (因為 Cloud SQL 支援該擴充功能)。資料庫移轉服務也支援從加密的 Amazon Aurora 或 Amazon RDS 資料庫遷移資料,因為這些資料庫會在服務中透明地處理解密作業。詳情請參閱「加密 Amazon Aurora 資源」和「加密 Amazon RDS 資源」。
在遷移期間,目的地 Cloud SQL 資料庫可供寫入,以便在需要時套用 DDL 變更。請注意,請勿變更資料庫設定或表格結構,否則可能會導致遷移程序中斷或影響資料完整性。
觸發事件的行為取決於設定方式。預設行為是不會觸發,但如果使用
ALTER EVENT TRIGGER
或ALTER TABLE
陳述式進行設定,且觸發狀態設為副本或一律,則會在複製期間在副本上觸發。cloudsqlexternalsync
會在 Cloud SQL 備用資源中建立含有安全性定義函式。當任何使用者執行時,系統會以cloudsqlexternalsync
的權限執行,該權限具有cloudsqlsuperuser
和cloudsqlreplica
角色。建議您將安全性定義器函式限制為僅供部分使用者使用。為此,使用者應撤銷預設的「公開」權限,然後有選擇地授予執行權限。Cloud SQL 不支援自訂的資料表空間。所有自訂資料表空間中的資料都會遷移至 Cloud SQL 目的地執行個體中的
pg_default
資料表空間。
遷移至現有目的地執行個體的限制
- 現有的目的地執行個體必須為空白,或僅包含系統設定資料。系統不支援遷移至含有使用者資料 (例如資料表) 的現有目的地執行個體。
如果現有目的地執行個體中的額外資料導致問題,請清除目的地執行個體中的資料庫,然後重新嘗試執行遷移工作。請參閱「從現有目標執行個體中清除額外資料」。
- 每個目標執行個體只能設定一個遷移工作。
- 您只能遷移至獨立的 Cloud SQL 執行個體。系統不支援遷移至外部伺服器複本。
- 不支援將資料遷移至已啟用 Private Service Connect 的 Cloud SQL 執行個體。
- 推送執行個體後,您必須啟用時間點復原功能。
- 如果執行個體有自訂備份設定 (例如自訂備份位置),則在升級執行個體後,您必須再次自訂備份設定。在升級程序期間,Cloud SQL 會將備份設定重設為預設值。
- 適用於 Terraform 使用者:資料庫移轉服務會修改目的地執行個體的備份和復原設定。這可能會導致目的地執行個體設定與用於佈建的 Terraform 設定不同。如果遇到這個問題,請按照「診斷問題」中的指示操作。
配額
- 無論何時均可存在多達 2,000 個連線設定檔和 1,000 個遷移工作。如要建立更多空間,可以刪除遷移工作 (包含已完成的工作) 和連線設定檔。