日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

ModifyDBClusterEndpoint - 修改PolarDB的集群地址屬性

修改PolarDB的集群地址屬性,包括讀寫模式、新節(jié)點是否自動加入本地址、一致性級別、事務(wù)拆分、主庫是否接受讀、連接池等。

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權(quán)信息

當前API暫無授權(quán)信息透出。

請求參數(shù)

名稱類型必填描述示例值
DBClusterIdstring

集群 ID。

pc-*************
DBEndpointIdstring

集群地址 ID。

pe-**************
Nodesstring

加入目標地址的讀負載節(jié)點,多個節(jié)點間用英文逗號(,)分隔。 默認為原有節(jié)點。

說明
  • PolarDB MySQL 版需要傳入節(jié)點 ID。
  • PolarDB PostgreSQL 版和 PolarDB PostgreSQL 版(兼容 Oracle)需要傳入節(jié)點角色名稱,例如Writer,Reader1,Reader2
  • ReadWriteMode 取值為 ReadOnly 時,支持只掛載一個節(jié)點。但當此節(jié)點故障時,該地址可能會有最多 1 小時的不可用,請勿用于生產(chǎn)環(huán)境。因此,推薦至少選擇 2 個節(jié)點,以提升可用性。
  • ReadWriteMode 取值為 ReadWrite 時,至少要選擇 2 個節(jié)點。 * PolarDB MySQL 版支持選擇任意兩個節(jié)點。當兩個節(jié)點都是只讀節(jié)點時,寫請求都會發(fā)往主節(jié)點。 * PolarDB PostgreSQL 版和 PolarDB PostgreSQL 版(兼容 Oracle)必須包含主節(jié)點。
  • pi-**************,pi-*************
    ReadWriteModestring

    讀寫模式,取值范圍如下:

    • ReadWrite:可讀可寫(自動讀寫分離)
    • ReadOnly:只讀
    ReadWrite
    AutoAddNewNodesstring

    新節(jié)點是否自動加入本地址,取值范圍如下:

    • Enable:是
    • Disable:否(默認值)
    Enable
    EndpointConfigstring

    集群地址的高級配置,格式為 JSON,目前支持設(shè)置一致性級別、事務(wù)拆分、主庫是否接受讀和連接池等。

    • 設(shè)置負載均衡策略,格式為{\"LoadBalancePolicy\":\"負載均衡策略\"}。取值范圍如下:

      • 0:基于連接數(shù)負載均衡(默認)
      • 1:基于活躍請求數(shù)負載均衡
    • 設(shè)置主庫是否接受讀,格式為{\"MasterAcceptReads\":\"主庫是否接受讀\"}。取值范圍如下:

      • on:表示主庫接受讀(默認)
      • off:表示主庫不接受讀
    • 設(shè)置事務(wù)拆分,格式為{\"DistributedTransaction\":\"事務(wù)拆分\"}。取值范圍如下:

      • on:開啟事務(wù)拆分(默認)
      • off:關(guān)閉事務(wù)拆分
    • 設(shè)置一致性級別,格式為{\"ConsistLevel\":\"一致性級別\"}。取值范圍如下:

      • 0:最終一致性(弱)
      • 1:會話一致性(中)(默認)
      • 2:全局一致性(強)
    • 設(shè)置全局一致性讀超時時間,格式為{\"ConsistTimeout\":\"全局一致性讀超時時間\"}。取值范圍:0~60000。默認值為 20。單位為 ms。

    • 設(shè)置會話一致性讀超時時間,格式為{\"ConsistSessionTimeout\":\"會話一致性讀超時時間\"}。取值范圍:0~60000。默認值為 0。單位為 ms。

    • 設(shè)置全局(或會話)一致性讀超時策略,格式為{\"ConsistTimeoutAction\":\"全局一致性讀超時策略\"}。取值范圍如下:

      • 0:將讀請求發(fā)往主節(jié)點(默認)。
      • 1:代理返回一個錯誤報文 wait replication complete timeout, please retry 給應(yīng)用端。
    • 設(shè)置連接池,格式為{\"ConnectionPersist\":\"連接池\"}。取值范圍如下:

      • off:關(guān)閉連接池(默認)
      • Session:開啟會話級連接池
      • Transaction:開啟事務(wù)級連接池
    • 設(shè)置并行查詢,格式為{\"MaxParallelDegree\":\"并行查詢\"}。取值范圍如下:

      • on:開啟并行查詢
      • off:關(guān)閉并行查詢(默認)
    • 設(shè)置行存/列存自動引流,格式為{\"EnableHtapImci\":\"行存/列存自動引流\"}。取值范圍如下:

      • on:開啟行存/列存自動引流功能
      • off:關(guān)閉行存/列存自動引流功能(默認)
    • 設(shè)置是否開啟過載保護,格式為{\"EnableOverloadThrottle\":\"是否開啟過載保護\"}。取值范圍如下:

      • on:開啟過載保護
      • off:關(guān)閉過載保護(默認)
    說明
  • 僅當 PolarDB MySQL 版集群地址的讀寫模式為**可讀可寫(自動讀寫分離)**時,支持設(shè)置事務(wù)拆分、主庫是否接受讀、連接池和是否開啟過載保護。
  • 當 PolarDB MySQL 版集群地址的讀寫模式為只讀時,支持基于連接數(shù)負載均衡基于活躍請求數(shù)負載均衡兩種負載均衡策略; 可讀可寫(自動讀寫分離)模式的集群地址僅支持基于活躍請求數(shù)負載均衡策略。
  • 當 PolarDB MySQL 版集群地址的讀寫模式為可讀可寫(自動讀寫分離),或集群地址的讀寫模式為只讀且負載均衡策略為基于活躍請求數(shù)負載均衡時,支持設(shè)置行存/列存自動引流。
  • 僅 PolarDB MySQL 版支持一致性級別設(shè)置為全局一致性。
  • 如果參數(shù) ReadWriteMode 取值為 ReadOnly,一致性級別取值只能為 0
  • 您可以同時設(shè)置一致性級別、事務(wù)拆分、主庫是否接受讀和連接池,例如{\"ConsistLevel\":\"1\",\"DistributedTransaction\":\"on\",\"ConnectionPersist\":\"Session\",\"MasterAcceptReads\":\"on\"}
  • 事務(wù)拆分的設(shè)置受一致性級別設(shè)置的約束。例如一致性級別取值為 0 時,不支持開啟事務(wù)拆分;一致性級別取值為 12 時,支持開啟事務(wù)拆分。
  • {"ConsistLevel":"1","DistributedTransaction":"on","MasterAcceptReads":"off","ConnectionPersist": "on"}
    DBEndpointDescriptionstring

    地址名稱。

    test
    SccModestring

    節(jié)點是否開啟全局一致性(高性能模式)功能。取值范圍如下:

    • ON:開啟

    • OFF:關(guān)閉

    枚舉值:
    • on
    • off
    on
    PolarSccWaitTimeoutstring

    全局一致性超時時間

    100
    PolarSccTimeoutActionstring

    全局一致性超時策略。取值范圍如下:

    • 0:發(fā)送該請求到主節(jié)點

    • 2:超時降級,當全局一致性讀超時后,本次查詢操作會自動降級為非一致性讀取,且客戶端不會收到報錯信息

    0

    返回參數(shù)

    名稱類型描述示例值
    object
    RequestIdstring

    請求 ID。

    CD3FA5F3-FAF3-44CA-AFFF-BAF869******

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "CD3FA5F3-FAF3-44CA-AFFF-BAF869******"
    }

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400InvalidEndpointConfig.MalformedThe specified parameter EndpointConfig is not valid.指定的參數(shù)EndpointConfig無效
    400InvalidDBEndpointId.MalformedThe specified parameter DBEndpointId is not valid.指定的參數(shù)DBEndpointId無效
    400InvalidNodes.MalformedThe specified parameter Nodes is not valid.指定的參數(shù)Nodes無效。
    404InvalidDBCluster.NotFoundThe DBClusterId provided does not exist in our records.當前的記錄中不存在提供的DBClusterId。
    404EndpointStatus.NotSupportCurrent endpoint status does not support this operation.當前節(jié)點狀態(tài)不支持此操作
    404InvalidDBClusterId.MalformedThe specified parameter DBClusterId is not valid.指定的參數(shù)DBClusterId無效
    404InvalidDBClusterId.NotFoundThe DBInstanceId provided does not exist in our records.當前的記錄中不存在提供的DBClusterId。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內(nèi)容概要操作
    2024-07-30OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更查看變更詳情
    2023-09-12OpenAPI 錯誤碼發(fā)生變更查看變更詳情