本頁面說明如何使用邏輯容錯移轉運算單元,設定 PostgreSQL 適用的 Cloud SQL 邏輯複製功能,以便與進階災難復原 (DR) 作業順暢搭配運作,特別是 Cloud SQL Enterprise Plus 版執行個體的切換和副本容錯移轉作業。
Cloud SQL 的進階災難復原 (DR) 功能可提供強大的災難復原能力。與 PostgreSQL 的邏輯複製功能搭配使用時,請務必確保複製串流在切換或副本容錯移轉後不會中斷。
使用進階災難復原 (DR) 搭配 PostgreSQL 的邏輯複製功能,可確保邏輯訂閱者不會發生資料遺失,並在災難復原事件發生後自動重新連線至新的主要執行個體,確保營運持續。
您可以在採用下列設定的 Cloud SQL 執行個體上使用這項功能:
- PostgreSQL 17 以上版本
- Cloud SQL Enterprise Plus 版本
私人服務存取權
建議您使用私人服務存取網域名稱服務 (DNS) 寫入端點,啟用自動邏輯訂閱者重新連線功能。
事前準備
-
請務必使用 502.0.0 以上版本。如要查看 Google Cloud SDK 的版本,請執行
gcloud --version。如要更新 Google Cloud SDK,請執行gcloud components update。 建立 Google Cloud 專案或選取現有專案。
授予必要的 Identity and Access Management (IAM) 角色和權限。
建立專案:專案建立者 (
roles/resourcemanager.projectCreator)建立及管理 Cloud SQL 執行個體:Cloud SQL 管理員 (
roles/cloudsql.admin)如要建立及管理 Compute Engine VM:Compute 執行個體管理員 (v1) (
roles/compute.instanceAdmin.v1) 和Compute 檢視者 (roles/compute.networkViewer)建立虛擬私有雲網路:網路管理員 (
roles/compute.networkAdmin)
詳情請參閱「角色和權限」。
如要瞭解如何授予 IAM 角色和權限,請參閱「管理專案、資料夾和組織的存取權」。
使用邏輯複製功能設定進階災難復原 (DR)
使用 PostgreSQL 的邏輯複製功能設定進階災難復原 (DR) 的程序,大致包含下列步驟:
- 設定環境變數和堡壘 VM。
- 建立及設定主要執行個體。
- 建立及指定 DR 副本。
- 建立及設定邏輯訂閱者執行個體。
- 建立邏輯複製訂閱項目。
- 執行切換或副本容錯移轉。
- 驗證複製作業。
- 清除新副本上的孤立複製運算單元。
- 選用步驟:執行切換。
設定環境變數和堡壘 VM
設定下列環境變數。
# Project export PROJECT="PROJECT_ID" # Instance names export PRIMARY_INSTANCE_NAME="PRIMARY_INSTANCE" export DR_REPLICA_NAME="DR_REPLICA" export SUBSCRIBER_INSTANCE_NAME="SUBSCRIBER_INSTANCE" export BASTION_VM_NAME="BASTION_VM" # Regions and zones export PRIMARY_REGION="PRIMARY_REGION" export REPLICA_REGION="REPLICA_REGION" export SUBSCRIBER_REGION="SUBSCRIBER_REGION" export VM_ZONE="VM_ZONE" # Network export NETWORK_NAME="NETWORK" # Credentials export POSTGRES_PASSWORD="PASSWORD" # Set gcloud project gcloud config set project PROJECT_ID更改下列內容:
- PROJECT_ID:專案 ID。
- PRIMARY_INSTANCE:主要 Cloud SQL 執行個體的名稱。
- DR_REPLICA:副本名稱。
- SUBSCRIBER_INSTANCE:訂閱者執行個體的名稱。
- BASTION_VM:堡壘 VM 的名稱。
- PRIMARY_REGION:主要執行個體所在的區域。
- REPLICA_REGION:副本所在的區域。副本必須位於與主要執行個體不同的區域。
- SUBSCRIBER_REGION:訂閱者所在的區域。
- VM_ZONE:堡壘 VM 所在的可用區。
- NETWORK:虛擬私有雲網路的名稱。
- PASSWORD:
postgres使用者的密碼。
建立 Compute Engine 堡壘 VM。
Cloud SQL 執行個體使用私人 IP。因此,請在虛擬私有雲網路中建立 Compute Engine 堡壘主機 VM。
gcloud compute instances create $BASTION_VM_NAME \ --zone=$VM_ZONE \ --machine-type=e2-small \ --network=projects/$PROJECT_ID/global/networks/$NETWORK_NAME \ --image-project=debian-cloud \ --image-family=debian-11 \ --project=$PROJECT連線至堡壘 VM。
gcloud compute ssh $BASTION_VM_NAME \ --zone=$VM_ZONE \ --project=$PROJECT在堡壘 VM 上安裝 PostgreSQL 用戶端。
sudo apt-get update sudo apt-get install -y postgresql-client exit
後續步驟中的 PostgreSQL 指令,必須從堡壘 VM 執行。
建立及設定主要執行個體
建立主要 Cloud SQL 執行個體。
gcloud sql instances create $PRIMARY_INSTANCE_NAME \ --database-version=POSTGRES_17 \ --edition=ENTERPRISE_PLUS \ --region=$PRIMARY_REGION \ --tier=db-perf-optimized-N-2 \ --no-assign-ip \ --network=projects/$PROJECT/global/networks/$NETWORK_NAME \ --project=$PROJECT啟用邏輯解碼。
gcloud sql instances patch $PRIMARY_INSTANCE_NAME \ --database-flags=cloudsql.logical_decoding=on \ --project=$PROJECT設定主要執行個體上
postgres使用者的密碼。gcloud sql users set-password postgres \ --instance=$PRIMARY_INSTANCE_NAME \ --password="$POSTGRES_PASSWORD" \ --project=$PROJECT從堡壘 VM 連線至主要執行個體。
擷取主要執行個體的私人 IP 位址。
gcloud sql instances describe $PRIMARY_INSTANCE_NAME \ --format="value(ipAddresses[0].ipAddress)" \ --project=$PROJECT複製並保留主要執行個體的私人 IP 位址。
透過 SSH 連線至堡壘 VM。
gcloud compute ssh $BASTION_VM_NAME --zone=$VM_ZONE --project=$PROJECT從堡壘 VM 連線至主要執行個體。
psql -h PRIMARY_PRIVATE_IP -U postgres將 PRIMARY_PRIVATE_IP 替換為您在本程序步驟 4.a 中擷取的主要執行個體私人 IP。
系統提示輸入密碼時,請輸入變數
$POSTGRES_PASSWORD。堡壘 VM 現在已透過 PostgreSQL 連線至主要執行個體。
授予權限並建立出版品。
將
REPLICATION權限授予postgres使用者。ALTER USER postgres WITH REPLICATION;授予公開結構定義和資料表的必要權限。
GRANT SELECT ON ALL TABLES IN SCHEMA public TO postgres;為所有資料表建立發布作業。
CREATE PUBLICATION my_publication FOR ALL TABLES;輸入
exit退出 PostgreSQL,然後再次輸入exit關閉堡壘 VM 的 SSH 工作階段。
建立及指定災難復原副本 (DR 副本)
建立災難復原副本。
gcloud sql instances create $DR_REPLICA_NAME \ --master-instance-name=$PRIMARY_INSTANCE_NAME \ --edition=ENTERPRISE_PLUS \ --tier=db-perf-optimized-N-2 \ --region=$REPLICA_REGION \ --no-assign-ip \ --network=projects/$PROJECT/global/networks/$NETWORK_NAME \ --project=$PROJECT將這個副本指派為 DR 副本。
gcloud sql instances patch $PRIMARY_INSTANCE_NAME \ --failover-dr-replica-name=$DR_REPLICA_NAME \ --project=$PROJECT設定 DR 副本,以便同步處理邏輯運算單元。
gcloud sql instances patch $DR_REPLICA_NAME \ --database-flags="^:^cloudsql.logical_decoding=on:hot_standby_feedback=on:sync_replication_slots=on:cloudsql.logical_slot_sync_dbname=postgres" \ --project=$PROJECT設定主要執行個體和 DR 副本之間的同步複製。
為避免主要執行個體突然中斷,以及後續副本容錯移轉,導致邏輯訂閱者可能遺失資料,建議您在主要執行個體和災難備援副本之間設定同步複製。
在主要執行個體上設定
cloudsql.synchronized_standby_replicas,會強制主要執行個體的邏輯複製預寫記錄 (WAL) 傳送者等待,直到 DR 副本收到並排清特定交易的 WAL,再將該交易傳送至邏輯訂閱者。這可確保 DR 副本的狀態一律領先或等於邏輯訂閱者的狀態。gcloud sql instances patch $PRIMARY_INSTANCE_NAME \ --database-flags="^:^cloudsql.logical_decoding=on:cloudsql.synchronized_standby_replicas=$DR_REPLICA_NAME" \ --project=$PROJECT
建立及設定邏輯訂閱者執行個體
建立訂閱者執行個體。
gcloud sql instances create $SUBSCRIBER_INSTANCE_NAME \ --database-version=POSTGRES_17 \ --tier=db-perf-optimized-N-2 \ --region=$SUBSCRIBER_REGION \ --no-assign-ip \ --network=projects/$PROJECT/global/networks/$NETWORK_NAME \ --project=$PROJECT在訂閱端啟用邏輯解碼。
gcloud sql instances patch $SUBSCRIBER_INSTANCE_NAME \ --database-flags=cloudsql.logical_decoding=on \ --project=$PROJECT
建立邏輯複製訂閱項目
擷取主要執行個體的私人服務存取權寫入端點。
gcloud sql instances describe $PRIMARY_INSTANCE_NAME \ --format="value(replicationCluster.psaWriteEndpoint)" \ --project=$PROJECT複製並保留寫入端點。
連線至訂閱者執行個體。
更新訂閱者執行個體
postgres使用者的密碼。gcloud sql users set-password postgres \ --instance=$SUBSCRIBER_INSTANCE_NAME \ --password="$POSTGRES_PASSWORD" \ --project=$PROJECT擷取訂閱者執行個體的私人 IP 位址。
gcloud sql instances describe $SUBSCRIBER_INSTANCE_NAME \ --format="value(ipAddresses[0].ipAddress)" \ --project=$PROJECT複製並保留私人 IP 位址。
透過 SSH 連線至堡壘 VM。
gcloud compute ssh $BASTION_VM_NAME \ --zone=$VM_ZONE \ --project=$PROJECT從堡壘 VM 透過 PostgreSQL 連線至訂閱者執行個體。
psql -h SUBSCRIBER_PRIVATE_IP -U postgres將 SUBSCRIBER_PRIVATE_IP 替換成您在本程序步驟 2.b 複製的訂閱者執行個體私人 IP。
系統提示輸入密碼時,請輸入變數
$POSTGRES_PASSWORD。
建立訂閱項目。
CREATE SUBSCRIPTION my_subscription CONNECTION 'host=DR_CLUSTER_PSA_DNS_WRITE_ENDPOINT port=5432 dbname=postgres user=postgres password=PASSWORD' PUBLICATION my_publication WITH (failover = true);更改下列內容:
- DR_CLUSTER_PSA_DNS_WRITE_ENDPOINT:您在本程序步驟 1 複製的私人服務存取權寫入端點。
- PASSWORD:變數
${POSTGRES_PASSWORD}的值。
結束 PostgreSQL 和堡壘 VM SSH 工作階段。
選用。驗證 DR 副本上的運算單元持續性。
如果主要活動的活動量較低,通常會在幾秒內快速轉換為持續狀態 (
temporary = false)。如果主要執行個體的寫入負載過重,這項程序可能需要較長時間,通常約一分鐘。完成這些手動指令後,運算單元應會保留。取得 DR 副本的私人 IP 位址。
gcloud sql instances describe $DR_REPLICA_NAME \ --format="value(ipAddresses[0].ipAddress)" \ --project=$PROJECT複製並保留 DR 副本的私人 IP 位址。
透過 SSH 連線至堡壘 VM。
gcloud compute ssh $BASTION_VM_NAME \ --zone=$VM_ZONE \ --project=$PROJECT從防禦主機 VM 連線至災難備援副本。
psql -h DR_REPLICA_PRIVATE_IP -U postgres將 DR_REPLICA_PRIVATE_IP 替換為您在本程序步驟 5.a 中擷取的 DR 副本私人 IP 位址。
系統提示輸入密碼時,請輸入變數
$POSTGRES_PASSWORD。查看運算單元狀態。
SELECT slot_name, slot_type, temporary, failover, synced FROM pg_replication_slots WHERE slot_type = 'logical' AND failover = true;等待「
temporary」欄變成f。通常不到一分鐘。結束 PostgreSQL 和堡壘 VM SSH 工作階段。
執行切換或副本容錯移轉
請根據您的情境選擇要執行的作業:
切換 (預定角色反轉):如要進行預定維護、災難復原測試,或在主要執行個體上線且健康狀態良好時切換角色,請選擇這個選項。這項作業可確保實體複製作業不會發生資料遺失。
gcloud sql instances switchover $DR_REPLICA_NAME \ --project=$PROJECT副本容錯移轉 (災難復原):如果主要執行個體無法使用或沒有回應,請選擇這個選項。這項作業會將 DR 副本升級為主要副本。為盡可能降低邏輯訂閱者資料遺失的風險,請務必按照「建立及指定災難復原副本 (DR 副本)」中的建議,在主要執行個體上設定
cloudsql.synchronized_standby_replicas。gcloud sql instances promote-replica $DR_REPLICA_NAME \ --failover \ --project=$PROJECT$DR_REPLICA_NAME的升級作業很快就會完成。不過,原始主要執行個體 ($PRIMARY_INSTANCE_NAME) 重新上線後,才會重新設定為新主要執行個體的副本。如要追蹤這項作業,請在作業記錄中查看$PRIMARY_INSTANCE_NAME的RECONFIGURE_OLD_PRIMARY作業是否完成。執行下列指令:gcloud sql operations list --instance=$PRIMARY_INSTANCE_NAME --project=$PROJECT --limit=10`這個階段完成後,災難復原設定才會完全還原。
完成任一作業後,訂閱者會透過私人服務存取權寫入端點,自動重新連線至新的主要 $DR_REPLICA_NAME。
旗標管理
在切換和副本容錯移轉作業期間及之後,Cloud SQL 的工作流程會自動管理災難復原叢集內兩個執行個體上的必要資料庫旗標,包括:
- 邏輯運算槽同步旗標 (
cloudsql.logical_decoding、hot_standby_feedback、sync_replication_slots、cloudsql.logical_slot_sync_dbname) 在成為新副本的執行個體上,確保正確無誤。 - 成為新主要執行個體的執行個體上,
cloudsql.synchronized_standby_replicas旗標會自動更新,指向新災難備援副本的名稱。
切換或副本容錯移轉作業完成後,您不必手動重新套用或變更這些旗標。Cloud SQL 會維護主要和副本角色的正確設定。
驗證複製作業
查看訂閱者狀態。
在堡壘 VM 執行下列指令。
psql -h SUBSCRIBER_PRIVATE_IP -U postgres將 SUBSCRIBER_PRIVATE_IP 替換為訂閱者執行個體的私人 IP 位址。
在訂閱者執行個體上執行下列指令。
SELECT subname, pid IS NOT NULL AS is_active FROM pg_stat_subscription;狀態應為「
streaming」。
查看新主要執行個體的複製運算單元狀態。新的主要執行個體是先前的 DR 副本 (
$DR_REPLICA_NAME)。取得新主要執行個體的私人 IP 位址。
gcloud sql instances describe $DR_REPLICA_NAME \ --project=$PROJECT --format="value(ipAddresses[0].ipAddress)"複製並保留新主要執行個體的私人 IP 位址。
透過 SSH 連線至堡壘 VM。
psql -h NEW_PRIMARY_PRIVATE_IP -U postgres將 NEW_PRIMARY_PRIVATE_IP 替換為您在上一個步驟中複製的新主要執行個體私人 IP 位址。
在新的主要執行個體上執行下列指令。
SELECT slot_name, slot_type, active, synced, active_pid, pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), confirmed_flush_lsn)) AS replication_lag FROM pg_replication_slots WHERE slot_type = 'logical';運算單元 (例如
my_subscription) 應為active = t。SELECT application_name, state FROM pg_stat_replication;pg_stat_replication應會顯示訂閱者已連線。
清除新副本上的孤立複製運算單元
切換和容錯移轉作業完成後,原始主要執行個體 ($PRIMARY_INSTANCE_NAME) 會變成副本。這個新的副本執行個體磁碟上,仍保留名為 my_subscription 的原始邏輯複製槽。這個 my_subscription 槽現在已孤立,因為訂閱者應透過私人服務存取寫入端點連線至新的主要執行個體 ($DR_REPLICA_NAME)。
Cloud SQL 不會自動從新的副本中移除這個孤立運算單元。這是因為 Cloud SQL 無法判斷訂閱者是否已設為使用執行個體的 IP 位址,而非私人服務存取權寫入端點。在手動變更訂閱項目之前,訂閱者可能仍會嘗試連線至新副本上的這個舊版位。如果自動捨棄版位,可能會破壞這類設定。
新副本 ($PRIMARY_INSTANCE_NAME) 上存在這個孤立運算單元,導致這個執行個體上的 slotsync worker 程序在記錄中產生錯誤。您可能會在新副本的 postgres.log 中看到類似下列的錯誤訊息。slotsync worker 會持續嘗試,因此這項錯誤會不斷重複。
ERROR: exiting from slot synchronization because same name slot "my_subscription" already exists on the standby
為避免這類錯誤,並讓 slotsync worker 在這個副本上正確建立新的同步 my_subscription 槽版本,您必須手動捨棄孤立槽。這樣一來,如果您日後打算切換回原先的執行個體,該執行個體就能妥善準備。
擷取新副本 (
$PRIMARY_INSTANCE_NAME) 的私人 IP 位址。gcloud sql instances describe $PRIMARY_INSTANCE_NAME \ --project=$PROJECT --format="value(ipAddresses[0].ipAddress)"複製並保留新副本的私人 IP 位址。
透過 SSH 連線至堡壘 VM。
gcloud compute ssh $BASTION_VM_NAME \ --zone=$VM_ZONE \ --project=$PROJECT從堡壘 VM 連線至新副本。
psql -h NEW_REPLICA_IP -U postgres將 NEW_REPLICA_IP 替換為您在本程序步驟 1 中複製的新副本 IP 位址。
系統提示輸入密碼時,請輸入變數
$POSTGRES_PASSWORD。在新的副本 (
$PRIMARY_INSTANCE_NAME) 中,捨棄孤立運算單元。SELECT slot_name, slot_type, temporary, failover, synced, active FROM pg_replication_slots WHERE slot_name = 'my_subscription';確認
synced = false和active = false存在,然後刪除。SELECT pg_drop_replication_slot('my_subscription');孤立的版位會遭到移除。
自動重新同步處理運算單元
孤立的運算單元遭到捨棄後,新副本 ($PRIMARY_INSTANCE_NAME) 上的 slotsync worker 會在下一個週期自動連線至新的主要執行個體 ($DR_REPLICA_NAME)。系統會建立新的本機 my_subscription 插槽,並與新主要插槽的有效插槽同步。
您可以在新副本的 postgres.log 中看到表示成功的訊息,類似下列內容:
LOG: newly created slot "my_subscription" is sync-ready now
新的同步運算單元具有 failover=true,最終會變成永久 (temporary=false),確保日後切換回來時,這個執行個體已準備就緒。
選用:執行切回
現在,請切換回來,再次將
$PRIMARY_INSTANCE_NAME設為主要執行個體。gcloud sql instances switchover $PRIMARY_INSTANCE_NAME \ --project=$PROJECT切換回主要執行個體後,請進行驗證。
查看訂閱者執行個體的狀態。
SELECT subname, pid IS NOT NULL AS is_active FROM pg_stat_subscription;訂閱方案應仍有效,即
is_active = t。查看新主要執行個體 (
$PRIMARY_INSTANCE_NAME) 的運算單元狀態。SELECT slot_name, active FROM pg_replication_slots WHERE slot_type = 'logical'; SELECT * FROM pg_stat_replication;時段應為有效,且訂閱者已連線。
疑難排解
| 問題 | 疑難排解 |
|---|---|
切換後,新副本 (即舊的主要執行個體) 發生錯誤:
|
請按照「清除新副本上的孤立複製槽」中的步驟操作。 |