前提条件
MongoDB Shell を使用するには、接続する MongoDB 配置が必要です。
無料のクラウドホスト型配置には、 MongoDB Atlasを使用できます。
MongoDB をローカル配置の実行方法については、「MongoDB のインストール」を参照してください。
サポートされている MongoDB のバージョン
MongoDB Shell を使用して MongoDB バージョン 4.2 以降に接続できます。
サポートされているオペレーティングシステム
MongoDB Shell 2.0.0 は、次のオペレーティング システムにインストールできます。
オペレーティング システム | サポートされているバージョン |
|---|---|
MacOS | 11+(x64 と ARM64) |
Microsoft Windows | Microsoft Windows Server 2016+ Microsoft Windows 10+ |
Linux | Red Hat Enterprise Linux (RHEL) 8+ (x64、ARM64、ppc64le、s390x) Ubuntu 20.04+ (x64 and ARM64) Amazon Linux 2023 (x64 and ARM64) Amazon Linux 2 (x64 and ARM64) Debian 11+ SLES 15 Oracle Linux 8+ running the Red Hat Compatible Kernel (RHCK). MongoDB Shell does not support the Unbreakable Enterprise Kernel (UEK). |
互換性に関する考慮事項
mongosh 2.0.0 以降で起動する場合
Amazon Linux 1、Debian 9、macOS 10.14 はサポートされていません。
Red Hat Enterprise Linux (RHEL) 7、Amazon Linux 2、SUSE Linux Enterprise Server (SLES) 12、Ubuntu 18.04 のサポートは非推奨で、今後の
mongoshリリースで削除される可能性があります。
手順
ご使用のオペレーティング システムに対応するタブを選択してください。
注意
Windows では、mongoshの設定と構成オプションは、%APPDATA%/mongodb/mongosh ディレクトリに保存されます。
MSI からインストール
MongoDB Shell のダウンロード ページを開きます。
MongoDB ダウンロード センターを開きます。
.zip ファイルからインストール
MongoDB Shell のダウンロード ページを開きます。
MongoDB ダウンロード センターを開きます。
お使いのオペレーティング システム用の mongosh インストール アーカイブをダウンロードします。
MongoDB ダウンロード センターから mongosh をダウンロードします。
mongoshバイナリをPATH 環境変数に追加します。
抽出された MongoDB Shell バイナリがファイルシステム内の目的の場所にあることを確認し、その場所をPATH環境変数に追加します。
MongoDB Shell バイナリの場所を PATH 環境変数に追加する方法
Control Panelを開きます。
System and Security カテゴリで、[System] をクリックします。
Advanced system settings をクリックします。[システムのプロパティ] モーダルが表示されます。
[Environment Variables] をクリックします。
[システム変数] セクションで、
Pathを選択し、[Edit] をクリックします。[環境変数の編集] モーダルが表示されます。[New] をクリックして、[
mongosh] バイナリにファイルパスを追加します。[OK] をクリックして変更を確定します。その他のモーダルで [OK] をクリックして変更を確定します。
PATH 環境変数が mongosh を見つけるために正しく構成されていることを確認するには、コマンド プロンプトを開き、mongosh --help コマンドを入力します。PATH が正しく構成されている場合は、有効なコマンドのリストが表示されます。
Homebrew でインストール
重要
Homebrew のシステム要件の全リストについては、Homebrew の Web サイトを参照してください。
macOS 上に mongoshをインストールする場合、Homebrew パッケージ マネージャーの使用が推奨されます。アーカイブからmongoshを手動でインストールする方法については、.zipファイルからのインストールを参照してください。
Considerations
Homebrew でインストールした場合、 mongosh は、クライアント側のフィールド レベルの自動暗号化をサポートしていません。
手順
Homebrew を使用して mongosh をインストールする方法
Homebrew をインストールします。
macOS に Homebrew をインストールする手順については、Homebrew のウェブサイトを参照してください。
.zip ファイルからインストール
ダウンロードした .zip ファイルを使用して mongosh を手動でインストールする方法
MongoDB Shell のダウンロード ページを開きます。
MongoDB ダウンロード センターを開きます。
ダウンロードしたアーカイブからファイルを抽出します。
mongosh .zip アーカイブが格納されているディレクトリに移動し、.zip ファイルを解凍します。
Intel ベースのコンピューターをご使用の場合、次を実行します。
unzip mongosh-2.5.6-darwin-x64.zip
ARM ベースのコンピューター(M1 または M2)をご使用の場合、次を実行します。
unzip mongosh-2.5.6-darwin-arm64.zip
抽出されたアーカイブには、bin フォルダーがあり、mongosh と mongosh_crypt_v1.dylib の 2 つのファイルが含まれています。
ウェブ ブラウザがダウンロード後にアーカイブを自動的に抽出する場合、または unzip コマンドを使用せずにアーカイブを抽出する場合は、バイナリを実行可能にする必要がある場合があります。
バイナリを実行可能にするには、アーカイブを抽出したディレクトリで次のコマンドを実行します。
chmod +x bin/mongosh
ダウンロードしたバイナリを PATH 環境変数に追加します。
次のいずれかを実行できます。
mongoshバイナリを、PATH変数にリストされているディレクトリ(/usr/local/binなど)にコピーします。ダウンロード ファイルを抽出したディレクトリから次のコマンドを実行します。sudo cp mongosh /usr/local/bin/ sudo cp mongosh_crypt_v1.so /usr/local/lib/ MongoDB Shellへのシンボリック リンクを作成します。.tgzアーカイブからファイルを抽出したディレクトリに切り替えます。次のコマンドを実行して、/usr/local/binなど、PATHにすでに存在するディレクトリへのリンクを作成します。sudo ln -s $(pwd)/bin/* /usr/local/bin/
次のタブから、Linux ディストリビューションと目的のパッケージに基づいて、該当するタブを選択します。
Ubuntu 22.04(Jammy)、Ubuntu 20.04(Focal)、Ubuntu 18.04(Bionic)、または Debian に
.debパッケージをインストールするには、[.deb] タブをクリックします。.rpmパッケージを RHEL 、Amazon Linux 2023 、または Amazon Linux 2にインストールするには、[.rpm] タブをクリックします。.tgztarball をインストールするには、.tgzタブをクリックします。
サポートされているプラットフォーム
mongoshは、次のプラットフォームでPPAとして利用できます。
Ubuntu 24.04 (Noble Numbat)
Ubuntu 22.04 (Jammy)
Ubuntu 20.04 (Focal)
Ubuntu 18.04(Bionic)
手順
パッケージ マネジメント システムで使用される公開キーをインポートします。
ターミナルから次のコマンドを実行して、https://www.mongodb.org/static/pgp/server-8.0.asc から、MongoDB 公開 GPG キーをインポートします。
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
前のコマンドは、GPG キーをシステムの /etc/apt/trusted.gpg.d フォルダーに書き込み、そのキーをターミナルに出力します。ターミナルに出力されるキーをコピーしたり保存したりする必要はありません。
gnupg がインストールされていないことを示すエラーが表示された場合は、次の手順を実行します。
次のコマンドを使用して、
gnupgと必要なライブラリをインストールします。sudo apt-get install gnupg キーのインポートを再試行します。
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
MongoDB のリスト ファイルを作成します。
Ubuntu のバージョンに合わせて /etc/apt/sources.list.d/mongodb-org-8.0.list のリスト ファイルを作成します。
Ubuntu のバージョンに合わせて適切なタブをクリックします。ホストで実行されている Ubuntu のバージョンが不明な場合は、ホストでターミナルまたは shell を開き、lsb_release -dc を実行します。
次の手順は、 Ubuntu24.04 (Node Number) 向けのものです。その他のUbuntuリリースについては、適切なタブをクリックしてください。
Ubuntu 24.04(Node Number)の /etc/apt/sources.list.d/mongodb-org-8.0.listファイルを作成します。
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
次の説明は、Ubuntu 22.04(Jammy)向けのものです。その他の Ubuntu リリースについては、適切なタブをクリックしてください。
Ubuntu 22.04(Jammy)用の /etc/apt/sources.list.d/mongodb-org-8.0.list ファイルを作成します。
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
次の手順は、Ubuntu 20.04(Focal)向けのものです。その他の Ubuntu リリースについては、適切なタブをクリックしてください。
Ubuntu 20.04(Focal)用の /etc/apt/sources.list.d/mongodb-org-8.0.list ファイルを作成します。
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
次の手順は、Ubuntu 18.04(Bionic)向けのものです。その他の Ubuntu リリースについては、適切なタブをクリックしてください。
Ubuntu 18 . 04(Bionic)用の/etc/apt/sources.list.d/mongodb-org-8.0.listファイルを作成します。
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
mongoshパッケージをインストールします。
mongosh OpenSSL をサポートしています。システムの OpenSSL インストールを使用するようにmongoshを構成することもできます。
付属の OpenSSL ライブラリと合わせて、mongosh の最新の安定したバージョンをインストールする方法
sudo apt-get install -y mongodb-mongosh
OpenSSL 1.1 ライブラリと合わせて、mongosh をインストールする方法
sudo apt-get install -y mongodb-mongosh-shared-openssl11
OpenSSL 3.0 ライブラリと合わせて、mongosh をインストールする方法
sudo apt-get install -y mongodb-mongosh-shared-openssl3
サポートされているプラットフォーム
mongoshは、次のプラットフォームでyumパッケージとして利用できます。
RHEL
Amazon Linux 2023
Amazon Linux 2
手順
パッケージ マネジメント システム(yum)を構成します。
yum を使用して mongosh を直接インストールできるように、/etc/yum.repos.d/mongodb-org-8.0.repo ファイルを作成します。
RHEL および Amazon Linux には.rpmディストリビューションがあります。
タブを選択して、配信するファイルを選びます。
タブの内容をコピーします。
コンテンツを
.repoファイルに貼り付けます。
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
MongoDB リポジトリから.rpmファイルを直接ダウンロードすることもできます。ダウンロードは、次の順序で整理されています。
Red Hat または CentOS のバージョン(例:
8)MongoDB エディション(例:
mongodb-enterprise)MongoDB リリース バージョン(例:
8.0)アーキテクチャ(例:
x86_64)
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
注意
システムで Amazon Linux 2を使用している場合は、baseurl の2023を2に置き換えます。
MongoDB リポジトリから.rpmファイルを直接ダウンロードすることもできます。ダウンロードは、次の順序で整理されています。
Amazon Linux バージョン(例:
2023)MongoDB リリース バージョン(例:
8.0)アーキテクチャ(例:
x86_64)
mongoshをインストールします。
mongosh OpenSSL をサポートしています。システムの OpenSSL インストールを使用するようにmongoshを構成することもできます。
付属の OpenSSL ライブラリと合わせて、mongosh の最新の安定したバージョンをインストールする方法
sudo yum install -y mongodb-mongosh
OpenSSL 1.1 ライブラリと合わせて、mongosh をインストールする方法
sudo yum install -y mongodb-mongosh-shared-openssl11
OpenSSL 3.0 ライブラリと合わせて、mongosh をインストールする方法
sudo yum install -y mongodb-mongosh-shared-openssl3
手順
MongoDB Shell のダウンロード ページを開きます。
MongoDB ダウンロード センターを開きます。
Linux 64-bit .tgz パッケージをダウンロードします。
お使いのオペレーティング システムに適したバージョンの mongosh をダウンロードしてください。MongoDB は、システムの OpenSSL インストールを使用するバージョンの mongosh も提供しています。
「MongoDB ダウンロード センター」を参照してください。
ダウンロードしたアーカイブからファイルを抽出します。
.tgz アーカイブが格納されているディレクトリに移動し、アーカイブを解凍します。
.tgz パッケージの名前は、ダウンロードしたバージョンによって異なります。次のコマンドの .tgz パッケージ名を、ダウンロードしたパッケージの名前に置き換えて、コマンドを実行します。
tar -zxvf mongosh-2.5.6-linux-x64.tgz
抽出されたアーカイブには、bin フォルダーがあり、mongosh と mongosh_crypt_v1.so の 2 つのファイルが含まれています。
ウェブ ブラウザがダウンロード後にアーカイブを自動的に抽出する場合、または tar コマンドを使用せずにアーカイブを抽出する場合は、バイナリを実行可能にする必要がある場合があります。
バイナリを実行可能にするには、アーカイブを抽出したディレクトリで次のコマンドを実行します。
chmod +x bin/mongosh
ダウンロードしたバイナリを PATH 環境変数に追加します。
次のいずれかを実行できます。
mongoshバイナリを、PATH変数にリストされているディレクトリ(/usr/local/binなど)にコピーします。ダウンロード ファイルを抽出したディレクトリから次のコマンドを実行します。sudo cp mongosh /usr/local/bin/ sudo cp mongosh_crypt_v1.so /usr/local/lib/ MongoDB Shellへのシンボリック リンクを作成します。.tgzアーカイブからファイルを抽出したディレクトリに切り替えます。次のコマンドを実行して、/usr/local/binなど、PATHにすでに存在するディレクトリへのリンクを作成します。sudo ln -s $(pwd)/bin/* /usr/local/bin/
次のステップ
mongosh を正常にインストールしたら、「MongoDB 配置に接続する方法」を参照してください。
MongoDB は、アプリケーションを通じてアクセスできるmongoshダウンロード プログラムでアクセス可能なリストを提供します。