MongoDB

ローカル MongoDB データベースの設定

シェア

概要

このページでは、MongoDB データベースサーバーとデフォルトのmongo シェルをインストールおよび設定する方法について説明します。このガイドでは、ローカルアクセス用にこれらのコンポーネントをコンピューターにインストールおよび設定する方法について説明します。

このガイドでは、次のプラットフォームについて説明します。

作業するプラットフォームに一致するセクションに移動します。

Windows に MongoDB を設定する

注:このガイドは MongoDB バージョン 4 向けに書かれており、執筆時からインストール手順が変更されています。Windows 用のより新しいバージョンの MongoDB をインストールするには、MongoDB の Windows インストールに関するドキュメントを確認してください。

MongoDB は、データベースをインストールおよび設定するためのネイティブ Windows インストーラーを提供しています。

MongoDB Community Server のダウンロードページにアクセスし、Windows で利用可能な最新の msi パッケージを選択してください。ダウンロードをクリックしてインストーラーを入手します。

MongoDB download page

ダウンロードが完了したら、ファイルをダブルクリックしてインストーラーを実行します(プログラムがコンピューターに変更を加えることを許可するかどうかを確認する必要がある場合があります)。

ダウンロードが完了したら、ファイルをダブルクリックしてインストーラーを実行します(プログラムがコンピューターに変更を加えることを許可するかどうかを確認する必要がある場合があります)。

MongoDB installer greeting

最初のページで次へをクリックして続行します。

次のページで、エンドユーザーライセンス契約を読んで確認し、条項に同意することを確認するボックスをチェックします。

MongoDB EULA agreement

次へをクリックして続行します。

次のページでは、インストールするコンポーネントを選択できます。

MongoDB installation type

すべての MongoDB コンポーネントをインストールするには、Complete インストールを選択します。

次の画面では、インストール場所やその他の構成項目をカスタマイズできます。

MongoDB service configuration

デフォルト値はほとんどのシナリオでうまく機能するはずです。選択内容に満足したら、次へをクリックします。

次に、MongoDB Compass をインストールするかどうかを選択します。これは、MongoDB サーバーに接続して管理するために使用できるグラフィカルインターフェイスです。このコンポーネントはオプションです。

MongoDB compass installation

決定したら、次へをクリックします。

次の画面は、インストール前の構成が完了し、MongoDB をインストールする準備ができたことを示しています。

MongoDB ready to install

インストールをクリックして、すべての MongoDB コンポーネントのコンピューターへのインストールを開始します。

インストールが完了すると、MongoDB Compass が自動的に開く場合があります。その場合は、今は無視してかまいません。

MongoDB がインストールされたので、サーバーを実行し、付属の MongoDB シェルを使用して接続できます。これらのコンポーネントはどちらもコマンドラインから実行されます。

スタートメニューで、cmd と入力し、Windows コマンドプロンプトをクリックしてターミナルセッションを起動します。

サーバーを実行する前に、MongoDB がデータを保存するデフォルトディレクトリ \data\db を作成する必要があります。次のコマンドを入力してディレクトリを作成できます。

md \data\db

MongoDB create data directory

その後、mongod.exe 実行可能ファイルへの絶対パスを入力して、MongoDB サーバーを起動できます。パスの一部には、インストールした MongoDB のバージョン番号が含まれているため、インストールパスは以下で使用されているものとわずかに異なる場合があります。

C:\Program Files\MongoDB\Server\4.4\bin\mongod.exe

MongoDB run server

すべて正常に機能している場合、サーバーが起動し、診断情報をコンソールに出力します。起動が成功したことを確認するには、クライアントからの接続を受け入れていることを示すメッセージを探します。

MongoDB waiting for connections

実行中の MongoDB サーバーに接続するには、別のコマンドプロンプトウィンドウを開きます。以前と同様に、実行可能ファイルへの絶対パスを入力する必要があります。

この場合、mongo.exe 実行可能ファイルを実行しようとしているため、バージョン番号の違いを考慮すると、コマンドは次のようになります。

C:\Program Files\MongoDB\Server\4.4\bin\mongo.exe

MongoDB run shell

シェルがサーバーに接続すると、接続に関する情報が出力され、MongoDB プロンプトが表示されます。

MongoDB connect to database

サーバーがコマンドに応答していることを確認するには、show dbs コマンドを実行します。

MongoDB show_dbs

MongoDB Compass コンポーネントをインストールした場合、グラフィカルインターフェイスから MongoDB サーバーに接続して管理することもできます。

MongoDB Compass を開いて開始します。

最初の画面では、接続文字列を入力して、実行中の MongoDB サーバーに接続する機会が与えられます。

MongoDB compass connect

情報を入力せずに接続をクリックすると、Compass はデフォルト構成で実行されているローカル MongoDB サーバーへの接続を自動的に試行します。

接続をクリックして、実行している MongoDB サーバーに接続します。

Compass がローカルサーバーに接続すると、データベースに関する情報が表示され、使いやすいグラフィカルインターフェイスを使用してデータを管理できます。

