如何擷取ApsaraDB for MongoDB複本集執行個體串連地址 - ApsaraDB for MongoDB

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

串連地址說明

如何選擇串連地址

生產環境下，建議通過ConnectionStringURI地址串連執行個體以實現負載平衡和高可用。在具有隻讀節點的情況下，建議僅有讀操作的應用程式通過ReadOnly ConnectionStringURI地址串連執行個體。由於主備切換可能導致節點角色變化，不建議通過單節點串連地址串連執行個體。

串連地址類型

地址類型	說明
ConnectionStringURI地址	ConnectionStringURI地址是實現負載平衡及高可用的地址，該地址包含執行個體所有節點的地址，串連該地址可以執行資料庫的讀寫操作。重要生產環境的應用程式建議通過ConnectionStringURI地址串連執行個體，不會因為主備切換而影響應用的讀寫操作。未設定readPreference和readPreferenceTags參數時，會將讀請求發送到主節點。
ConnectionstringURI SRV地址	SRV地址可以簡化叢集的維護和管理，您無需因為增刪節點而修改串連地址，用戶端可以無感知地與叢集互動，簡化了應用程式的設計和維護。推薦生產環境的應用程式通過ConnectionStringURI串連資料庫，用戶端自動將請求發送到執行個體的多個節點上，實現負載平衡。當某個節點出現故障時，用戶端能自動進行故障切換，將請求發送到狀態正常的節點上。重要預設情況下控制台不顯示SRV地址，如需使用請單擊資料庫連接頁面的申請私網SRV地址或申請公網SRV地址。申請公網SRV地址前，您需要先開通執行個體的公網地址。 SRV地址僅支援雲端硬碟版執行個體。
ReadOnly ConnectionStringURI地址	ReadOnly ConnectionStringURI地址只包含執行個體所有隻讀節點的地址，串連該地址會將讀請求發送到唯讀節點。說明在具有隻讀節點的情況下，建議僅有讀操作的應用程式通過該地址串連執行個體。只有執行個體中已存在唯讀節點時，您才可以看到ReadOnly ConnectionStringURI地址。當執行個體中的某個唯讀節點出現故障時，讀請求會自動切換到下一個唯讀節點，不會影響應用的讀操作。如果所有的唯讀節點都出現了故障，繼續使用該串連地址將會出現串連異常。
Primary地址	主節點的串連地址，串連該地址可以執行資料庫的讀寫操作。重要不建議在生產環境的應用程式通過該地址串連執行個體。當執行個體觸發主備切換後，主節點地址會發生變化，您需要串連新的主節點確保讀寫操作不受影響。
Secondary地址	從節點的串連地址，串連該地址僅能執行資料庫的讀操作。重要不建議在生產環境的應用程式通過該地址串連執行個體。當執行個體觸發主備切換後，從節點可能會升級為主節點，主節點地址支援寫操作，從而帶來資料與許可權的安全問題。
ReadOnly地址	唯讀節點的串連地址，串連該地址僅能執行資料庫的讀操作。說明該地址僅在執行個體中存在唯讀節點時顯示。

串連地址格式說明

ConnectionStringURI地址

格式：

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

參數說明：

參數	說明
`<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。
`readPreferenceTags=<readonly_Tags>`（可選）	該參數可以將讀請求優先發送到標籤對應的節點。通常與參數readPreference一起使用，與`primary`模式不相容。`<readonly_Tags>`為唯讀節點的標籤索引值對列表，支援的類型如下： `readPreferenceTags=role:electable`：優先讀從節點。說明該選項僅對雲端硬碟版執行個體生效。 `readPreferenceTags=role:readonly`：優先讀唯讀節點。

MongoDB執行個體可以靈活使用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****

ConnectionstringURI SRV地址

格式：

mongodb+srv://<username>:<password>@<srv-host>/<database>?<options>

參數說明：

參數	說明
`mongodb+srv://`	連接字串的首碼，表示使用DNS SRV記錄進行服務發現。
`<username>`	資料庫帳號的名稱。
`<password>`	資料庫帳號的密碼。
`<srv-host>`	主機名稱。
`<database>`	要訪問的資料庫名稱，預設為admin。
`<option>`	其他選擇性參數。說明 SVR串連的SSL選項預設值為true，如果您不需要使用SSL加密串連，需要在串連串上添加參數`ssl=false`。更多選擇性參數的介紹，請參見MongoDB官網文檔。

樣本：

資料庫帳號為test，所屬資料庫為admin。

mongodb+srv://test:****@dds-bp19215393a0****-srv.mongodb.nosql.aliyuncs.com/admin?ssl=false

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****

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

串連地址網路類型

網路類型	說明
私網	專用網路：專用網路是具備更高安全性和效能的一種隔離網路。ApsaraDB for MongoDB執行個體預設提供專用網路串連地址。傳統網路：非隔離網路，僅依靠雲端服務的安全性群組或白名單策略進行防護。新購執行個體不再支援傳統網路，請參見【通知】ApsaraDB for MongoDB新購買執行個體不再支援傳統網路。
公網	由於通過公網串連執行個體存在一定的安全風險，ApsaraDB for MongoDB執行個體預設未提供公網串連地址。如果您需要公網串連可手動申請，申請方法請參見（可選）申請公網串連地址。

擷取資料庫連接地址

訪問MongoDB複本集執行個體列表，在上方選擇資源群組和地區，然後單擊目標執行個體ID。
在目標執行個體頁面的左側導覽列，單擊資料庫連接。

登入MongoDB資料庫

擷取如下資訊：
- 資料庫連接地址，擷取方法請參見資料庫連接地址。
- 資料庫帳號，初始帳號為root。
  說明
  不建議在生產環境中直接使用root帳號串連資料庫。您可以建立使用者並分配許可權，詳情請參見使用DMS管理MongoDB執行個體的帳號。
- 資料庫帳號對應密碼。如果沒有設定或忘記密碼，您可以設定或修改密碼，具體方法請參見（可選）重設密碼。
- 要訪問的資料庫。當資料庫帳號為root時，對應的資料庫為admin。
登入資料庫。您可以選擇以下任意一種方法登入：

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

串連地址說明

如何選擇串連地址

串連地址類型

串連地址格式說明

ConnectionStringURI地址

ConnectionstringURI SRV地址

ReadOnly ConnectionStringURI地址

Primary地址

Secondary地址

ReadOnly地址

串連地址網路類型

擷取資料庫連接地址

登入MongoDB資料庫

常見的串連情境

相關問題