Azure Cosmos DB Shell をインストールする

エディター統合用のVisual Studio Code拡張機能、ターミナル アクセス用の.NET グローバル ツール、または.NETをインストールしない場合は自己完結型バイナリを選択します。

オプション 1: Visual Studio Code 拡張機能

Azure Cosmos DB拡張機能には、シェルをインストールして起動するためのフローが含まれています。

  1. Visual Studio Codeで拡張機能を開きます。

  2. Microsoftによって発行されたAzure Cosmos DBを検索してインストールします。 その拡張 ID は ms-azuretools.vscode-cosmosdb。

  3. コマンド パレットを開き、Azure Cosmos DB Shell の起動を実行します。

  4. シェルが使用できない場合は、インストールまたは修復の指示に従ってください。

  5. シェル ターミナルで、次を実行します:

    version
    

既にシェルを別の場所にインストールしている場合は、cosmosDB.shell.pathを完全な実行可能パスに設定します。 拡張機能で管理されたコピーをインストールしても、PATHがオペレーティング システムのcosmosdbshellに追加されるとは限りません。

拡張機能をオフラインでインストールするには、拡張機能リリースから VSIX をダウンロードし、拡張機能>...>VSIX からインストール を選択します。 Visual Studio Code バージョンと互換性のあるリリースを使用します。

起動と MCP の設定については、「Visual Studio Codeでシェルを使用する」を参照してください。

オプション 2: .NET グローバル ツール

このメソッドには.NET SDK 10.0 以降が必要です。 ランタイムのみをインストールしても、 dotnet tool コマンドは提供されません。

  1. オペレーティング システム ターミナルからインストールされている SDK を確認します。

    dotnet --list-sdks
    
  2. グローバル ツールをインストール:

    dotnet tool install --global CosmosDBShell
    
  3. 実行可能ファイルを確認します:

    cosmosdbshell --version
    

使用可能なパッケージ バージョンについては、NuGet.org の CosmosDBShell を確認してください。

ツールを次の方法で更新します。

dotnet tool update --global CosmosDBShell

次の方法でアンインストールします:

dotnet tool uninstall --global CosmosDBShell

オプション 3: 自己完結型バイナリ

自己完結型アーカイブには、.NET ランタイムが含まれます。 Azure/CosmosDBShell リリースから、一致するプラットフォームとアーキテクチャをダウンロードします。

オペレーティング システム ランタイム識別子
Windows x64 win-x64
WINDOWS ARM64 win-arm64
macOS Intel osx-x64
macOS Apple Silicon osx-arm64
Linux x64 linux-x64
Linux ARM64 linux-arm64

プラットフォームの自己完結型 ZIP アーカイブを選択します。名前に _fdd_ を含むフレームワークに依存するアーカイブではありません。 フレームワークに依存するディストリビューションには、個別にインストールされた互換性のある.NET ランタイムが必要です。

  1. 次のコマンドで使用するために、アーカイブをダウンロードし、ダウンロードしたファイルの名前を cosmosdbshell.zip に変更します。

  2. ユーザーが書き込み可能なディレクトリにアーカイブを抽出します。

    Windows では、PowerShell を使用します:

    Expand-Archive -Path .\cosmosdbshell.zip -DestinationPath "$HOME\cosmosdbshell"
    & "$HOME\cosmosdbshell\cosmosdbshell.exe" --version
    

    macOS または Linux では、unzip を備えたターミナルを使用します。

    mkdir -p "$HOME/cosmosdbshell"
    unzip cosmosdbshell.zip -d "$HOME/cosmosdbshell"
    chmod +x "$HOME/cosmosdbshell/cosmosdbshell"
    "$HOME/cosmosdbshell/cosmosdbshell" --version
    
  3. 必要に応じて、抽出ディレクトリをユーザーのPATH環境変数に追加します。 永続的な PATH 変更を行った後、新しいターミナルを開きます。

  4. そのディレクトリから、またはフルパスを指定して実行可能ファイルを起動します。 PATH に配置したら、次のコマンドを実行します。

    cosmosdbshell
    

インストールを確認する

オペレーティング システムターミナルで cosmosdbshell --version を使用するか、拡張機能で起動されたシェル内で version します。 次に、シェルで help を実行して、インストールされているコマンドを検出します。

リリース情報については、リリース ノートを参照してください。 現在のコマンド例に従うときは、古いアーカイブまたはパッケージ バージョンをハードコーディングしないでください。

インストールのトラブルシューティング

  • dotnet適切な SDK が見つからない場合は、グローバル ツール コマンドを再試行する前.NET SDK 10.0 以降をインストールしてください。
  • グローバル ツールが見つからない場合は、ツールのインストール結果を確認し、そのディレクトリが PATH に含まれていることを確認します。Windows では $HOME/.dotnet/tools、macOS および Linux では %USERPROFILE%\.dotnet\tools です。
  • ダウンロードしたバイナリを実行できない場合は、そのオペレーティング システムと CPU アーキテクチャを確認してください。 macOS または Linux で実行アクセス許可を確認します。
  • 拡張機能が別のコピーを使用している場合は、 cosmosDB.shell.path を確認し、そのシェル ターミナルで version を実行します。

AI ツール

これらのアクションを使用して、アシスタントとインストールについて相談します。

ドキュメントのみの取得には、Microsoft Learn MCP サーバーを使用します。 コンパクト ガイド インデックスの場合は、 Shell ドキュメント インデックス (llms.txt) を使用します。 インデックスによってクローラーのアクセス許可が変更されたり、取得が保証されたりすることはありません。

シェル MCP には個別のセットアップが必要であり、構成されたアクセス許可でデータを読み取ったり変更したりできるため、承認する前にツールの呼び出しを確認してください。 資格情報や機密データを共有しないでください。

AI エージェントを接続する
シェルのインストール後にシェル MCP を構成します。

Markdown として読み取る
アシスタントに貼り付けるためにテキスト バージョンを開きます。

ChatGPT に質問する
プラットフォームのインストール手順を選択します。

クロードに質問する
お使いのプラットフォームのインストール手順を選択してください。

ChatGPT と Claude は、パブリック記事の URL とスターター プロンプトのみを受け取ります。 ここで、サインインを求められる場合があります。 取得に失敗した場合は、Markdown テキストをコピーしてください。 これらのリンクでは、データベース アクセスを構成することはできません。