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

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

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

調試

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

授權信息

當前API暫無授權信息透出。

請求參數

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

集群 ID。

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

集群地址 ID。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    地址名稱。

    test
    SccModestring

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

    • ON:開啟

    • OFF:關閉

    枚舉值:
    • on
    • off
    on
    PolarSccWaitTimeoutstring

    全局一致性超時時間

    100
    PolarSccTimeoutActionstring

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

    • 0:發送該請求到主節點

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

    0

    返回參數

    名稱類型描述示例值
    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.指定的參數EndpointConfig無效
    400InvalidDBEndpointId.MalformedThe specified parameter DBEndpointId is not valid.指定的參數DBEndpointId無效
    400InvalidNodes.MalformedThe specified parameter Nodes is not valid.指定的參數Nodes無效。
    404InvalidDBCluster.NotFoundThe DBClusterId provided does not exist in our records.當前的記錄中不存在提供的DBClusterId。
    404EndpointStatus.NotSupportCurrent endpoint status does not support this operation.當前節點狀態不支持此操作
    404InvalidDBClusterId.MalformedThe specified parameter DBClusterId is not valid.指定的參數DBClusterId無效
    404InvalidDBClusterId.NotFoundThe DBInstanceId provided does not exist in our records.當前的記錄中不存在提供的DBClusterId。

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

    變更歷史

    變更時間變更內容概要操作
    2024-07-30OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情
    2023-09-12OpenAPI 錯誤碼發生變更查看變更詳情