您可以在資料庫執行個體的資訊清單檔案中定義讀取集區執行個體設定。每個讀取集區執行個體都需要建立專屬資訊清單檔案。您可以部署多個讀取集區執行個體,每個資料庫叢集最多可有 20 個讀取集區節點。
每個讀取集區執行個體占用的儲存空間,與其複製的執行個體相同。
建立非同步複製的讀取集區執行個體
如要建立 AlloyDB Omni 非同步複製讀取集區執行個體,請完成下列步驟:
建立資料庫執行個體資訊清單,定義讀取集區執行個體類型:
DBInstance: metadata: name: READ_POOL_INSTANCE_NAME spec: instanceType: ReadPool nodeCount: READ_POOL_NODE_COUNT readPoolPort: READ_POOL_PORT dbcParent: name: DB_CLUSTER_NAME更改下列內容:
READ_POOL_INSTANCE_NAME:這個資源的名稱,例如read-pool-instance-1。DB_CLUSTER_NAME:執行個體所屬資料庫叢集的名稱。READ_POOL_NODE_COUNT:(選用) 讀取集區執行個體中的節點數量。這會決定執行個體的整體運算能力。每個資料庫叢集最多可有 20 個讀取集區節點。READ_POOL_PORT:(選用) 負載平衡器 (VIP) 的通訊埠,用於將讀取流量轉送至這個讀取集區執行個體。預設為5434。
套用
DBInstance規格。alloydbctlalloydbctl apply -d "DEPLOYMENT_SPECIFICATION_PATH" -r "DBINSTANCE_SPECIFICATION"請替換下列變數:
DEPLOYMENT_SPECIFICATION_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。DBINSTANCE_SPECIFICATION:您在上一個步驟中建立的DBInstance資訊清單檔案路徑。
Ansible
ansible-playbook DBINSTANCE_PLAYBOOK -i "DEPLOYMENT_SPECIFICATION_PATH" \ -e resource_spec="DBINSTANCE_SPECIFICATION"請替換下列變數:
DBINSTANCE_PLAYBOOK:為DBInstance規格建立的應對手冊路徑。DEPLOYMENT_SPECIFICATION_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。DBINSTANCE_SPECIFICATION:您在上一個步驟中建立的DBInstance資訊清單檔案路徑。
驗證執行個體狀態
如要驗證讀取集區執行個體是否可用,請取得 DBInstance 資源的狀態:
alloydbctl
alloydbctl get -d "DEPLOYMENT_SPECIFICATION_PATH" -t DBInstance -n "READ_POOL_INSTANCE_NAME" -o yaml請替換下列變數:
DEPLOYMENT_SPECIFICATION_PATH:您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。READ_POOL_INSTANCE_NAME:您在資訊清單中指定的讀取集區執行個體名稱。
Ansible
執行 google.alloydbomni_orchestrator.status 應對手冊。詳情請參閱「取得叢集狀態」。
ansible-playbook STATUS_PLAYBOOK_PATH -i "DEPLOYMENT_SPECIFICATION_PATH" \
-e resource_type="DBInstance" -e resource_name="READ_POOL_INSTANCE_NAME"請替換下列變數:
STATUS_PLAYBOOK_PATH: 您建立的劇本路徑,用於取得叢集狀態。DEPLOYMENT_SPECIFICATION_PATH: 您在「安裝 AlloyDB Omni 元件」中建立的 Deployment 規格路徑。READ_POOL_INSTANCE_NAME: 您在資訊清單中指定的讀取集區執行個體名稱。
查看回應的 .status.conditions 部分,確認下列事項:
- 如果
Available條件的狀態為true,表示讀取集區執行個體可以處理查詢,但可能不會從資料庫執行個體複製資料。 - 如果
Streaming條件的狀態為true,表示讀取集區執行個體已連線至資料庫執行個體,並主動串流變更。
如果資料庫執行個體無法連線,讀取集區執行個體會繼續處理查詢。在這種情況下,可用性狀態會是 true,串流狀態則會是 false。
設定讀取集區執行個體後,主要資料庫執行個體中所有插入、更新和刪除的資料列,都可在讀取集區執行個體中讀取。
連線至讀取集區執行個體
讀取集區執行個體變更為 Available 後,負載平衡器會自動設定專屬的唯讀前端,將流量轉送至讀取集區節點。
如要查看連線端點,請檢查 DBInstance 狀態輸出內容中的 status.endpoints。唯讀端點 (例如 VIP_IP:5434) 會將傳入的唯讀查詢,分配給讀取集區中所有健康狀態良好的節點。
如要連線至讀取集區執行個體,請使用 psql 用戶端工具,並提供端點的 IP 位址和通訊埠:
psql -h VIP_IP -p READ_POOL_PORT -U postgres更改下列內容:
VIP_IP:唯讀端點的 IP 位址。READ_POOL_PORT:唯讀端點的通訊埠。
如果您嘗試對這個端點執行寫入作業,作業會立即失敗,並顯示錯誤訊息,指出您無法在唯讀交易中執行插入作業。
管理讀取集區執行個體
RPM 編排器支援動態調度,以及刪除讀取集區執行個體,且叢集完全不會停機。
調度讀取集區執行個體資源
如要新增或移除現有讀取集區的節點,請更新 DBInstance 資訊清單檔案中的 nodeCount 欄位。
開啟
DBInstance資訊清單檔案,並修改nodeCount值,以反映所選節點數量。使用偏好的部署方法、
alloydbctl apply指令或 Ansible 劇本,套用更新資訊清單。
RPM 編排器會自動佈建或移除讀取副本節點,負載平衡器則會動態更新,將流量導向集區中的可用節點。
刪除讀取集區執行個體
如要刪除讀取集區執行個體,請使用 alloydbctl delete 指令:
alloydbctl delete -t DBInstance -n READ_POOL_INSTANCE_NAME將 READ_POOL_INSTANCE_NAME 替換為要刪除的讀取集區執行個體名稱。
刪除讀取集區執行個體時,協調器會停止讀取副本服務並清除節點。負載平衡器會自動移除轉送,不會造成任何升級死結,也不會影響主要或待命執行個體的流量。