MongoDB を Node.js に接続することは、現代の Web 開発者にとって重要なスキルです。このガイドでは、これらの強力なテクノロジーを簡単に統合できるように、プロセスを段階的に説明します。

導入

MongoDB は、主要な NoSQL データベースであり、その柔軟性と拡張性で有名です。強力な JavaScript ランタイムである Node.js を使用すると、効率的でスケーラブルな Web アプリケーションを構築できます。この接続をシームレスに行うための手順を詳しく見てみましょう。

目次

1. 前提条件
2. MongoDB のセットアップ
3. Node.js プロジェクトの開始
4. Mongoose を使用した MongoDB への接続
5. 接続をテストしています
6. 結論

1. 前提条件

• JavaScript と Node.js の基本的な理解
• Node.js と npm (ノード パッケージ マネージャー) がシステムにインストールされています。
• MongoDB アカウントとローカル/リモート MongoDB サーバー。

2.MongoDBのセットアップ

MongoDB をマシンにインストールするか、MongoDB Atlas 経由でクラウド インスタンスをセットアップすることから始めます。すぐに必要になるため、接続文字列を保存してください。

MongoDB Atlas での MongoDB のセットアップ

2.1 サインアップまたはログイン

• MongoDB Atlas Web サイトに移動します: https://www.mongodb.com/cloud/atlas
• MongoDB Atlas を初めて使用する場合は、新しいアカウントにサインアップしてください。それ以外の場合は、資格情報を使用してログインします。

2.2 新しいクラスターの作成

• ログインしたら、[新しいクラスターの作成] ボタンをクリックします。
• MongoDB Atlas は、M0 サンドボックスとして知られる無料枠を提供します。これは初心者や小規模プロジェクトにとって良い出発点です。

2.3 クラウドプロバイダーとリージョンの選択

• お好みのクラウド プロバイダー (AWS、Google Cloud、または Azure) を選択します。
• 地域を選択してください。一部のリージョンは無料枠をサポートしているため、レイテンシを短縮するために、プライマリ ユーザー ベースに最も近いリージョンを必ず選択してください。

2.4 クラスター設定の構成

• デフォルト設定はほとんどのユースケースに適していますが、必要に応じてクラスターの名前やその他の設定を変更できます。

2.5 追加構成の追加 (オプション)

• 追加設定では、バックアップの構成、監視の有効化、またはその他の高度な構成を行うことができます。ほとんどの初心者にとっては、デフォルト設定で十分です。

2.6 ネットワーク アクセスのセットアップ

• 左側のパネルの「データベース アクセス」セクションをクリックします。
• ユーザー名と強力なパスワードを使用して新しいユーザーを追加します。これらの資格情報は、アプリケーションを MongoDB に接続するために必要となるため、覚えておいてください。
• 「IP ホワイトリスト」タブで、「IP アドレスの追加」をクリックします。セキュリティのため、アクセスが必要な IP のみをホワイトリストに登録します。開発目的の場合は、「どこからでもアクセスを許可する」を選択できますが、これは、セキュリティ上の懸念から実稼働環境には推奨されません。

2.7 接続文字列を取得する

• クラスターが起動して実行されたら、「接続」ボタンをクリックします。
• 「アプリケーションを接続する」を選択します。
• ドライバーのバージョンを選択し、接続文字列をコピーします。これは、MongoDB に接続するためにアプリケーションで使用する文字列です。接続文字列を、前に作成した MongoDB ユーザーのパスワードに置き換えます。

2.8 アプリケーションを接続する

• アプリケーションでコピーした接続文字列を使用して、MongoDB クラウド インスタンスとの対話を開始します。

2.9 監視と管理

• MongoDB Atlas は、クエリ、パフォーマンス、その他のメトリクスを監視できるダッシュボードを提供します。これを定期的にチェックして、データベースの健全性とパフォーマンスを確認してください。

3. Node.js プロジェクトの開始

ターミナルまたはコマンド プロンプト:

mkdir mongo-node-connection
cd mongo-node-connection
npm init -y

上記のコードは、新しい Node.js プロジェクトを作成します。

4. Mongoose を使用した MongoDB への接続

Mongoose は、Node.js と MongoDB 間の接続を容易にする人気の ODM (オブジェクト ドキュメント マッパー) です。

マングースをインストールします:

npm install mongoose

MongoDB に接続します:

const mongoose = require('mongoose');

// Your MongoDB connection string
const dbURI = 'YOUR_MONGODB_CONNECTION_STRING';

mongoose.connect(dbURI, { useNewUrlParser: true, useUnifiedTopology: true })
  .then(() => console.log('Connected to MongoDB'))
  .catch((error) => console.error('Connection error', error));

注: 「YOUR_MONGODB_CONNECTION_STRING」を実際の MongoDB 接続文字列に置き換えます。

5. 接続のテスト

接続を確認するには:

• Mongoose を使用して簡単なスキーマとモデルを作成します。
• MongoDB コレクションにドキュメントを挿入します。
• ドキュメントをフェッチしてコンソールに記録します。

const testSchema = new mongoose.Schema({
  name: String,
  testField: String
});

const TestModel = mongoose.model('Test', testSchema);

const testData = new TestModel({
  name: 'Node-Mongo Connection Test',
  testField: 'It works!'
});

testData.save()
  .then(doc => {
    console.log('Test document saved:', doc);
  })
  .catch(error => {
    console.error('Error saving test document:', error);
  });

Node.js スクリプトを実行します。すべてが正しく設定されていれば、テスト ドキュメントがコンソールに記録されるはずです。

6. 結論

MongoDB を Node.js に接続すると、堅牢なデータベース ソリューションが提供され、Web アプリケーションが強化されます。このガイドに従うことで、Mongoose を使用した基本的な接続がセットアップされ、将来のより高度な操作やクエリへの道が開かれます。