MongoDB を Node.js に接続する方法: 包括的なガイド

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 (オブジェクト ドキュメント マッパー) です。

mongoose をインストールします:

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. 接続のテスト

接続を確認するには:

• Create a simple schema and model using Mongoose.
• Insert a document into the MongoDB collection.
• Fetch and log the document to the console.

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);
  });

Run your Node.js script, and if everything is set up correctly, you should see your test document logged in the console.

6. Conclusion

Connecting MongoDB with Node.js can enhance your web applications by providing a robust database solution. By following this guide, you’ve set up a foundational connection using Mongoose, paving the way for more advanced operations and queries in the future.

以上がMongoDB を Node.js に接続する方法: 包括的なガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。