在Azure Cosmos DB Visual Studio Code扩展中使用Copilot 对话助手查询帮助(预览版)

此功能的作用

此预览功能使用Copilot 对话助手上下文来帮助起草和优化Azure Cosmos DB查询。

重要

此功能目前以预览版提供。 安装 VS Code 扩展后,在 VS Code 中选择“切换到预发行版本”,切换到预发行版本

显示Azure Cosmos DB扩展Visual Studio Code中“切换到预发行版本”选项的屏幕截图。

先决条件

  • 启用了 GitHub Copilot 和 GitHub Copilot Chat 功能的 Visual Studio Code。
  • Azure Cosmos DB扩展(预发行版本)。
  • 已连接到 Azure Cosmos DB for NoSQL 帐户和容器上下文。

使用 @cosmosdb 参与者

在聊天中,使用自然语言提示或斜杠命令来调用参与者。

在 Visual Studio Code 的 Copilot 对话助手 中使用 @cosmosdb 参与者来生成和优化 Azure Cosmos DB 查询。

示例命令:

@cosmosdb /help
@cosmosdb /generateQuery Find documents where status = 'pending'
@cosmosdb /explainQuery SELECT * FROM c WHERE c.status = 'pending'
@cosmosdb /editQuery Add ORDER BY c._ts DESC
@cosmosdb /question What is the difference between IS_DEFINED and IS_NULL?

建议的工作流

  1. 从自然语言生成查询。
  2. 在查询编辑器中运行它。
  3. 使用 explain 验证语义。
  4. 使用编辑来优化投影、筛选器、排序或分页。

提高答案质量

  • 尽可能提供确切的字段名称。
  • 显式包含排序和分页意图。
  • 将提示的范围保持在每个请求的一个任务范围内。

故障排除

  • 如果 @cosmosdb 无法识别,请验证预览扩展安装并重新加载窗口。
  • 如果 Copilot 对话助手 不可用,请确认您已登录,并且拥有 Copilot 的访问权限。
  • 如果解释或编辑失败,请验证源查询是否有效。
  • 如果响应是非目标响应,则使用显式架构和筛选器详细信息进行重新描述。