CRUD操作の構成

クライアント構成

この例では、MongoClientOptionsオブジェクトを コンストラクターに渡すことで、MongoClientインスタンスの読み込み設定 (read preference)、読み取り保証 (read concern)）、書込み保証 (write concern)を設定する方法を示しています。このコードは、次の設定を構成します。

• SECONDARY 読み込み設定 ( 読み込み設定 (read preference)) : 読み取り操作は セカンダリレプリカセットメンバーからデータを取得します

• local 読み取り保証 (read concern)保証 : 読み取り操作は、インスタンスの最新データを返しますが、レプリカセットのノードの過半数にデータが書き込まれたことを保証します

• 2 書込み保証 ( 書込み保証 (write concern)) : プライマリと 1 つのセカンダリレプリカセットノードは、書込み (write)操作を確認する必要があります

const clientOptions = {
  readPreference: ReadPreference.SECONDARY,
  readConcern: { level: "local" },
  writeConcern: { w: 2 },
};
const client = new MongoClient("mongodb://localhost:27017", clientOptions);

あるいは、接続 URI で読み取り設定と書込み設定を指定することもできます。これはMongoClientコンストラクターにパラメーターとして渡されます。

const uri = "mongodb://localhost:27017/?readPreference=secondary&readConcernLevel=local&w=2";
const clientWithUri = new MongoClient(uri);

トランザクション構成

この例では、TransactionOptionsオブジェクトを startTransaction() メソッドに渡すことで、トランザクションの読み込み設定 (read preference)、読み取り保証 (read concern)） 、書込み保証 (write concern)を設定する方法を示しています。このコードは、次の設定を構成します。

• PRIMARY 読み込み設定 ( 読み込み設定 (read preference)) : 読み取り操作は、 プライマリレプリカセットメンバーからデータを取得します

• majority 読み取り保証 (read concern): 読み取り操作は、レプリカセットの過半数に書き込まれたインスタンスの最新データを返します

• 1 書込み保証 ( 書込み保証 (write concern)) : プライマリレプリカセットノードは書込み (write)操作を確認する必要があります

const transactionOptions = {
  readPreference: ReadPreference.PRIMARY,
  readConcern: { level: "majority" },
  writeConcern: { w: 1 },
};
const session = client.startSession();
session.startTransaction(transactionOptions);

データベース構成

この例では、DbOptionsオブジェクトを db() メソッドに渡すことで、test_database というデータベースの読み込み設定 (read preference)、読み取り保証 (read concern)） 、書込み保証 (write concern)を設定する方法を示しています。このコードは、次の設定を構成します。

• PRIMARY_PREFERRED 読み込み設定 ( 読み込み設定 (read preference)) : 読み取り操作は、プライマリレプリカセットメンバーからデータを取得します。プライマリが使用できない場合は セカンダリ メンバーからデータが取得されます

• available 読み取り保証 (read concern)保証 : 読み取り操作は、インスタンスの最新データを返しますが、レプリカセットのノードの過半数にデータが書き込まれたことを保証します

• majority 書込み保証（ 書込み保証 (write concern) ） : すべてのレプリカセットの過半数が書込み（write）操作を確認する必要があります

const dbOptions = {
  readPreference: ReadPreference.PRIMARY_PREFERRED,
  readConcern: { level: "available" },
  writeConcern: { w: "majority" },
};
const db = client.db("test_database", dbOptions);

コレクション構成

この例では、CollectionOptionsオブジェクトを collection() メソッドに渡すことで、test_collection というコレクションの読み込み設定 (read preference)、読み取り保証 (read concern)） 、書込み保証 (write concern) を設定する方法を示しています。このコードは、次の設定を構成します。

• SECONDARY_PREFERRED 読み込み設定 ( 読み込み設定 (read preference)) : 読み取り操作は、セカンダリレプリカセットメンバーからデータを取得します。セカンダリが使用できない場合は、プライマリ ノードからデータが取得されます。

• available 読み取り保証 (read concern)保証 : 読み取り操作は、インスタンスの最新データを返しますが、レプリカセットのノードの過半数にデータが書き込まれたことを保証します

• 0 書込み保証 (write concern) : 書込み (write)操作の確認応答をリクエストません

const collOptions = {
  readPreference: ReadPreference.SECONDARY_PREFERRED,
  readConcern: { level: "available" },
  writeConcern: { w: 0 },
};
const collection = db.collection("test_collection", collOptions);

照合フィールド

照合オブジェクトには、次のフィールドが含まれています。

collation: {
  locale: <string>,
  caseLevel: <bool>,
  caseFirst: <string>,
  strength: <int>,
  numericOrdering: <bool>,
  alternate: <string>,
  maxVariable: <string>,
  backwards: <bool>
}

collation オプションを設定する場合は、localeフィールドを指定する必要があります。その他のフィールドはすべてオプションです。サポートされているロケールと locale フィールドのデフォルト値の完全なリストについては、 MongoDB Serverマニュアルのサポートされている言語とロケールを参照してください。

照合の例

照合を指定するには、collationオブジェクトを作成し、その localeフィールドに使用する言語照合を設定します。次に、このオブジェクトをターゲット照合レベルに対応するメソッドのオプション パラメーターとして渡します。

このセクションには、コレクション、インデックス、および操作レベルで照合を設定する例が含まれています。

const db = client.db("db")
db.createCollection("names", {
  collation: { locale: "fr_CA" },
});

const coll = db.collection("names");
coll.createIndex(
  { "last_name" : 1 },
  { "collation" : { "locale" : "en_US" } });

{ "_id" : 1, "first_name" : "Hans", "last_name" : "Muller" }
{ "_id" : 2, "first_name" : "Gunter", "last_name" : "Braun" }
{ "_id" : 3, "first_name" : "Günter", "last_name" : "Krause" }
{ "_id" : 4, "first_name" : "Jürgen", "last_name" : "Weber" }

coll.findOneAndUpdate(
  { first_name: { $lt: "Gunter" } },
  { $set: { verified: true } },
  { collation: { locale: "de@collation=phonebook" } },
);

{ lastErrorObject: { updatedExisting: true, n: 1 },
  value: { _id: 3, first_name: 'Günter', last_name: 'Krause' },
  ok: 1 }