使用 MongoDB Shell 连接到 Azure Cosmos DB for MongoDB (vCore)
适用对象: MongoDB vCore
MongoDB Shell (mongosh
) 是用于与 MongoDB 部署进行交互的 JavaScript 和 Node.js 环境。 它是一种常用的社区工具,用于测试查询并与 Azure Cosmos DB for MongoDB 数据库中的数据进行交互。
先决条件
现有的 Azure Cosmos DB for MongoDB(vCore 体系结构)群集。
来自社区站点的 MongoDB Shell 的已安装版本。
为操作系统设置必要的安装后环境变量。
允许计算机连接的防火墙设置。 遵循为 Azure Cosmos DB 配置防火墙的准则。
可以选择允许来自当前 IP 地址的请求、来自云服务的请求或来自虚拟机(特定 IP 范围)的请求。
如果意外打开了所有端口,则保存更改之前会发出警告。
使用 MongoDB Shell 连接
若要将 Azure Cosmos DB 群集添加到 MongoDB Shell,请执行以下步骤:
按照这些说明检索 Azure Cosmos DB for MongoDB (vCore) 的连接信息。
使用以下任一方法进行连接:
在 Mongo Shell 提示符中输入密码。 连接字符串如以下示例所示:
"mongodb+srv://<username>@<servername>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
命令如下所示:
mongosh "mongodb+srv://testuser@mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000
提供密码并成功进行身份验证后,将显示以下警告:“此服务器或服务似乎是 MongoDB 的模拟。”可将其忽略。 之所以生成此警告,是因为连接字符串包含
cosmos.azure
。 Azure Cosmos DB 是原生 Azure 平台即服务 (PaaS) 产品。将密码作为连接字符串的一部分提供。 格式类似于此示例:
mongosh "mongodb+srv://<SERVERNAME>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<USER>" -password "<PASSWORD>"
命令如下所示:
mongosh "mongodb+srv://mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "testuser" -password "******"