Azure Cosmos DB Shell 是一种功能强大的 open-source 命令行接口 （CLI），可用于使用直观的 bash 类似命令与Azure Cosmos DB数据库进行交互。 它提供可选的模型上下文协议（MCP）服务器支持，以实现由 AI 驱动的自动化，并通过扩展与 VS Code 无缝集成。
主要功能
-
类似于 Bash 的语法：熟悉命令结构，如
cd、ls、pwd、rmmkdir - 数据库操作：创建和管理数据库和容器
- 数据操作：查询、插入、更新和删除文档
- 管道支持：将命令链接在一起，实现强大的数据转换
- JSON 查询：使用 JSON 输出执行 SQL 查询
- 脚本：编写和执行用于自动化操作的 shell 脚本
- MCP 服务器集成：使 AI 助手能够与 Cosmos DB 资源交互
- VS 代码扩展：与Visual Studio Code无缝集成
- 开源：社区驱动的开发，提供透明贡献
系统要求
- Operating System：Windows、macOS（Intel 和 Apple Silicon）、Linux（x64 和 ARM）
- 对于 NuGet 安装：.NET SDK 10.0 或更高版本
- 对于 VS Code 扩展：VS Code 1.85 或更高版本
- 身份验证：Microsoft Entra ID、托管标识或帐户密钥
安装选项
选择三种安装方法之一：
VS Code 扩展（推荐）
- 直接从 VS Code 市场安装
- 请参阅：Visual Studio Code 扩展设置
NuGet 包
- 安装为 .NET 全局工具
- 请参阅： 安装指南
Self-Contained Binary
- 适用于您的平台的预编译二进制文件
- 请参阅： 安装指南
快速入门
# Connect to your Cosmos DB account
cosmosdbshell
# Navigate to a database
> cd database_name
# List containers
> ls
# Query documents
> query "SELECT * FROM c WHERE c.name = 'John'"
有关更多示例，请参阅 快速入门指南。
用例
- 开发和测试：在开发过程中快速进行命令行访问
- 数据库管理：管理数据库、容器和数据
- 数据浏览：以交互方式查询和浏览数据
- 自动化：在脚本中用于自动数据库操作
- AI 集成：使 AI 助手能够通过 MCP 处理数据
- 学习：学习 Cosmos DB 概念的教育工具
版本状态
Azure Cosmos DB Shell 目前处于私人预览阶段。 这是仅用于测试和反馈的预览版本。 你的反馈对于帮助我们改进工具很有价值。
可用发行版
| 程序包 | 版本 | 位置 |
|---|---|---|
| NuGet 包 | 1.0.213-preview | NuGet.org |
| VS Code 扩展 | Latest | VS Code 应用市场 |
| 自包含二进制文件 | 1.0.213-preview | 适用于 Windows、macOS、Linux |
文档
- 安装指南 - 使用首选方法进行安装
- 快速入门指南 - 几分钟内入门
- 命令参考 - 完整命令文档
- 模型上下文协议设置 - 启用 AI 集成
- Visual Studio Code 扩展 - VS Code 集成指南
- 故障排除指南 - 解决常见问题
- 安全最佳做法 - 保护凭据和数据