MongoDB
ローカル MongoDB データベースの設定
概要
このページでは、MongoDB データベースサーバーとデフォルトのmongo
シェルをインストールおよび設定する方法について説明します。このガイドでは、ローカルアクセス用にこれらのコンポーネントをコンピューターにインストールおよび設定する方法について説明します。
このガイドでは、次のプラットフォームについて説明します。
作業するプラットフォームに一致するセクションに移動します。
MongoDB を使用している場合は、Prisma のMongoDB コネクタをチェックしてください!Prisma Client を使用すると、本番環境の MongoDB データベースを安心して管理できます。
MongoDB と Prisma の使用を開始するには、ゼロから始めるガイド、または既存のプロジェクトに追加する方法をチェックしてください。
Windows に MongoDB を設定する
注:このガイドは MongoDB バージョン 4 向けに書かれており、執筆時からインストール手順が変更されています。Windows 用のより新しいバージョンの MongoDB をインストールするには、MongoDB の Windows インストールに関するドキュメントを確認してください。
MongoDB は、データベースをインストールおよび設定するためのネイティブ Windows インストーラーを提供しています。
MongoDB Community Server のダウンロードページにアクセスし、Windows で利用可能な最新の msi パッケージを選択してください。ダウンロードをクリックしてインストーラーを入手します。
ダウンロードが完了したら、ファイルをダブルクリックしてインストーラーを実行します(プログラムがコンピューターに変更を加えることを許可するかどうかを確認する必要がある場合があります)。
ダウンロードが完了したら、ファイルをダブルクリックしてインストーラーを実行します(プログラムがコンピューターに変更を加えることを許可するかどうかを確認する必要がある場合があります)。
最初のページで次へをクリックして続行します。
次のページで、エンドユーザーライセンス契約を読んで確認し、条項に同意することを確認するボックスをチェックします。
次へをクリックして続行します。
次のページでは、インストールするコンポーネントを選択できます。
すべての MongoDB コンポーネントをインストールするには、Complete インストールを選択します。
次の画面では、インストール場所やその他の構成項目をカスタマイズできます。
デフォルト値はほとんどのシナリオでうまく機能するはずです。選択内容に満足したら、次へをクリックします。
次に、MongoDB Compass をインストールするかどうかを選択します。これは、MongoDB サーバーに接続して管理するために使用できるグラフィカルインターフェイスです。このコンポーネントはオプションです。
決定したら、次へをクリックします。
次の画面は、インストール前の構成が完了し、MongoDB をインストールする準備ができたことを示しています。
インストールをクリックして、すべての MongoDB コンポーネントのコンピューターへのインストールを開始します。
インストールが完了すると、MongoDB Compass が自動的に開く場合があります。その場合は、今は無視してかまいません。
MongoDB がインストールされたので、サーバーを実行し、付属の MongoDB シェルを使用して接続できます。これらのコンポーネントはどちらもコマンドラインから実行されます。
スタートメニューで、cmd
と入力し、Windows コマンドプロンプトをクリックしてターミナルセッションを起動します。
サーバーを実行する前に、MongoDB がデータを保存するデフォルトディレクトリ \data\db
を作成する必要があります。次のコマンドを入力してディレクトリを作成できます。
md \data\db
その後、mongod.exe
実行可能ファイルへの絶対パスを入力して、MongoDB サーバーを起動できます。パスの一部には、インストールした MongoDB のバージョン番号が含まれているため、インストールパスは以下で使用されているものとわずかに異なる場合があります。
C:\Program Files\MongoDB\Server\4.4\bin\mongod.exe
すべて正常に機能している場合、サーバーが起動し、診断情報をコンソールに出力します。起動が成功したことを確認するには、クライアントからの接続を受け入れていることを示すメッセージを探します。
実行中の MongoDB サーバーに接続するには、別のコマンドプロンプトウィンドウを開きます。以前と同様に、実行可能ファイルへの絶対パスを入力する必要があります。
この場合、mongo.exe
実行可能ファイルを実行しようとしているため、バージョン番号の違いを考慮すると、コマンドは次のようになります。
C:\Program Files\MongoDB\Server\4.4\bin\mongo.exe
シェルがサーバーに接続すると、接続に関する情報が出力され、MongoDB プロンプトが表示されます。
サーバーがコマンドに応答していることを確認するには、show dbs
コマンドを実行します。
MongoDB Compass コンポーネントをインストールした場合、グラフィカルインターフェイスから MongoDB サーバーに接続して管理することもできます。
MongoDB Compass を開いて開始します。
最初の画面では、接続文字列を入力して、実行中の MongoDB サーバーに接続する機会が与えられます。
情報を入力せずに接続をクリックすると、Compass はデフォルト構成で実行されているローカル MongoDB サーバーへの接続を自動的に試行します。
接続をクリックして、実行している MongoDB サーバーに接続します。
Compass がローカルサーバーに接続すると、データベースに関する情報が表示され、使いやすいグラフィカルインターフェイスを使用してデータを管理できます。
MongoDB サーバーでの作業が完了したら、各コンポーネントを停止できます。
MongoDB Compass で、接続メニューをクリックし、切断を選択して MongoDB サーバーへの接続を切断します。その後、MongoDB Compass アプリケーションを安全に閉じることができます。
MongoDB シェルで、exit
と入力してセッションを終了します。
MongoDB サーバーを停止するには、CTRL-c を入力して、サーバーコンポーネントのシャットダウンプロセスを開始します。
MongoDB と Prisma の使用を開始する場合は、ゼロから始めるガイド、または既存のプロジェクトに追加する方法をチェックしてください。
macOS に MongoDB を設定する
MongoDB は、データベースをインストールおよび設定するためのネイティブ macOS インストーラーを提供しています。
MongoDB Community Server のダウンロードページにアクセスし、macOS で利用可能な最新の .tgz
ファイルを選択してください。ダウンロードをクリックしてインストーラーを入手します。
ダウンロードが完了したら、新しいターミナルウィンドウを開き、MongoDB .tgz
ファイルをダウンロードした場所に移動します。
.tgz
ファイルの内容を抽出するには、次のように入力します。
tar xzvf mongodb-macos*.tgz
抽出したディレクトリに移動し、実行可能ファイルを /usr/local/bin
ディレクトリにコピーして、オペレーティングシステムが実行可能ファイルを検索するために使用する PATH
の一部になるようにします。
cd mongodb-macos*sudo cp bin/* /usr/local/bin
MongoDB サーバーを起動する前に、必要なディレクトリをいくつか作成する必要があります。
まず、次のコマンドを入力して MongoDB サーバーのデータディレクトリを作成します。
sudo mkdir -p /usr/local/var/mongodb
次に、MongoDB がログを保存するために使用できるディレクトリを作成します。
sudo mkdir -p /usr/local/var/log/mongodb
次に、現在のユーザーに新しいディレクトリの所有権を与えて、ユーザーでサーバーを実行するときに MongoDB がそれらに書き込めるようにします。
sudo chown $USER /usr/local/var/mongodbsudo chown $USER /usr/local/var/log/mongodb
これで、MongoDB サーバーに必要なディレクトリが整ったので、作成したパスを使用して MongoDB サーバーを起動できます。次のように入力します。
mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log --fork
macOS のバージョンによっては、MongoDB サーバーの実行がブロックされたことを示すプロンプトが表示される場合があります。
これは、Apple が認識しないアプリケーションが実行されるたびにアクティブになるセキュリティポリシーです。システム環境設定に移動し、セキュリティとプライバシーをクリックして、MongoDB サーバーエントリの横にある許可するをクリックすると、MongoDB サーバーの例外を許可できます。
コマンドを再度実行すると、別のプロンプトが表示される可能性があります。ただし、今回は、開くをクリックしてプログラムの実行を許可するオプションがあります。
MongoDB サーバーが実行されているので、MongoDB シェルを起動してサーバーに接続し、管理できます。MongoDB シェルを実行するには、次のように入力します。
mongo
macOS のバージョンによっては、実行が再度ブロックされたという通知を受け取る場合があります。その場合は、以前と同じ手順で例外を許可し、MongoDB シェルを実行することを確認します。
すべてがうまくいけば、MongoDB シェルがローカル MongoDB サーバーに接続し、MongoDB プロンプトが表示されます。
サーバーがコマンドに応答していることを確認するには、show dbs
コマンドを実行します。
show dbs
オプションで、MongoDB compass と呼ばれるグラフィカル MongoDB マネージャーをインストールすることもできます。Compass をインストールするには、MongoDB インストールに含まれている install_compass
コマンドを使用します。
install_compass
上記の図のように、インストーラーでエラーが発生することがありますが、通常は実際のインストールには影響しません。
最初の画面では、接続文字列を入力して、実行中の MongoDB サーバーに接続する機会が与えられます。
情報を入力せずに接続をクリックすると、Compass はデフォルト構成で実行されているローカル MongoDB サーバーへの接続を自動的に試行します。
接続をクリックして、実行している MongoDB サーバーに接続します。
Compass がローカルサーバーに接続すると、データベースに関する情報が表示され、使いやすいグラフィカルインターフェイスを使用してデータを管理できます。
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 updatesudo 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 Repositorybaseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/${LATEST_MONGO_VERSION}/x86_64/gpgcheck=1enabled=1gpgkey=https://www.mongodb.org/static/pgp/server-${LATEST_MONGO_VERSION}.ascEOF
リポジトリ定義ファイルが配置されたら、次のコマンドを入力して 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
MongoDB を使用している場合は、Prisma のMongoDB コネクタをチェックしてください!Prisma Client を使用すると、本番環境の MongoDB データベースを安心して管理できます。
MongoDB と Prisma の使用を開始するには、ゼロから始めるガイド、または既存のプロジェクトに追加する方法をチェックしてください。