Node.jsドライバーの使用を開始する

Overview

このガイドでは、 MongoDB Node.jsドライバーを使用してMongoDB AtlasでホストされているMongoDBクラスターに接続するアプリケーションを作成する方法について説明します。 Node.jsドライバーは、 MongoDBに接続して通信するために使用できる関数のライブラリです。

Tip

MongoDB Atlas は、MongoDB 配置をホストする完全管理のクラウドデータベースサービスです。このガイドの手順に従い、独自の無料（クレジットカード不要）MongoDB Atlas 配置を作成できます。

このガイドの手順に従って、サンプルNode.jsアプリケーションをMongoDB Atlasデプロイメントに接続します。別のドライバーまたはプログラミング言語を使用してMongoDBに接続する場合は、公式ドライバーのリストを参照してください。

ダウンロードとインストール

依存関係のインストール

開発環境に次の依存関係がインストールされていることを確認してください。

Node.js v16.20.1 以降
npm （Node Package Manager）

Node.jsとnpmをインストールする方法については、 npmドキュメントの「Node.jsとnpm のダウンロードとインストールを参照してください。

プロジェクトディレクトリの作成

shell で次のコマンドを実行して、このプロジェクト用に node_quickstart というディレクトリを作成します。

mkdir node_quickstart

次に、次のコマンドを実行してディレクトリに移動し、 Node.jsプロジェクトを初期化します。

cd node_quickstart
npm init -y

初期化コマンドが正常に完了すると、 node_quickstartディレクトリに package.jsonファイルが作成されます。

Node.js ドライバーをインストール

プロジェクトディレクトリから次のコマンドを実行して、ドライバーをインストールします。

npm install mongodb@6.16

このコマンドは、次のアクションを実行します。

mongodb パッケージと必要な依存関係をダウンロード
パッケージを node_modules ディレクトリに保存
依存関係情報を package.json ファイルに記録

これらの手順を完了すると、ドライバーの依存関係がインストールされた新しいプロジェクトディレクトリが作成されます。

MongoDB 配置の作成

MongoDB Atlas では無料階層の MongoDB 配置を作成して、データを保存および管理できます。 MongoDB Atlas は、MongoDB databaseをクラウドでホストおよび管理します。

Atlas で無料の MongoDB 配置を作成

Atlas の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプルデータを新しい無料階層 MongoDB 配置にロードします。

認証情報を保存する

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

これらの手順を完了すると、Atlas に新しい無料階層の MongoDB 配置、データベースユーザーの認証情報、データベースにサンプルデータがロードされます。

接続文字列の作成

MongoDB配置に接続するには、 接続string とも呼ばれる 接続 URIMongoDB を提供します。これは、配置に接続する方法と接続中の動作をドライバーに指示します。

接続stringには、配置のホスト名またはIPアドレスとポート、認証メカニズム、ユーザー認証情報（該当する場合）、および接続オプションが含まれます。

MongoDB Atlas 接続文字列を見つける

前のセクションで作成した配置の接続文字列を取得するには、Atlas アカウントにログて「Clusters Connect」セクションに移動し、新しい配置の [] ボタンをクリックします。

接続stringのコピー

次のスクリーンショットに示すように、接続文字列の右側にあるボタンをクリックして、接続stringをクリップボードにコピーします。

プレースホルダーを更新します

接続文字列をテキストエディタのファイルに貼り付け、username と <db_password> のプレースホルダーをデータベースユーザーのユーザー名とパスワードに置き換えます。

このファイルを安全な場所に保存して、次のセクションで使用します。

これらの手順を完了すると、データベースのユーザー名とパスワードを含む接続stringが作成されます。

MongoDB に接続する

Node.jsアプリケーションの作成

node_quickstartディレクトリに、アプリケーション用の index.js というファイルを作成します。

以下のコードをコピーして、index.js ファイルに貼り付けます。

const { MongoClient } = require("mongodb");
// Replace the uri string with your connection string
const uri = "<connection string uri>";
const client = new MongoClient(uri);
async function run() {
  try {
    const database = client.db('sample_mflix');
    const movies = database.collection('movies');
    // Queries for a movie that has a title value of 'Back to the Future'
    const query = { title: 'Back to the Future' };
    const movie = await movies.findOne(query);
    console.log(movie);
  } finally {
    await client.close();
  }
}
run().catch(console.dir);

接続文字列の割り当て

<connection string uri> プレースホルダーを、このガイドの接続文字列の作成ステップからコピーした接続文字列に置き換えます。

Node.jsアプリケーションの実行

プロジェクトディレクトリから、次のコマンドを実行してアプリケーションを起動します。

node index.js

出力には、検索された映画ドキュメントの詳細が含まれます。

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

エラーが発生した場合や出力が表示されない場合は、index.jsファイルに適切な接続文字列が指定されていること、およびサンプルデータがロードされていることを確認してください。

これらの手順を完了すると、ドライバーを使用してMongoDBデプロイに接続し、サンプルデータをクエリして、結果を出力する動作するアプリケーションが作成されます。

次のステップ

クイックスタートチュートリアルを完了しました。

注意

この手順で問題が発生した場合は、MongoDB Community フォーラムでサポートを依頼するか、このページの右側または右下にある Rate this page タブを使用してフィードバックを送信してください。

このチュートリアルでは、MongoDB Atlas でホストされている MongoDB 配置に接続し、クエリに一致するドキュメントを検索する Node.js アプリケーションを作成しました。

次のリソースからNode.jsドライバーの詳細を学習します。

MongoDB接続の構成方法については、「MongoDBへの接続」セクションを参照してください。
「 CRUD 操作」セクションでは、読み取りおよび書込み (write) 操作を実行する方法について説明します。

戻る

MongoDB ノードドライバー

接続