照合

find() と sort() の例

次の例では、デフォルトのバイナリ照合を使用するコレクションでfind()とsort()の両方を呼び出します。 localeパラメータの値を"de"に設定して、ジャーナル照合を使用します。

myColl.find({ city: "New York" }, { collation: { locale: "de" } })
  .sort({ name: 1 });

findOneAndUpdate() の例

次の例では、デフォルトのバイナリ照合を使用するコレクションに対してfindOneAndUpdate()操作を呼び出します。 コレクションには、次のドキュメントが含まれます。

{ "_id" : 1, "first_name" : "Hans" }
{ "_id" : 2, "first_name" : "Gunter" }
{ "_id" : 3, "first_name" : "Günter" }
{ "_id" : 4, "first_name" : "Jürgen" }

照合を指定していないこのコレクションに対する次のfindOneAndUpdate()操作を検討してください。

myColl.findOneAndUpdate(
  { first_name : { $lt: "Gunter" } },
  { $set: { verified: true } }
);

バイナリ照合を使用する場合、「Gunter」は最初にソートされた結果であるため、クエリ ドキュメント内の$lt比較演算子よりも句読点で一致するドキュメントはありません。 その結果、操作ではドキュメントは更新されません。

ロケールをde@collation=phonebookに設定して照合を指定する同じ操作を検討してください。 このロケールでは、最初の文字を大文字にすることで識別される固有名を優先するためのルールを含むcollation=phonebookオプションを指定します。 de@collation=phonebookロケールと オプションは、numlaut のない同じ文字の前に umelut を持つ文字をソートします 。

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

findOneAndUpdate()で指定されたde@collation=phonebook照合を使用して、"Guter" が辞書的に "Gunter" より前に配置されるため、この操作は次の更新されたドキュメントを返します。

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

findOneAndDelete() の例

次の例では、デフォルトのバイナリ照合を使用し、次のドキュメントを含むコレクションに対してfindOneAndDelete()操作を呼び出します。

{ "_id" : 1, "a" : "16" }
{ "_id" : 2, "a" : "84" }
{ "_id" : 3, "a" : "179" }

この例では、 numericOrdering照合パラメータをtrueに設定して、数字の string を辞書順ではなく番号順に基づいて並べ替えます。

myColl.findOneAndDelete(
  { a: { $gt: "100" } },
  { collation: { locale: "en", numericOrdering: true } },
);

上記の操作を実行すると、 コレクションには次のドキュメントが含まれます。

{ "_id" : 1, "a" : "16" }
{ "_id" : 2, "a" : "84" }

3 つのドキュメントの元のコレクションに対して照合なしで同じ操作を実行すると、文字列の語彙値（ "16" 、 "84" 、 "179" ）に基づいてドキュメントが照合され、最初に見つけたドキュメントが削除されます。クエリ条件に一致します。

await myColl.findOneAndDelete({ a: { $gt: "100" } });

すべてのドキュメントはaフィールドに条件に一致する照合値（ "100"の句読点より大きい）が含まれているため、操作は最初の結果を削除します。 上記の操作を実行すると、 コレクションには次のドキュメントが含まれます。

{ "_id" : 2, "a" : "84" }
{ "_id" : 3, "a" : "179" }

集計の例

集計 と照合を使用するには 操作は、パイプライン ステージの配列の後にオプション フィールドに照合ドキュメントを渡します。

次の例では、デフォルトのバイナリ照合を使用するコレクションの集計パイプラインを示しています。 集計はfirst_nameフィールドをグループ化し、各グループの結果の合計数をカウントし、結果をドイツ語（ "de@collation=phonebook"ロケール）の順序でソートします。

myColl.aggregate(
  [
    { $group: { "_id": "$first_name", "nameCount": { "$sum": 1 } } },
    { $sort: { "_id": 1 } },
  ],
  { collation: { locale: "de@collation=phonebook" } },
);