接続ガイド

接続URI

接続 URI は、ドライバが MongoDB 配置に接続するための指示のセットです。これは、ドライバーに MongoDB への接続方法と接続中の動作を指示します。次の例は、接続 URI の各部分を示しています。

この例では、DNS SRV レコードを持つ Atlas MongoDB 配置に接続します。詳細については、DNS シードリスト接続形式のドキュメントを参照してください。この形式を使うと、柔軟な配置が可能になるとともに、クライアントを再構成しなくてもサーバーをローテーションして変更することができます。

DNS SRV アドレスを持たないインスタンスまたはレプリカセットに接続する場合は、プロトコルとして標準接続文字列形式を指定する mongodb を使用する必要があります。

パスワードベースの認証を使用している場合、プロトコルの後の接続文字列の次の部分には認証情報が含まれます。user の値をユーザー名に、pass の値をパスワードに置き換えます。ユーザー名とパスワードを必要としない認証メカニズムを使用している場合は、接続 URI のこの部分を省略します。

接続文字列の次の部分は、MongoDB インスタンスのホスト名または IP アドレスを指定し、その後にポート番号を指定します。上記の例では、ホスト名としてsample.host を使用し、ポートとして27017 を使用します。これらの値を置き換えて、MongoDB インスタンスを点ようにします。

接続文字列の最後の部分には、パラメーターとして接続オプションと認証オプションが含まれています。上記の例では、2 つの接続オプションmaxPoolSize=20とw=majorityを設定しています。接続オプションの詳細については、「接続オプション」セクションを参照してください。

Atlas 接続例

Atlas 上の MongoDB 配置に接続するには、クライアントを作成する必要があります。クライアントを作成するには、URI とMongoClientOptionsオブジェクトを渡してMongoClientのインスタンスを構築します。

MongoClientOptionsオブジェクトのserverApiオプションを使用して Stable API 機能を有効にします。これにより、サーバーは指定された API バージョンと互換性のある動作で操作を強制的に実行します。

次のコードは、Atlas 上の MongoDB 配置に接続するときに接続文字列と Stable API クライアント オプションを指定し、接続が成功したことを確認する方法を示します。

const { MongoClient, ServerApiVersion } = require("mongodb");
// Replace the placeholder with your Atlas connection string
const uri = "<connection string>";
// Create a MongoClient with a MongoClientOptions object to set the Stable API version
const client = new MongoClient(uri,  {
        serverApi: {
            version: ServerApiVersion.v1,
            strict: true,
            deprecationErrors: true,
        }
    }
);
async function run() {
  try {
    // Connect the client to the server (optional starting in v4.7)
    await client.connect();
    // Send a ping to confirm a successful connection
    await client.db("admin").command({ ping: 1 });
    console.log("Pinged your deployment. You successfully connected to MongoDB!");
  } finally {
    // Ensures that the client will close when you finish/error
    await client.close();
  }
}
run().catch(console.dir);

Stable API 機能について詳しくは、「Stable API」ページをご覧ください。

MongoDB に接続する他の方法

Atlas でホストされていない単一の MongoDB Server インスタンスまたはレプリカセットに接続する場合は、次のセクションで接続方法を確認してください。

mongodb://localhost:<port>

mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=myRs