エディター統合用のVisual Studio Code拡張機能、ターミナル アクセス用の.NET グローバル ツール、または.NETをインストールしない場合は自己完結型バイナリを選択します。
オプション 1: Visual Studio Code 拡張機能
Azure Cosmos DB拡張機能には、シェルをインストールして起動するためのフローが含まれています。
Visual Studio Codeで拡張機能を開きます。
Microsoftによって発行されたAzure Cosmos DBを検索してインストールします。 その拡張 ID は
ms-azuretools.vscode-cosmosdb。コマンド パレットを開き、Azure Cosmos DB Shell の起動を実行します。
シェルが使用できない場合は、インストールまたは修復の指示に従ってください。
シェル ターミナルで、次を実行します:
version
既にシェルを別の場所にインストールしている場合は、cosmosDB.shell.pathを完全な実行可能パスに設定します。 拡張機能で管理されたコピーをインストールしても、PATHがオペレーティング システムのcosmosdbshellに追加されるとは限りません。
拡張機能をオフラインでインストールするには、拡張機能リリースから VSIX をダウンロードし、拡張機能>...>VSIX からインストール を選択します。 Visual Studio Code バージョンと互換性のあるリリースを使用します。
起動と MCP の設定については、「Visual Studio Codeでシェルを使用する」を参照してください。
オプション 2: .NET グローバル ツール
このメソッドには.NET SDK 10.0 以降が必要です。 ランタイムのみをインストールしても、 dotnet tool コマンドは提供されません。
オペレーティング システム ターミナルからインストールされている SDK を確認します。
dotnet --list-sdksグローバル ツールをインストール:
dotnet tool install --global CosmosDBShell実行可能ファイルを確認します:
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 ランタイムが必要です。
次のコマンドで使用するために、アーカイブをダウンロードし、ダウンロードしたファイルの名前を
cosmosdbshell.zipに変更します。ユーザーが書き込み可能なディレクトリにアーカイブを抽出します。
Windows では、PowerShell を使用します:
Expand-Archive -Path .\cosmosdbshell.zip -DestinationPath "$HOME\cosmosdbshell" & "$HOME\cosmosdbshell\cosmosdbshell.exe" --versionmacOS または Linux では、
unzipを備えたターミナルを使用します。mkdir -p "$HOME/cosmosdbshell" unzip cosmosdbshell.zip -d "$HOME/cosmosdbshell" chmod +x "$HOME/cosmosdbshell/cosmosdbshell" "$HOME/cosmosdbshell/cosmosdbshell" --version必要に応じて、抽出ディレクトリをユーザーの
PATH環境変数に追加します。 永続的なPATH変更を行った後、新しいターミナルを開きます。そのディレクトリから、またはフルパスを指定して実行可能ファイルを起動します。
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 テキストをコピーしてください。 これらのリンクでは、データベース アクセスを構成することはできません。