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

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

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

先决条件

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

  1. 在 Internet 浏览器中,登录 Azure 门户
  2. 在“Azure Cosmos DB”边栏选项卡中,选择 MongoDB API 帐户。
  3. 在“帐户”边栏选项卡的“左导航”栏中,单击“快速启动”。
  4. 选择平台(.NET 驱动程序Node.js 驱动程序MongoDB ShellJava 驱动程序Python 驱动程序)。 如果未列出驱动程序或工具,别担心,我们持续记录了更多连接代码片段。 请在下方就想要看到的内容进行评论,并阅读 获取帐户的连接字符串信息 ,了解如何创建自己的连接。
  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==@anhohmongo.documents.azure.cn:10255/mydatabase?ssl=true

后续步骤

  • 了解如何将 MongoChef 用于 Azure Cosmos DB: API for MongoDB 帐户。
  • 浏览 Azure Cosmos DB: API for MongoDB 示例