快速入门：使用 Visual Studio Code 连接和查询 Azure Cosmos DB 实例

在开始之前，确保你拥有：

• 配置有 NoSQL API 数据库和集合的 Azure Cosmos DB 帐户。 请使用以下任何快速入门设置资源：

  • 门户
  • Azure CLI

• 若要在 Visual Studio 中连接和管理 Azure Cosmos DB 中的数据，请先安装“Azure 数据库”扩展。

  1. 打开 Visual Studio Code。
  2. 通过选择“视图”>“扩展”来访问“扩展”窗格，或者使用 Windows 上的快捷键 Ctrl + Shift + X 或 MacOS 上的快捷键 Command + Shift + X 来执行该操作。
  3. 在搜索栏中，键入“Azure 数据库扩展”并选择该扩展。 然后单击“安装”。
  4. 安装后，如果系统提示，请重新加载 Visual Studio Code。

1. 在 Visual Studio Code 中，转到“Azure”窗格（选择活动栏中的“Azure”图标）。
2. 通过 Entra ID 登录到 Azure 帐户：注意：建议在访问 Azure Cosmos DB 资源时始终使用 Microsoft Entra ID RBAC（而不是帐户密钥），以使用最安全的身份验证方法。
3. 登录后，在 Azure 树状视图中找到 Azure 订阅并向下钻取到 Azure Cosmos DB。
4. 选择现有帐户或右键单击以创建新资源。

以下步骤将使用查询编辑器执行查询并查看查询的结果：

1. 在集合的菜单中，右键单击该集合以打开预览版查询编辑器。

   

2. 运行查询编辑器中提供的查询，以在表视图中显示数据：

   

3. 在其他受支持的视图中浏览数据：

• JSON 视图：查看原始数据结构。
• 树状视图：轻松浏览嵌套数据。

在查询编辑器中，查看其他查询和索引指标，以更好地优化查询性能。

1. 选择查询结果旁边的“统计”选项卡。

2. 有关指标定义的详细信息，请参阅查询指标文档。

• 实时文档编辑：即时添加、查看、编辑和删除文档，并实时反映更改。
• 从 JSON 导入：从 JSON 文件快速加载数据。

• 下载结果：将查询结果下载到 CSV 或 JSON 文件。

在本教程中，你了解了如何在 VS Code 中查询数据、导出查询结果、查看查询和索引指标（以优化查询性能）以及通过多个支持的视图显示数据。 现在，你可以使用“Azure 数据库”这一 VS Code 扩展来查看数据库中的实际数据。

• 适用于 NoSQL 的 API 入门
• Node.js 快速入门
• Python 快速入门
• Java 快速入门
• Go 快速入门

在开始之前，确保你拥有：

• Azure Cosmos DB for MongoDB 中配置有数据库的 Azure Cosmos DB 帐户。 请使用以下快速入门之一设置数据库：
  • 门户
  • Azure CLI
• 若要连接和管理 Azure Cosmos DB 中的数据，则需要安装 Visual Studio Code 的“Azure 数据库”扩展。
  1. 打开 Visual Studio Code。
  2. 通过选择“视图”>“扩展”来访问“扩展”窗格，或者使用 Windows 上的快捷键 Ctrl + Shift + X 或 MacOS 上的快捷键 Command + Shift + X 来执行该操作。
  3. 在搜索栏中，键入“Azure 数据库扩展”并选择该扩展。 然后单击“安装”。
  4. 安装后，如果系统提示，请重新加载 Visual Studio Code。
• 为命令行交互安装的 MongoDB shell (mongosh)（可选条件，但建议满足）。

在 Visual Studio Code 中轻松管理数据库：

• 创建和删除数据库/集合：右键单击资源面板中的帐户、数据库或集合，以创建或删除数据库和集合。

• 从 JSON 导入：快速将数据从 JSON 文件导入到集合中。

  • 启动导入
    1. 右键单击资源视图中的集合名称，然后选择“将文档导入集合”。
    2. 或者，通过单击集合的“文档”条目打开“集合视图”，然后单击“导入”按钮。
  • 选择 JSON 文件
    1. 浏览以查找包含数据的 *.json 文件。
    2. 进行确认，以开始导入过程。

• 导出数据：将集合或查询结果另存为 JSON，以便进行备份或共享。

  • 启动导出：
    • 选项 1
      1. 右键单击资源视图中的集合名称，然后选择“从集合导出文档”来导出整个集合。
    • 方法 2
      1. 通过单击集合的“文档”条目打开“集合视图”，然后单击“导出”按钮。
      2. 选择导出整个集合或导出当前查询的结果。
  • 指定目标文件：
    1. 输入目标 *.json 文件的名称和位置。
    2. 确认导出，以开始保存数据。

• 实时文档编辑：即时添加、查看、编辑和删除文档，并实时进行更新。

  • 打开文档编辑：
    • 直接在“集合视图”中访问文档编辑选项。这些控件位于数据视图上方，便于访问。
  • 可用操作：
    • 添加：在集合中创建新文档。
    • 查看：查看所选文档的内容。
    • 编辑：编辑所选文档的内容。
    • 删除：移除所选文档并立即反映所做更改。

无缝运行和优化查询：

• 即时结果：立即以首选格式（表、JSON 或树状视图）查看查询结果。

  • 使用“视图”下拉菜单轻松切换视图。

• 直接执行查询：使用语法突出显示和自动补全等功能编写和执行 MongoDB 查询。

  • 若要运行查询，请单击“查找查询”按钮或在查询编辑器中按 Ctrl/Cmd+Enter。

使用多个视图从不同角度探索数据：

• JSON 视图：查看原始 JSON 数据结构。

• 树状视图：轻松导航和浏览嵌套数据。

• 表视图：快速扫描数据并向下钻取到嵌套文档。

  • 向下钻取：查找带有 {} 图标的条目，该图标指示嵌入的对象。 双击即可展开和查看内容。
  • 返回：使用表视图下方的痕迹导航返回到以前的级别。

命令行功能可用：

• 启动 mongosh：直接从 Visual Studio Code 执行高级 MongoDB 命令。

随时了解资源：

• 查看群集详细信息：检查群集的层、服务器版本和资源使用情况。

• 管理标记：使用与 Azure 门户同步的标记组织群集。