MongoDB compass running

MongoDB サーバーでの作業が完了したら、各コンポーネントを停止できます。

MongoDB Compass で、接続メニューをクリックし、切断を選択して MongoDB サーバーへの接続を切断します。その後、MongoDB Compass アプリケーションを安全に閉じることができます。

MongoDB シェルで、exit と入力してセッションを終了します。

MongoDB サーバーを停止するには、CTRL-c を入力して、サーバーコンポーネントのシャットダウンプロセスを開始します。

macOS に MongoDB を設定する

MongoDB は、データベースをインストールおよび設定するためのネイティブ macOS インストーラーを提供しています。

MongoDB Community Server のダウンロードページにアクセスし、macOS で利用可能な最新の .tgz ファイルを選択してください。ダウンロードをクリックしてインストーラーを入手します。

MongoDB download page

ダウンロードが完了したら、新しいターミナルウィンドウを開き、MongoDB .tgz ファイルをダウンロードした場所に移動します。

.tgz ファイルの内容を抽出するには、次のように入力します。

tar xzvf mongodb-macos*.tgz

MongoDB extract tarball

抽出したディレクトリに移動し、実行可能ファイルを /usr/local/bin ディレクトリにコピーして、オペレーティングシステムが実行可能ファイルを検索するために使用する PATH の一部になるようにします。

