インストール mongosh
前提条件
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.4.0-darwin-x64.zip
ARM ベースのコンピューター(M1 または M2)をご使用の場合、次を実行します。
unzip mongosh-2.4.0-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
] タブをクリックします。.tgz
tarball をインストールするには、.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.4.0-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
ダウンロード プログラムでアクセス可能なリストを提供します。