請確認 AlloyDB Omni 主要資料庫叢集已啟用外部連線。如果未啟用外部連線能力，請在資料庫叢集資訊清單的 spec 區段中新增下列內容：
... spec: ... allowExternalIncomingTraffic: true
如要搭配已啟用高可用性 (HA) 的主要資料庫叢集使用跨資料中心複製功能，請確認主要資料庫叢集已啟用
replayReplicationSlotsOnStandbys欄位：... spec: ... availability: ... replayReplicationSlotsOnStandbys: true
啟用這個欄位，並按照下一個步驟說明設定
logReplicationSlots，即可將次要資料庫叢集使用的複製槽，同步至所有高可用性待命執行個體。這項設定可協助新的高可用性主要執行個體，在容錯移轉或切換後，保留次要資料庫叢集尚未使用的預寫記錄 (WAL) 檔案，以便順利繼續複製作業。如要為主要資料庫叢集啟用複製功能，請將類似下列的資訊清單套用至主要資料中心的 Kubernetes 叢集：
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-DB_CLUSTER_NAME namespace: DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: REPLICATION_NAME namespace: DB_CLUSTER_NAMESPACE spec: dbcluster: name: DB_CLUSTER_NAME upstream: password: name: ha-rep-pw-DB_CLUSTER_NAME logReplicationSlot: true
更改下列內容：
DB_CLUSTER_NAME：資料庫叢集的名稱，例如dbc-1。ENCODED_PASSWORD：資料庫使用者的密碼，用於從次要資料庫複製資料，編碼為 base64 字串，例如Q2hhbmdlTWUxMjM= for ChangeMe123。預設值為alloydbreplica。REPLICATION_NAME：複製作業的名稱，例如replication-1。LOG_REPLICATION_SLOT：：將複製運算單元資料記錄到 WAL 檔案。如要啟用這個選項，請將值設為true。預設值為false。
建議您為已啟用高可用性 (HA) 的主要資料庫叢集啟用
logReplicationSlot選項，確保容錯移轉或切換後，複製作業仍可繼續運作。等待複製狀態變更為「就緒」。
如要取得用於在次要資料庫叢集設定複製作業的上游連線資訊，請執行下列指令：
kubectl get replication REPLICATION_NAME kubectl get replication REPLICATION_NAME -o json | jq .status.upstream
輸出內容大致如下：
{ "host": "35.230.32.36", "password": { "name": "ha-rep-pw-dbc-1" }, "port": 5432, "replicationSlotName": "dbc_1_replication_1", "username": "alloydbreplica" }- 請記下輸出內容，因為在下一個步驟中，您需要使用這項資訊，在次要資料庫叢集啟用複製功能。
- 在次要資料中心的 Kubernetes 叢集上建立 AlloyDB Omni 叢集，設定與主要資料庫叢集相同。
- 確保 AlloyDB Omni 次要資料庫叢集已啟用外部連線能力
如果未啟用外部連線能力，請在資訊清單的 spec 部分加入以下內容：
... spec: ... allowExternalIncomingTraffic: true
- 如要為次要資料庫叢集啟用複製功能，請將類似下列的資訊清單套用至次要資料中心的 Kubernetes 叢集：
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME downstream: host: PRIMARY_HOST port: PRIMARY_PORT username: alloydbreplica password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME replicationSlotName: PRIMARY_REPLICATION_SLOT control: setup
更改下列內容：
SECONDARY_DB_CLUSTER_NAME：次要資料庫叢集的名稱，例如dbc-2。ENCODED_PASSWORD：用於複製主要資料庫叢集的資料庫使用者密碼，以 Base64 字串編碼，例如Q2hhbmdlTWUxMjM= for ChangeMe123。預設值為alloydbreplica。SECONDARY_REPLICATION_NAME：複製作業的名稱，例如 `replication-2`。PRIMARY_HOST：步驟 3 輸出內容中主要資料庫叢集的連線端點，次要資料庫可存取該端點進行複製。PRIMARY_PORT：主要資料庫叢集的連線通訊埠 (來自步驟 3 的輸出內容)，次要資料庫可透過這個通訊埠存取主要資料庫，以便複製資料。PRIMARY_REPLICATION_SLOT：步驟 3 輸出內容中，主要資料庫叢集上的複製槽名稱，次要資料庫可使用這個槽進行複製。
查看次要資料庫叢集的複製作業
如要查看 AlloyDB Omni 次要資料庫叢集的詳細資訊和複製狀態，請執行下列指令：
kubectl get dbcluster SECONDARY_DB_CLUSTER_NAME kubectl get replication SECONDARY_REPLICATION_NAME
次要資料庫叢集設定成功，且從主要資料庫叢集串流複製資料時，複製狀態會顯示為「就緒」和「健康狀態良好」。
升級次要資料庫叢集
推送次要資料庫叢集前，請按照下列步驟操作，確認次要資料庫叢集已套用主要資料庫叢集提供的所有交易：
檢查次要資料庫叢集的複製狀態，確認其已就緒且健康狀態良好。
kubectl get replication SECONDARY_REPLICATION_NAME
停止所有寫入主要資料庫叢集的作業。在主要資料庫叢集執行下列查詢，檢查次要資料庫的複製延遲時間。確認結果顯示的延遲時間極短。
理想的延遲值為 0。如果延遲時間大於 0，您仍可升級次要資料庫叢集，但可能會遺失主要資料庫叢集上最近提交的部分交易。
psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
如要將次要資料庫叢集升級為主要資料庫叢集，請將次要資料庫叢集複製資訊清單的 control 欄位更新為 promote，並在次要資料中心的 Kubernetes 叢集上套用該資訊清單。
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME downstream: host: PRIMARY_HOST port: PRIMARY_PORT username: alloydbreplica password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME replicationSlotName: PRIMARY_REPLICATION_SLOT control: promote
執行切換
執行切換作業前，請確認兩個資料中心的主要和次要資料庫叢集都已上線，且資料庫叢集處於健康狀態。
為確保切換期間主要和次要資料庫叢集的資料一致，請按照下列步驟操作，確認次要資料庫叢集已套用從主要資料庫叢集收到的所有交易：
檢查次要資料庫叢集的複製狀態，確認其已就緒且健康狀態良好。
kubectl get replication SECONDARY_REPLICATION_NAME
停止所有寫入主要資料庫叢集的作業。在主要資料庫叢集執行下列查詢，檢查次要資料庫的複製延遲時間。確認結果顯示的延遲值為
0。psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
如要執行切換，請完成下列步驟：
-
如要將 AlloyDB Omni 次要資料庫叢集轉換為主要資料庫叢集，請在次要資料中心的 Kubernetes 叢集上更新複製資訊清單，如下所示：
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME upstream: password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
等待複製狀態變更為「就緒」。
如要取得複製作業的上游連線資訊，請執行下列指令：
kubectl get replication SECONDARY_REPLICATION_NAME kubectl get replication SECONDARY_REPLICATION_NAME -o json | jq .status.upstream
輸出內容大致如下：
{ "host": "34.23.207.137", "password": { "name": "ha-rep-pw-dbc-2" }, "port": 5432, "replicationSlotName": "dbc_2_replication_2", "username": "alloydbreplica" }-
如要將 AlloyDB Omni 主要資料庫叢集轉換為次要資料庫叢集，請在主要資料中心的 Kubernetes 叢集上更新複製資訊清單，如下所示：
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-DB_CLUSTER_NAME type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: REPLICATION_NAME spec: dbcluster: name: DB_CLUSTER_NAME downstream: host: SECONDARY_HOST port: SECONDARY_PORT username: alloydbreplica password: name: ha-rep-pw-DB_CLUSTER_NAME replicationSlotName: SECONDARY_REPLICATION_SLOT control: rewind
等待複製狀態變為就緒且健康狀態良好。
如要驗證複製狀態，請使用：
kubectl get replication REPLICATION_NAME