全部產品
Search
文件中心

PolarDB:設定資料庫代理

更新時間:Jan 07, 2026

本文介紹如何通過PolarDB的叢集地址來設定資料庫代理。

前提條件

產品系列需為PolarDB MySQL版叢集版。更多關於產品系列的介紹,請參見企業版產品系列

注意事項

PolarDB MySQL版8.0版本的叢集在設定資料庫代理時支援開啟並行查詢和設定並行度。

操作步驟

  1. 登入PolarDB控制台,在左側導覽列單擊叢集列表,選擇叢集所在地區,並單擊目的地組群ID進入叢集詳情頁。

  2. 在叢集基本信息頁的資料庫連接地區,找到目的地組群地址,單擊目的地組群位址名稱右側的配置

    7.png

  3. 在彈出的對話方塊內,根據業務需要修改叢集地址的配置。具體配置項如下表所示:

    表 1. 配置表

    配置項

    說明

    网络信息

    PolarDB為每個叢集地址預設提供了私網串連地址,若需要修改該地址或申請公網串連地址請參見管理串連地址

    集群设置

    读写模式

    叢集地址的讀寫入模式,可選模式為只读可读可写(自动读写分离)

    說明

    建立自訂地址後還可以修改讀寫入模式。修改讀寫入模式後,只對建立串連生效,已有的串連保持原來的模式。

    地址名称

    輸入集群地址的名稱。

    服务节点

    可选节点已选节点

    從左側可选节点框內(包括主節點和所有隻讀節點),選中想要加入叢集地址用於處理讀請求的節點,單擊1表徵圖,將其移動到右側已选节点框中。

    說明

    節點的選擇不影響讀寫入模式:

    • 讀寫入模式為可读可写(自动读写分离)時,無論已选节点是否選中主節點,寫請求都只會發往主節點。

    • 讀寫入模式為只读時,所有讀請求按照負載平衡的方式轉寄到各唯讀節點,不會轉寄到主節點。即使主節點已被添加在已选节点中,也不會生效。

    • 讀寫入模式為可读可写(自动读写分离)時,因多主叢集(Limitless)是基於庫表路由機制,需將目標庫表對應的主節點加入讀寫地址,或選中所有主節點。請在節點選擇前充分評估路由影響。

    新节点自动加入

    新增的節點是否要自動添加到該地址中。

    负载均衡设置

    负载均衡策略

    讀寫分離時,在多個節點間用於處理讀請求的調度策略。可選策略為基于连接数负载均衡基于活跃请求数负载均衡。關於負載平衡策略的更多介紹請參見負載平衡策略

    主库是否接受读

    • 選擇,查詢SQL將僅發送到唯讀節點,來降低主節點的負載,確保主節點穩定。

    • 選擇,查詢SQL可以發送到主節點和唯讀節點。

    關於主庫是否接受讀的更多介紹請參見主庫是否接受讀

    說明

    可读可写(自动读写分离)模式下支援該配置。

    事务拆分

    開啟或關閉事務拆分。關於事務拆分的更多介紹請參見事務拆分

    說明

    可读可写(自动读写分离)模式下支援該配置。

    按需建聯

    開啟或關閉按需建聯功能。關於按需建聯的更多介紹請參見按需建連

    說明

    負載平衡策略基于活跃请求数负载均衡時支援該配置。

    一致性设置

    一致性级别

    • 讀寫入模式為可读可写(自动读写分离)時,可選一致性層級有最终一致性(弱)会话一致性(中)全局一致性(强),詳情請參見一致性層級

    • 讀寫入模式為只读時,預設一致性層級為最终一致性(弱)且不可更改。

    重要
    • 一致性層級修改後對所有串連立即生效。

    • 全域一致性(高效能模式)需要在叢集中所有地址同時生效,如果要選擇非全域一致性(高效能模式),則叢集其他所有地址都會回退至開啟全域一致性(高效能模式)之前的一致性狀態。

    全局一致性读超时时间

    等待唯讀節點同步到最新資料的逾時時間。取值範圍:0~60000。預設值為20。單位為ms。

    說明

    僅當一致性级别全域一致性(強)全域一致性模式傳統模式時支援該配置。

    全局一致性读超时策略

    在唯讀節點等待逾時後PolarDB的預設策略,取值範圍如下:

    • 0,发送该请求到主节点(默认值)

    • 1,SQL报错(wait replication complete timeout, please retry)

    說明

    僅當一致性级别全域一致性(強)全域一致性模式傳統模式時支援該配置。

    全域一致性讀逾時時間(高效能模式)

    等待唯讀節點同步到最新資料的逾時時間。取值範圍:1~1000000。預設值為100。單位為ms。

    重要
    • 全域一致性(高效能模式)需要在叢集中所有地址同時生效,如果在某個地址開啟全域一致性(高效能模式),則叢集其他所有地址都會開啟全域一致性(高效能模式)。

    • 僅當一致性级别全域一致性(強)全域一致性模式高效能模式時支援該配置。

    全域一致性讀逾時策略(高效能模式)

    在唯讀節點等待逾時後PolarDB的預設策略,取值範圍如下:

    • 0,發送該請求到主節點(預設值)

    • 1,逾時報錯,用戶端返回錯誤提示資訊

    • 2,逾時降級,當全域一致性讀逾時後,本次查詢操作會自動降級為非一致性讀取,且用戶端不會收到報錯資訊

    說明

    僅當一致性级别全域一致性(強)全域一致性模式高效能模式時支援該配置。

    會話一致性讀逾時時間

    等待唯讀節點同步到最新資料的逾時時間。取值範圍:0~60000。預設值為0。單位為ms。

    重要
    • 僅當一致性層級會話一致性(中)時支援該配置。

    • 全域一致性(高效能模式)需要在叢集中所有地址同時生效,如果要選擇非全域一致性(高效能模式),則叢集其他所有地址都會回退至開啟全域一致性(高效能模式)之前的一致性狀態。

    會話一致性讀逾時策略

    在唯讀節點等待逾時後PolarDB的預設策略,取值範圍如下:

    • 0,發送該請求到主節點(預設值)

    • 1,SQL報錯(wait replication complete timeout, please retry)

    說明

    僅當一致性層級會話一致性(中)時支援該配置。

    连接池设置

    连接池

    您可以選擇关闭(預設)、會話級事務級。關於串連池的更多介紹請參見串連池

    說明
    • 僅當讀寫入模式為可读可写(自动读写分离)時支援該配置。

    • 串連池的配置修改僅對建立立的串連生效。通常情況下,為了使修改生效,需要重啟應用程式或重建與資料庫的串連。

    HTAP最佳化

    并行查询

    開啟或關閉並行查詢功能,並設定並行度。

    開啟彈性並行查詢(ePQ)能夠有效利用多核CPU(叢集內空閑計算資源)的平行處理能力,對複雜查詢進行加速,詳情請參見彈性並行查詢

    說明

    自2023年4月1日起,叢集滿足以下條件時會預設開啟彈性並行查詢,且預設的並行度為2:

    • 新建立的叢集:叢集的CPU核心數大於等於8。

    • 存量叢集:在存量叢集中建立自訂叢集地址,且叢集的CPU核心數大於等於8。

    行存/列存自动引流

    開啟或關閉行存和列存自動引流功能。詳情請參見配置行列自動分流

    說明

    PolarDB MySQL版8.0.1版本且核心小版本需為8.0.1.1.22及以上的叢集地址在可读可写(自动读写分离)模式下,且服务节点已选节点中包含了至少一個唯讀列存節點時,才支援該配置。

    列存節點接受OLTP請求

    開啟或關閉列存節點接受OLTP請求的能力。

    開啟列存節點接受OLTP請求的能力後,列存節點將同時接受OLAP和OLTP請求,資料庫代理會根據活躍請求數,將OLTP類讀請求路由至列存節點,這可能會導致列存節點的負載上升。

    說明

    僅當行存/列存自动引流為開啟狀態時支援該配置。

    安全防護

    過載保護

    開啟或關閉過載保護功能。詳情請參見過載保護

  4. 單擊确定即可。

相關API

API

描述

查詢PolarDB叢集的地址資訊

查詢叢集地址。

修改PolarDB的叢集地址屬性

修改叢集地址。

釋放PolarDB自訂叢集地址

釋放自訂叢集地址。