レプリカセットでの CRUD 操作の実行方法の指定

Overview

このガイドでは、 書込み保証（ write concern ） 、 読み取り保証（ read concern ） 、 読み込み設定（ read preference ） の構成を使用して、MongoDB がレプリカセットに対して作成、読み取り、アップデート、削除（CRUD）操作を実行する方法を変更する方法を説明します。

次のレベルで、書込み保証、読み取り保証、読み込み設定（read preference）のオプションを設定できます。

• クライアント（オーバーライドされない限り、すべての操作実行にデフォルトを設定します）

• セッション

• トランザクション

• Database

• コレクション

このリストは、オプション設定の優先順位の増加順も示しています。 たとえば、トランザクションに読み取り保証 (read concern) レベルを設定すると、クライアントに設定された読み取り保証 (read concern) レベルが上書きされます。

これらのオプションを使用すると、レプリカセット内のデータの因果整合性と可用性をカスタマイズできます。

書込み保証 (write concern)

書込み保証 (write concern) は、挿入や更新などの書込み (write) 操作について MongoDB から要求される確認応答のレベルを指定します。その後、操作は正常に返されます。 明示的な書込み保証（write concern）を指定しない操作は、グローバルなデフォルトの書込み保証（write concern）設定を継承します。

詳細については、サーバー マニュアルの 書込み保証 (write concern) を参照してください。詳細なAPIドキュメントについては、 WriteConcern APIドキュメント を参照してください。

次の表では、 WriteConcernパラメータについて説明しています。

myDB.myCollection.insertOne(
   { name: "anotherDocumentName" },
   { writeConcern:
     { w: 2, wtimeoutMS: 5000 }
   }
);

const newWriteConcern = WriteConcern.fromOptions(myDB);
const myDoc = { name: "New Document" };
WriteConcern.apply(myDoc,newWriteConcern);

読み取り保証（read concern）

読み取り保証 (read concern) は、次の動作を指定します。

• レプリカセット間の因果整合性のレベル

• クエリ中に維持される分離の保証

読み取り保証 (read concern) 設定は、 levelパラメータを使用して指定できます。 デフォルトの読み取り保証 (read concern) レベルはlocalです。 つまり、クライアントは接続先のレプリカセット メンバーからデータを返しますが、そのデータがすべてのレプリカセット メンバーに書き込まれた保証はありません。 読み取り保証 (read concern) レベル 要件を低くすると、レイテンシが削減される可能性があることに注意してください。

読み取り保証 (read concern) または読み取り保証 (read concern) レベルの詳細については、サーバー マニュアルの「読み取り保証(read concern) 」を参照してください。 ReadConcernのタイプと読み取り保証（read concern）レベルの定義の詳細については、「 ReadConcern 」を参照してください API ドキュメントを参照してください。

const pipeline = [
   {"$match": {
     category: "KITCHENWARE",
   }},
   {"$unset": [
     "_id",
     "category",
   ]}
 ];
result = await myDB.collection("mycollection")
   .aggregate(
     pipeline,
     { readConcern:
       { level: "available" }
     }
   );

const options = { readConcern: { level: "local" } };
const myDB = client.db("mydb", options);

読み込み設定 (read preference)

読み込み設定 (read preference) は、クエリの実行時に MongoDB がレプリカセットのどのノードを読み込むかを決定します。 サーバーがメンバーを評価する方法をカスタマイズすることもできます。

API詳しくは、 ReadPreference ドキュメントAPI 参照してください。

以下の表では、 ReadPreferenceパラメータを説明しています。

const transactionOptions = {
   readPreference: "primary",
   readConcern: { level: "local" },
   writeConcern: { w: "majority" },
};
const session = client.startSession();
session.startTransaction(transactionOptions);
// ...
await session.commitTransaction();
await session.endSession();

const uri = "mongodb+srv://<user>:<password>@<cluster-url>?readPreference=secondary&maxStalenessSeconds=120";
const client = new MongoClient(uri);

API ドキュメント

このガイドで言及されているメソッドとタイプの詳細については、次のAPIドキュメントを参照してください。

• API WriteConcern

• API ReadConcern

• API ReadPreference