全部產品
Search
文件中心

:通過Mongo Shell串連MongoDB單節點執行個體

更新時間:Jun 19, 2024

Mongo Shell是MongoDB內建的資料庫管理工具,您可以將Mongo Shell工具下載並安裝至用戶端(本機伺服器或ECS伺服器),用於串連ApsaraDB for MongoDB單節點執行個體。本文介紹通過Mongo Shell串連ApsaraDB for MongoDB單節點執行個體的方法。

前提條件

已建立ApsaraDB for MongoDB單節點執行個體。

背景資訊

ApsaraDB for MongoDB單節點執行個體提供的預設資料庫admin,用於管理預設資料庫帳號root的資訊,建議使用admin之外的資料庫實現業務需求(即不對admin庫進行任何操作)。

準備工作

  • 下載並安裝與ApsaraDB for MongoDB執行個體資料庫版本相同的Mongo Shell工具至用戶端(本機伺服器或Elastic Compute Service執行個體),下載連結和安裝方法,請參見MongoDB Shell DownloadThe mongo Shell

    如果應用部署在ECS執行個體,您需要確保ApsaraDB for MongoDB執行個體和ECS執行個體滿足以下條件,以保證網路的連通性。ECS執行個體資訊的查看方法請參見查看執行個體資訊

    • 所在地區相同,並建議所在可用性區域相同(以減少網路延時)。
    • 網路類型為專用網路,需確保使用相同的專用網路ID。
      說明 如果ECS執行個體的網路類型為傳統網路,您可以將ECS執行個體網路類型轉換為專用網路,具體請參見ECS執行個體從傳統網路遷移到專用網路
  • 將用戶端IP地址添加至ApsaraDB for MongoDB執行個體的白名單中,添加方法請參見設定白名單

    說明

    如果您需要使用公網地址串連ApsaraDB for MongoDB執行個體,您可以手動申請公網地址,申請方法請參見(可選)申請公網串連地址

操作步驟

  1. 登入MongoDB管理主控台

  2. 在左側導覽列,單擊複本集執行個體列表

  3. 在頁面左上方,選擇執行個體所在的資源群組和地區。

  4. 單擊目標執行個體ID或目標執行個體所在行操作列的管理

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

  6. 查看並擷取ApsaraDB for MongoDB單節點執行個體的串連地址。

    擷取串連地址

    專案

    說明

    地址類型

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

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

    Primary

    格式:

    <host>:<port>

    參數說明:

    • <host>:節點的網域名稱資訊

    • <port>:節點的連接埠

    樣本:

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

    ConnectionStringURI

    格式:

    mongodb://<username>:<password>@<host>:<port>/<database>[?&authSource=<authenticationDatabase>]

    參數說明:

    • <username>:資料庫帳號的名稱,預設為root。

    • <password>:資料庫帳號的密碼。

    • <host>:節點的網域名稱資訊

    • <port>:節點的連接埠

    • <database>:要訪問的資料庫名稱,預設為admin。

    • authSource=<authenticationDatabase>(可選):該參數用於指定資料庫帳號所屬的資料庫。<authenticationDatabase>為鑒權資料庫名稱。如果不配置該參數,<database>會作為鑒權資料庫。

      重要

      資料庫帳號必須在所屬的資料庫下進行鑒權,才能鑒權成功。

    樣本:

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

    mongodb://test:****@dds-bp1ea17b41abecf43****.mongodb.rds.aliyuncs.com:3717/admin
  7. 執行如下命令,在安裝有MongoDB的用戶端(本機伺服器或ECS伺服器)上串連ApsaraDB for MongoDB單節點執行個體。

    mongo --host <host> --port <port> -u <username> -p --authenticationDatabase <authenticationDatabase>

    參數說明:

    • <host>:節點的網域名稱資訊

    • <port>:節點的連接埠

    • <username>:資料庫帳號的名稱,預設為root。

    • <authenticationDatabase>:鑒權資料庫名稱,用於指定資料庫帳號所屬的資料庫。當資料庫帳號為root時,對應的資料庫為admin。如果您希望指定其他資料庫,請先在該資料庫中使用db.createUser()命令建立帳號,然後再使用該帳號進行串連。

      重要

      資料庫帳號必須在所屬的資料庫下進行鑒權,才能鑒權成功。

    樣本:

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

    mongo --host dds-bp1ea17b41abecf43****.mongodb.rds.aliyuncs.com --port 3717 -u test -p --authenticationDatabase admin
  8. 回顯如下資訊,輸入資料庫帳號對應的密碼並按Enter。

    Enter password:<password>

    參數說明:<password>為單節點執行個體資料庫帳號的密碼。輸入密碼時,密碼不可見。

    回顯如下類似資訊,說明串連成功。

    說明

    使用不同版本的Mongo Shell串連執行個體後回顯資訊不同,請以實際情況為準。

    connecting to: mongodb://dds-bp1ea17b41abecf43****.mongodb.rds.aliyuncs.com:3717/
    MongoDB server version: 3.4.6
    Welcome to the MongoDB shell.
說明

執行個體串連成功後,建議您使用admin之外的資料庫實現業務需求。

常見的串連情境

相關問題