将 MongoDB 应用程序连接到 Azure Cosmos DB

了解如何使用 MongoDB 连接字符串,将 MongoDB 应用连接到 Azure Cosmos DB 帐户。 然后,可使用 Azure Cosmos DB 数据库作为 MongoDB 应用的数据存储。

本教程提供两个用于检索连接字符串信息的方法:

先决条件

使用快速启动方法获取 MongoDB 连接字符串

  1. 在 Internet 浏览器中,登录 Azure 门户
  2. 在“Azure Cosmos DB”边栏选项卡中,选择适用于 MongoDB 帐户的 API。
  3. 在“帐户”边栏选项卡左侧窗格中,单击“快速启动”。
  4. 选择平台(.NETNode.jsMongoDB ShellJavaPython)。 如果未列出驱动程序或工具,别担心,我们持续记录了更多连接代码片段。 请在下面留言,告知想知道的内容。 若要了解如何创建自己的连接,请阅读获取该帐户的连接字符串信息
  5. 将代码片段复制粘贴到 MongoDB 应用。

    “快速启动”边栏选项卡

获取要自定义的 MongoDB 连接字符串

  1. 在 Internet 浏览器中,登录 Azure 门户
  2. 在“Azure Cosmos DB”边栏选项卡中,选择适用于 MongoDB 帐户的 API。
  3. 在“帐户”边栏选项卡的左侧窗格中,单击“连接字符串”。
  4. 此时将打开“连接字符串”边栏选项卡。 其中显示了使用 MongoDB 驱动程序连接到帐户所需的所有信息,包括预先构造的连接字符串。

    “连接字符串”边栏选项卡

连接字符串要求

Important

Azure Cosmos DB 具有严格的安全要求和标准。 Azure Cosmos DB 帐户需要通过 SSL 进行身份验证和安全通信。

Azure Cosmos DB 支持标准 MongoDB 连接字符串 URI 格式,但要满足几个具体的要求:Azure Cosmos DB 帐户需要通过 SSL 进行身份验证和安全通信。 因此,连接字符串格式为:

mongodb://username:password@host:port/[database]?ssl=true

此字符串的值可用于前面显示的“连接字符串”边栏选项卡:

  • 用户名称(必需):Azure Cosmos DB 帐户名称。
  • 密码(必需):Azure Cosmos DB 帐户密码。
  • 主机(必需):Azure Cosmos DB 帐户的 FQDN。
  • 端口(必需):10255。
  • 数据库(可选):连接使用的数据库。 如果未提供任何数据库,则默认数据库是“test”。
  • ssl=true(必需)

以“连接字符串”边栏选项卡中显示的帐户为例。 有效的连接字符串为:

mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.cn:10255/mydatabase?ssl=true

后续步骤