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 Download和The mongo Shell。
如果應用部署在ECS執行個體,您需要確保ApsaraDB for MongoDB執行個體和ECS執行個體滿足以下條件,以保證網路的連通性。ECS執行個體資訊的查看方法請參見查看執行個體資訊。
- 所在地區相同,並建議所在可用性區域相同(以減少網路延時)。
- 網路類型為專用網路,需確保使用相同的專用網路ID。說明 如果ECS執行個體的網路類型為傳統網路,您可以將ECS執行個體網路類型轉換為專用網路,具體請參見ECS執行個體從傳統網路遷移到專用網路。
將用戶端IP地址添加至ApsaraDB for MongoDB執行個體的白名單中,添加方法請參見設定白名單。
說明如果您需要使用公網地址串連ApsaraDB for MongoDB執行個體,您可以手動申請公網地址,申請方法請參見(可選)申請公網串連地址。
操作步驟
登入MongoDB管理主控台。
在左側導覽列,單擊複本集執行個體列表。
在頁面左上方,選擇執行個體所在的資源群組和地區。
單擊目標執行個體ID或目標執行個體所在行操作列的管理。
在目標執行個體頁面的左側導覽列,單擊資料庫連接。
查看並擷取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
執行如下命令,在安裝有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
回顯如下資訊,輸入資料庫帳號對應的密碼並按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之外的資料庫實現業務需求。