安装 Azure Cosmos DB Shell

Azure Cosmos DB Shell 可通过三种分发方法获得。 选择最适合你的工作流程的选项。

VS Code 扩展提供与代码编辑器的无缝集成。

方法 1a：从 VS Code 市场安装

  1. 打开 VS Code

    • 在计算机上启动Visual Studio Code

  2. 开放扩展市场

    • 单击“扩展”图标（Ctrl+Shift+X/ Cmd+Shift+X）
    • 或者转到“查看 > 扩展”

  3. 搜索 Cosmos DB

    • 在搜索框中键入“Cosmos DB”
    • 查找 Microsoft 提供的“Azure Cosmos DB”扩展

  4. 安装扩展

    • 单击“安装”按钮
    • 等待安装完成

  5. 验证安装

    • 扩展应显示在已安装的扩展列表中
    • 现在可以从命令面板访问 Cosmos DB Shell

方法 1b：从 VSIX 文件安装

  1. 下载扩展

    • 从发行页面下载 vscode-cosmosdb-0.33.3.vsix（或最新版本）

  2. 安装扩展

    • 打开 VS Code
    • 转到扩展 （Ctrl+Shift+X / Cmd+Shift+X）
    • 单击“...”菜单并选择“从 VSIX 安装”
    • 选择下载的文件

  3. 完成安装

    • 等待安装完成
    • 如果系统提示，请重新加载 VS Code

VS Code 扩展要求

  • VS Code 版本：1.85 或更高版本
  • Supported Platforms：Windows、macOS、Linux
  • 磁盘空间：约 50 MB

有关详细的 VS Code 集成功能，请参阅 Visual Studio Code 扩展设置。

选项 2：NuGet 包（.NET全局工具）

作为用于命令行访问的.NET全局工具进行安装。

先决条件

  • .NET SDK：版本 10.0 或更高版本
  • Platform 支持：Windows、macOS（Intel 和 Apple Silicon）、Linux（x64 和 ARM）

安装步骤

  1. 打开终端或命令提示符

    • Windows：打开命令提示符或 PowerShell
    • macOS/Linux：打开终端

  2. 安装全局工具

    dotnet tool install --global CosmosDBShell --prerelease

  3. 验证安装

    cosmosdbshell --version

更新到最新版本

dotnet tool update --global CosmosDBShell --prerelease

Uninstall

dotnet tool uninstall --global CosmosDBShell

包裹详情

选项 3：自包含二进制文件（无需 .NET）

下载并解压适用于你的平台的独立二进制文件。

先决条件

  • 无运行时要求（包括.NET运行时）
  • 足够的磁盘空间（约 200 MB）

安装步骤

  1. 下载

    • 选择平台：
      • Windows （x64）：cosmosdbshell-win-x64.zip
      • Windows （ARM）：cosmosdbshell-win-arm64.zip
      • macOS （Intel）： cosmosdbshell-macos-x64.tar.gz
      • macOS （Apple Silicon）： cosmosdbshell-macos-arm64.tar.gz
      • Linux （x64）： cosmosdbshell-linux-x64.tar.gz
      • Linux （ARM64）： cosmosdbshell-linux-arm64.tar.gz

  2. 解压压缩包

    Windows：

    Expand-Archive -Path cosmosdbshell-win-x64.zip -DestinationPath "C:\Program Files\CosmosDBShell"

    macOS/Linux：

    mkdir -p ~/cosmosdbshell
tar -xzf cosmosdbshell-macos-x64.tar.gz -C ~/cosmosdbshell

  3. 添加到 PATH （可选）

    Windows：

    • 将 C:\Program Files\CosmosDBShell 添加到系统 PATH 环境变量中
    • 或使用完整路径： C:\Program Files\CosmosDBShell\cosmosdbshell.exe

    macOS/Linux：

    export PATH="$HOME/cosmosdbshell:$PATH"
# Add to ~/.bashrc or ~/.zshrc for persistence

  4. 运行

    cosmosdbshell

验证

测试你的安装

  1. NuGet 安装：

    cosmosdbshell --version

  2. 对于二进制安装：

    ./cosmosdbshell --version

  3. 适用于 VS Code 扩展：

    • 打开命令面板（Ctrl+Shift+P/Cmd+Shift+P）
    • 键入“Cosmos DB Shell”
    • 你应会看到 Cosmos DB Shell 命令

故障排除

“找不到命令”（NuGet 安装）

  • 确保已安装 .NET SDK 10.0+ ：dotnet --version
  • 安装后重启终端
  • 检查路径中是否存在$HOME/.dotnet/tools

“找不到文件”（二进制安装）

  • 验证已成功提取的存档
  • 检查文件权限： chmod +x cosmosdbshell （macOS/Linux）
  • 使用可执行文件的完整路径

VS Code 扩展未出现

  • 确保 VS Code 版本为 1.85 或更高版本
  • 重启 VS Code
  • 在扩展市场中搜索“Azure Cosmos DB”扩展

后续步骤

支持

如果遇到问题：

另请参阅

  • Last updated on