通过

快速入门：使用 Azure Data Studio 连接和查询 Azure Cosmos DB API for MongoDB（预览版）

重要

Azure Data Studio 将于 2026 年 2 月 28 日停用。 建议使用 Visual Studio Code。 有关迁移到 Visual Studio Code 的详细信息，请访问 Azure Data Studio 发生了什么情况？

本快速入门介绍如何使用 Azure Data Studio 连接到 Azure Cosmos DB API for MongoDB。

注意

虽然 Microsoft Entra ID 是 Azure Active Directory (Azure AD) 的新名称，但为了防止中断现有环境，Azure AD 仍保留在一些硬编码的元素中，例如 UI 字段、连接提供程序、错误代码和 cmdlet。 在本文中，这两个名称是可互换的。

先决条件

要完成此快速入门，需要 Azure Data Studio 和 Azure Cosmos DB API 帐户。

连接到 Azure Cosmos DB for MongoDB 帐户

  1. 启动“Azure Data Studio”。

  2. 第一次启动 Azure Data Studio 时，将打开“连接”对话框。 如果未打开“连接”对话框，请选择“服务器”页中的“新建连接”图标：

    服务器新建连接图标的屏幕截图。

  3. 在出现的对话框中，选择“浏览”，然后选择+ 图标以登录到 Azure。

    用于在“连接”对话框中添加新 Azure 帐户的加号按钮的屏幕截图。

  4. 登录到 Azure 后，选择你要访问的 Azure Cosmos DB 帐户，或使用此表中的详细信息在字段中填写连接详细信息。

    设置 价值 说明
    连接类型 Mongo 帐户 将此值设置为 Mongo 帐户，以用于 Azure Cosmos DB API for MongoDB。
    Mongo 帐户 [cosmos-account-name] Azure Cosmos DB 帐户的名称。
    身份验证类型 Azure Active Directory - 支持 MFA 的通用目录 在Microsoft Entra ID或基本身份验证选项之间进行选择。
    帐户 当前AAD用户名[current-aad-user-name] 仅当使用 Microsoft Entra 身份验证时才可见。 选择要用于身份验证的 Microsoft Entra 帐户。
    Microsoft Entra 租户 仅当使用 Microsoft Entra 身份验证时才可见。 选择 MongoDB 实例所在的 Microsoft Entra 租户。
    用户名 仅当使用“基本”身份验证时可见。 输入用于身份验证的用户名。
    连接字符串 仅当使用“基本”身份验证时可见。 输入用于身份验证的连接字符串。
    服务器组 <默认>
    名称(可选) 在“服务器”边栏中输入要使用的任何唯一名称。

    带有创建连接所需凭据的对话框屏幕截图。

  5. 选择“连接”。

    重要

    如果选择了Microsoft Entra 身份验证，系统可能会提示选择用于连接的 MongoDB 连接字符串值。

成功连接后，你的服务器将在“服务器”边栏中打开。

创建数据库和集合

以下步骤将创建一个名为 SourceDatabase 的数据库和一个名为 People 的集合：

  1. 打开帐户的上下文菜单，然后选择“创建数据库”。

    Mongo DB 上下文菜单中创建数据库选项的屏幕截图。

  2. 在“数据库”和“集合”弹出对话框中，使用此表中的详细信息。

    提示 价值
    数据库名称 SourceDatabase
    集合名称 People

  3. 操作完成后，新数据库应显示在数据库列表中。

    提示

    如果数据库未显示在列表中，请选择“刷新”。

  4. 展开“服务器”边栏中的 SourceDatabase 和 People 节点。

    SERVERS 侧栏中 Mongo 帐户注释下的数据库和集合层次结构的屏幕截图。

创建示例集合

以下步骤将使用示例数据集填充 People 集合：

  1. 选择“数据库”以导航到帐户中的数据库列表。

    用于导航到数据库视图的选项的屏幕截图。

  2. 在数据库列表中选择 SourceDatabase 项。

    数据库列表中名为“源数据库”的数据库列表项的屏幕截图。

  3. 在标题菜单中，选择“导入示例数据”。 在确认对话框中选择“是”。

    用于执行导入的对话框选项的屏幕截图。

  4. 等待导入操作完成。

    提示

    导入操作可能需要几分钟才能完成。

查询数据

以下步骤将使用 Mongo Shell 执行查询并查看查询结果：

  1. 在数据库的菜单中，选择“打开 Mongo Shell”。

    用于打开 Mongo Shell 的菜单选项的屏幕截图。

  2. 在 shell 中执行以下查询。

    db.Persons.find().pretty()

    提示

    Mongo 中的 pretty() 方法以易于阅读的格式显示查询结果。 要了解详情，请参阅 cursor.pretty 的官方 MongoDB 文档。

  3. 观察 shell 中查询的输出。 输出应包含

    Mongo Shell 查询结果截图。

后续步骤

在本快速入门中，你了解了如何为 MongoDB 帐户创建 API、在 Azure Data Studio 中创建数据库和集合以及查询示例数据。 现在可使用 Azure Data Studio 查看数据库中的实际数据。