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

适用对象: MongoDB

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

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

先决条件

必须提供以下两项

  • 一个 Azure 帐户。

使用快速启动方法获取 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

    此字符串的值为:

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

    例如,考虑“连接字符串”窗格中显示的帐户。 有效的连接字符串为:

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

    驱动程序要求

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

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