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

适用于:适用于 MongoDB 的 Azure Cosmos DB API

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

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

先决条件

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

  1. 在 Internet 浏览器中,登录 Azure 门户

  2. 在 Azure Cosmos DB 边栏选项卡中,选择 API 。

  3. 在“帐户”边栏选项卡左侧窗格中,单击“快速启动” 。

  4. 选择平台( .NETNode.jsMongoDB ShellJavaPython)。 如果未列出驱动程序或工具,别担心,我们持续记录了更多连接代码片段。 请在下面留言,告知想知道的内容。 若要了解如何创建自己的连接,请阅读获取该帐户的连接字符串信息

  5. 将代码片段复制粘贴到 MongoDB 应用。

    “快速启动”边栏选项卡

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

  1. 在 Internet 浏览器中,登录 Azure 门户

  2. 在 Azure Cosmos DB 边栏选项卡中,选择 API 。

  3. 在“帐户”边栏选项卡的左侧窗格中,单击“连接字符串” 。

  4. 此时将打开“连接字符串”边栏选项卡 。 其中显示了使用 MongoDB 驱动程序连接到帐户所需的所有信息,包括预先构造的连接字符串。

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

连接字符串要求

重要

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

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

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

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

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

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

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

驱动程序要求

支持线路协议 3.4 或更高版本的所有驱动程序都将支持 Azure Cosmos DB API for MongoDB。

具体而言,客户端驱动程序必须支持服务名称指示 (SNI) TLS 扩展和/或 appName 连接字符串选项。 如果提供了 appName 参数,则必须将其包含在 Azure 门户的连接字符串值中。

后续步骤

  • 了解如何将 Studio 3T 与 Azure Cosmos DB 的用于 MongoDB 的 API 配合使用。
  • 了解如何将 Robo 3T 与 Azure Cosmos DB 的用于 MongoDB 的 API 配合使用。
  • 通过 Azure Cosmos DB 的用于 MongoDB 的 API 来浏览 MongoDB 示例
  • 尝试为迁移到 Azure Cosmos DB 进行容量计划? 可以使用有关现有数据库群集的信息进行容量规划。