全部產品
Search
文件中心

ApsaraDB for MongoDB:串連執行個體

更新時間:Jun 04, 2025

建立ApsaraDB for MongoDB執行個體後,您需要通過用戶端工具串連執行個體後才能使用執行個體。

前提條件

  • 已根據快速入門步驟成功設定白名單

  • 執行個體狀態為運行中

操作步驟

DMS

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

  2. 在頁面右上方,單擊登入資料庫

    • 複本集:在登入資料庫的下拉框中選擇Primary後,跳轉至DMS控制台。

      說明

      Secondary節點僅支援讀,若需寫入資料,請選擇Primary節點。

    • 分區叢集:在登入資料庫的下拉框中選擇任一節點後,跳轉至DMS控制台。

    • 單節點:無需選擇,直接跳轉至DMS控制台。

  3. 在DMS控制台彈出的登入執行個體對話方塊中,輸入資料庫帳號資料庫密碼,其他配置保持預設即可。

    說明

    如果忘記了帳號密碼或建立執行個體時未設定密碼,請前往MongoDB控制台重設密碼

  4. 單擊測試連接,在成功對話方塊中,單擊確定

  5. 單擊登入

MongoDB Shell

在本地或ECS上安裝MongoDB Shell

MongoDB提供了MongoDB Shell(mongosh)和mongo Shell兩個命令列工具,mongo Shell為早期版本的用戶端工具,MongoDB Shell為升級後的工具,本文以MongoDB Shell為例。

  1. 在用戶端上下載MongoDB Shell

  2. 安裝mongosh

擷取串連地址

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

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

  3. 在資料庫連接頁面,擷取需要的串連地址。

    本文以私網串連-專用網路ConnectionStringURI高可用串連地址為例,格式如下。如需通過公網串連,需要先申請公網串連地址

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

    其中root:****需要替換為真實帳號密碼。如果忘記了帳號密碼或建立執行個體時未設定密碼,請前往MongoDB控制台重設密碼

串連資料庫

在用戶端上執行以下命令串連MongoDB。

說明

如果您使用的是mongo Shell,請將命令中的mongosh替換為mongo

mongosh "<ConnectionStringURI高可用串連地址>"

資料庫帳號為root,密碼為PassWord123!,鑒權資料庫為admin,樣本如下。

mongosh "mongodb://root:PassWord123%21@dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717,dds-bp1d9a7c2908e****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-8970****"

串連串中帳號密碼的特殊字元需要轉譯,例如樣本密碼中的!需要轉譯為%21,更多介紹請參見如何解決串連串中帳號密碼包含特殊字元導致失敗的問題?

程式碼

下一步

寫入資料

相關文檔

不建議在生產環境中直接使用root帳號串連執行個體,您可以建立其他資料庫帳號並添加許可權串連執行個體。通過其他資料庫帳號串連執行個體時,需要給資料庫帳號添加業務所需的許可權。如果您使用未添加許可權的資料庫帳號,成功串連執行個體後,不能進行任何資料庫操作,會提示Exception authenticating...等錯誤。