全部產品
Search

搜尋本產品

    ApsaraDB for MongoDB：複本集執行個體串連說明

    文件中心

    ApsaraDB for MongoDB：複本集執行個體串連說明

    更新時間：Aug 15, 2024

    ApsaraDB for MongoDB複本集執行個體提供了主從節點和唯讀節點的單獨串連地址，以及用於應用程式串連的高可用ConnectionStringURI和ReadOnly ConnectionstringURI地址。本文介紹複本集執行個體串連地址的擷取方式及串連說明。

    擷取資料庫連接地址

    1. 訪問MongoDB複本集執行個體列表，在上方選擇資源群組和地區，然後單擊目標執行個體ID。

    2. 在目標執行個體頁面的左側導覽列，單擊資料庫連接。

    串連地址說明

    串連地址網路類型

    網路類型

    說明

    私網

    • 專用網路：專用網路是一種隔離的網路環境，安全性和效能均高於傳統的傳統網路。 ApsaraDB for MongoDB執行個體預設提供專用網路串連地址，通過專用網路串連ApsaraDB for MongoDB執行個體可以擷取更高的安全性和效能。

    • 傳統網路：雲端服務在網路上不進行隔離，僅依靠雲端服務自身的安全性群組或白名單策略阻擋非法訪問。新購執行個體不再支援傳統網路，更多說明，請參見【通知】ApsaraDB for MongoDB新購買執行個體不再支援傳統網路。

    公網

    由於通過公網串連執行個體存在一定的安全風險，ApsaraDB for MongoDB執行個體預設未提供公網串連地址。如果您需要通過公網串連ApsaraDB for MongoDB執行個體，可以手動申請公網串連地址，申請方法請參見（可選）申請公網串連地址。

    串連地址類型

    地址類型

    說明

    Primary地址

    主節點的串連地址，串連該地址可以執行資料庫的讀寫操作。

    重要

    不建議在生產環境的應用程式通過該地址串連執行個體，當主節點出現故障時，會發生主備切換，主節點地址會發生變化，您需要串連新的主節點確保讀寫操作不受影響。

    Secondary地址

    從節點的串連地址，串連該地址僅能執行資料庫的讀操作。

    Readonly地址

    唯讀節點的串連地址，串連該地址僅能執行資料庫的讀操作。

    說明

    該地址僅在執行個體中存在唯讀節點時顯示。

    ConnectionstringURI地址

    ConnectionStringURI地址為執行個體的高可用地址，實現負載平衡及高可用，串連該地址可以執行資料庫的讀寫操作。該地址包含執行個體所有節點的地址，建議生產環境的應用程式通過該地址串連執行個體。

    重要

    生產環境的應用程式建議通過ConnectionStringURI地址串連執行個體，可以確保串連的節點始終為主節點，不會因為主備切換而影響應用的讀寫操作。

    ReadOnly ConnectionstringURI地址

    ReadOnly ConnectionStringURI地址只包含執行個體所有隻讀節點的地址，在具有多個唯讀節點的情況下，建議讀操作多的應用程式通過該地址串連執行個體。

    說明

    • 只有執行個體中已存在唯讀節點時，您才可以看到ReadOnly ConnectionStringURI地址。

    • 通過ReadOnly ConnectionStringURI地址串連執行個體，會將讀請求發送到唯讀節點。

    • 當執行個體中的某個唯讀節點出現故障時，讀請求會自動切換到下一個唯讀節點，不會影響應用的讀操作。如果所有的唯讀節點都出現了故障，繼續使用該串連地址將會出現串連異常。

    各串連地址的格式、參數說明以及樣本如下：

    Primary地址

    格式：

    <host>:<port>

    參數說明：

    參數

    說明

    <host>

    主節點的網域名稱資訊。

    <port>

    主節點的連接埠。

    樣本：

    dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717

    Secondary地址

    格式：

    <host>:<port>

    參數說明：

    參數

    說明

    <host>

    從節點的網域名稱資訊。

    <port>

    從節點的連接埠。

    樣本：

    dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717

    Readonly地址

    格式：

    <host>:<port>

    參數說明：

    參數

    說明

    <host>

    唯讀節點的網域名稱資訊。

    <port>

    唯讀節點的連接埠。

    樣本：

    dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717

    ConnectionstringURI地址

    格式：

    mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>?replicaSet=<replicaSet_value>[&authSource=<authenticationDatabase>]

    參數說明：

    參數

    說明

    <username>

    資料庫帳號的名稱，預設為root。

    <password>

    資料庫帳號的密碼。

    <host>

    主節點、從節點和唯讀節點的網域名稱資訊。

    <port>

    主節點、從節點和唯讀節點的連接埠。

    <database>

    要訪問的資料庫名稱，預設為admin。

    replicaSet=<replicaSet_value>

    該參數可以將讀請求發送到複本集執行個體的所有節點。<replicaSet_value>為執行個體高可用串連地址的唯一標識ID。

    authSource=<authenticationDatabase>（可選）

    該參數用於指定資料庫帳號所屬的資料庫。<authenticationDatabase>為鑒權資料庫名稱。如果不配置該參數，<database>會作為鑒權資料庫。

    readPreference=[primary|primaryPreferred|secondary | secondaryPreferred]（可選）

    該參數可以實現讀寫分離和負載平衡，能夠將寫請求發送到主節點，讀請求隨機發送到從節點和唯讀節點，取值說明如下：

    • readPreference=primary：讀請求僅發送到主節點。

    • readPreference=primaryPreferred：讀請求優先發送到主節點。

    • readPreference=secondary：讀請求僅發送到從節點和唯讀節點。如果從節點和唯讀節點都出現故障，讀請求失敗，不會發送到主節點。

    • readPreference=secondaryPreferred：讀請求優先發送到從節點和唯讀節點。如果從節點和唯讀節點都出現故障，該參數將讀請求發送到主節點。

    readPreferenceTags=<readonly_Tags>（可選）

    該參數可以將讀請求優先發送到標籤對應的節點。<readonly_Tags>為唯讀節點的標籤索引值對列表，支援role:electable role:readonly 兩種類型，說明如下：

    • readPreferenceTags=role:electable：優先讀從節點。

      說明

      該選項僅對雲端硬碟版執行個體生效。

    • readPreferenceTags=role:readonly：優先讀唯讀節點。

    雲端硬碟版執行個體可以靈活使用readPreference和readPreferenceTags參數，通過不同標籤的組合，實現不同的情境需求：

    讀請求失敗的處理方法

    讀請求發送的節點

    參數組合方案

    讀請求失敗情況下，讀請求發送到主節點

    優先讀主節點

    readPreference=primaryPreferred

    優先讀從節點和唯讀節點

    readPreference=secondaryPreferred

    優先讀從節點

    readPreference=secondaryPreferred&readPreferenceTags=role:electable

    優先讀唯讀節點

    readPreference=secondaryPreferred&readPreferenceTags=role:readonly

    讀請求失敗情況下，讀請求不發送到主節點

    僅讀從節點和唯讀節點

    readPreference=secondary

    僅讀從節點

    readPreference=secondary&readPreferenceTags=role:electable

    僅讀唯讀節點

    readPreference=secondary&readPreferenceTags=role:readonly

    樣本：

    mongodb://root:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-6108****

    ReadOnly ConnectionstringURI地址

    格式：

    mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>?readPreference=secondary&readPreferenceTags=role:readonly&replicaSet=<replicaSet_value>[&authSource=<authenticationDatabase>]

    參數說明：

    參數

    說明

    <username>

    資料庫帳號的名稱，預設為root。

    <password>

    資料庫帳號的密碼。

    <host>

    唯讀節點的網域名稱資訊。

    <port>

    唯讀節點的連接埠。

    <database>

    要訪問的資料庫名稱，預設為admin。

    readPreference=secondary&readPreferenceTags=role:readonly

    該參數可以將讀請求發送到唯讀節點。readPreferenceTags表示唯讀節點的標籤索引值對列表，固定取值為role:readonly。該參數不允許修改。

    replicaSet=<replicaSet_value>

    該參數可以將讀請求發送到複本集執行個體的所有節點。<replicaSet_value>為執行個體高可用串連地址的唯一標識ID。

    authSource=<authenticationDatabase>（可選）

    該參數用於指定資料庫帳號所屬的資料庫。<authenticationDatabase>為鑒權資料庫名稱。如果不配置該參數，<database>會作為鑒權資料庫。

    樣本：

    mongodb://root:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?readPreference=secondary&readPreferenceTags=role:readonly&replicaSet=mgset-6108****

    登入MongoDB資料庫

    1. 擷取如下資訊：

      • 資料庫連接地址，擷取方法請參見資料庫連接地址。

      • 資料庫帳號，初始帳號為root。

        說明

        不建議在生產環境中直接使用root帳號串連資料庫。您可以建立使用者並分配許可權，詳情請參見使用DMS管理MongoDB執行個體的帳號。

      • 資料庫帳號對應密碼。如果沒有設定或忘記密碼，您可以設定或修改密碼，具體方法請參見（可選）重設密碼。

      • 要訪問的資料庫。當資料庫帳號為root時，對應的資料庫為admin。

    2. 登入資料庫。您可以選擇以下任意一種方法登入：

    常見的串連情境

    相關問題