cd mongodb-macos*
sudo cp bin/* /usr/local/bin

MongoDB copy executables

MongoDB サーバーを起動する前に、必要なディレクトリをいくつか作成する必要があります。

まず、次のコマンドを入力して MongoDB サーバーのデータディレクトリを作成します。

sudo mkdir -p /usr/local/var/mongodb

MongoDB create data directory

次に、MongoDB がログを保存するために使用できるディレクトリを作成します。

sudo mkdir -p /usr/local/var/log/mongodb

MongoDB create log directory

次に、現在のユーザーに新しいディレクトリの所有権を与えて、ユーザーでサーバーを実行するときに MongoDB がそれらに書き込めるようにします。

sudo chown $USER /usr/local/var/mongodb
sudo chown $USER /usr/local/var/log/mongodb

MongoDB reassign ownership

これで、MongoDB サーバーに必要なディレクトリが整ったので、作成したパスを使用して MongoDB サーバーを起動できます。次のように入力します。

mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log --fork

MongoDB start server

macOS のバージョンによっては、MongoDB サーバーの実行がブロックされたことを示すプロンプトが表示される場合があります。

MongoDB execution blocked

これは、Apple が認識しないアプリケーションが実行されるたびにアクティブになるセキュリティポリシーです。システム環境設定に移動し、セキュリティとプライバシーをクリックして、MongoDB サーバーエントリの横にある許可するをクリックすると、MongoDB サーバーの例外を許可できます。

MongoDB allow execution

コマンドを再度実行すると、別のプロンプトが表示される可能性があります。ただし、今回は、開くをクリックしてプログラムの実行を許可するオプションがあります。

MongoDB confirm execution

MongoDB サーバーが実行されているので、MongoDB シェルを起動してサーバーに接続し、管理できます。MongoDB シェルを実行するには、次のように入力します。

mongo

MongoDB run_shell

macOS のバージョンによっては、実行が再度ブロックされたという通知を受け取る場合があります。その場合は、以前と同じ手順で例外を許可し、MongoDB シェルを実行することを確認します。

すべてがうまくいけば、MongoDB シェルがローカル MongoDB サーバーに接続し、MongoDB プロンプトが表示されます。

MongoDB shell connected

サーバーがコマンドに応答していることを確認するには、show dbs コマンドを実行します。

show dbs

MongoDB show databases

オプションで、MongoDB compass と呼ばれるグラフィカル MongoDB マネージャーをインストールすることもできます。Compass をインストールするには、MongoDB インストールに含まれている install_compass コマンドを使用します。

install_compass

MongoDB install compass

上記の図のように、インストーラーでエラーが発生することがありますが、通常は実際のインストールには影響しません。

最初の画面では、接続文字列を入力して、実行中の MongoDB サーバーに接続する機会が与えられます。

MongoDB compass connect

情報を入力せずに接続をクリックすると、Compass はデフォルト構成で実行されているローカル MongoDB サーバーへの接続を自動的に試行します。

接続をクリックして、実行している MongoDB サーバーに接続します。

Compass がローカルサーバーに接続すると、データベースに関する情報が表示され、使いやすいグラフィカルインターフェイスを使用してデータを管理できます。

MongoDB compass connect

MongoDB サーバーでの作業が完了したら、各コンポーネントを停止できます。

MongoDB Compass で、接続メニューをクリックし、切断を選択して MongoDB サーバーへの接続を切断します。その後、MongoDB Compass アプリケーションを安全に閉じることができます。

MongoDB シェルで、exit と入力してセッションを終了します。

MongoDB サーバーを停止するには、次のコマンドを入力して MongoDB サーバープロセスを見つけて強制終了します。

pkill mongod

Linux に MongoDB を設定する

インストール方法は、使用している Linux ディストリビューションによって異なります。ご使用の Linux ディストリビューションに一致する以下のセクションに従ってください。

Debian および Ubuntu

Ubuntu または Debian に MongoDB をインストールする最適な方法は、MongoDB が管理するリポジトリを使用するようにシステムを構成することです。

まず、次のコマンドを入力して、MongoDB GPG キーを信頼できる apt 署名キーのコレクションにダウンロードします。

curl -L https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -

次に、次のコマンドを入力して、オペレーティングシステムで利用可能な最新バージョンの MongoDB を見つけて記録します。

LATEST_MONGO_VERSION=$(. /etc/os-release && curl -L repo.mongodb.org/apt/${ID}/dists/${VERSION_CODENAME}/mongodb-org | grep -Eo '[0-9]+\.[0-9]+' | sort -V | tail -1)

その後、オペレーティングシステムに適した apt リポジトリを構成します。

Ubuntu を実行している場合は、次のように入力します。

(. /etc/os-release && echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/${ID} ${VERSION_CODENAME}/mongodb-org/${LATEST_MONGO_VERSION} multiverse") | sudo tee /etc/apt/sources.list.d/mongodb-org-${LATEST_MONGO_VERSION}.list

Debian を実行している場合は、代わりに次のように入力します。

(. /etc/os-release && echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/${ID} ${VERSION_CODENAME}/mongodb-org/${LATEST_MONGO_VERSION} main") | sudo tee /etc/apt/sources.list.d/mongodb-org-${LATEST_MONGO_VERSION}.list

MongoDB apt リポジトリが構成されたら、ローカルパッケージインデックスを更新し、次のコマンドを入力して MongoDB をインストールします。

sudo apt update
sudo apt install mongodb-org

ソフトウェアがインストールされたら、次のコマンドを入力して MongoDB サーバーを起動できます。

sudo systemctl start mongod.service

オプションで、enable コマンドを使用して、起動時に MongoDB を自動的に起動することもできます。

sudo systemctl enable mongod.service

MongoDB サーバーが実行されているので、MongoDB シェルを起動してサーバーに接続し、管理できます。MongoDB シェルを実行するには、次のように入力します。

mongo

すべてがうまくいけば、MongoDB シェルがローカル MongoDB サーバーに接続し、MongoDB プロンプトが表示されます。サーバーがコマンドに応答していることを確認するには、show dbs コマンドを実行します。

show dbs

MongoDB サーバーでの作業が完了したら、各コンポーネントを停止できます。

MongoDB シェルで、exit と入力してセッションを終了します。

MongoDB サーバーを停止するには、次のように入力します。

sudo systemctl stop mongod.service

CentOS

CentOS に MongoDB をダウンロードしてインストールする最適な方法は、MongoDB によって管理されているリポジトリを使用することです。

まず、次のコマンドを入力して、オペレーティングシステムで利用可能な最新バージョンの MongoDB を見つけて記録します。

LATEST_MONGO_VERSION=$(. /etc/os-release && curl -L repo.mongodb.org/yum/redhat/${VERSION_ID}/mongodb-org | grep -Eo '[0-9]+\.[0-9]+' | sort -V | tail -1)

次に、先ほどクエリしたバージョン情報を使用してリポジトリ定義ファイルを作成します。次のコマンドを入力して、リポジトリファイルをファイルシステムに書き込むことができます。

sudo tee /etc/yum.repos.d/mongodb-org-${LATEST_MONGO_VERSION}.repo << EOF
[mongodb-org-${LATEST_MONGO_VERSION}]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/${LATEST_MONGO_VERSION}/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-${LATEST_MONGO_VERSION}.asc
EOF

リポジトリ定義ファイルが配置されたら、次のコマンドを入力して MongoDB サーバーパッケージをインストールできます。

sudo yum install mongodb-org

ソフトウェアがインストールされたら、次のコマンドを入力して MongoDB サーバーを起動できます。

sudo systemctl start mongod.service

オプションで、enable コマンドを使用して、起動時に MongoDB を自動的に起動することもできます。

sudo systemctl enable mongod.service

MongoDB サーバーが実行されているので、MongoDB シェルを起動してサーバーに接続し、管理できます。MongoDB シェルを実行するには、次のように入力します。

mongo

すべてがうまくいけば、MongoDB シェルがローカル MongoDB サーバーに接続し、MongoDB プロンプトが表示されます。サーバーがコマンドに応答していることを確認するには、show dbs コマンドを実行します。

show dbs

MongoDB サーバーでの作業が完了したら、各コンポーネントを停止できます。

MongoDB シェルで、exit と入力してセッションを終了します。

MongoDB サーバーを停止するには、次のように入力します。

sudo systemctl stop mongod.service
著者について
Justin Ellingwood

Justin Ellingwood

Justin は 2013 年からデータベース、Linux、インフラストラクチャ、および開発者ツールについて執筆しています。現在は妻と 2 羽のウサギと一緒にベルリンに住んでいます。彼は通常、三人称で書く必要はありません。これは関係者全員にとって安心です。