照合

Overview

このガイドでは、照合を使用して、検索または集計操作の結果を string 値で並べ替える方法を説明します。 照合は、特定の言語とロケールに対応する文字の順序付け規則のセットである。

このガイドには、次のセクションが含まれています。

• MongoDB 照合では、MongoDB がデフォルトの照合とカスタム照合に基づいて string 値をソートする方法について説明します。

• 「照合の指定」では、 Collation構造体インスタンスの作成方法について説明しています。

• コレクションに照合を設定すると、新しいコレクションの照合を設定する方法について説明します

• 「インデックスに照合を設定する」では、インデックスの照合を設定する方法について説明します。

• 「操作に照合を設定する」では、特定の CRUD 操作に照合を適用する方法について説明します。

• 追加情報では、このガイドで言及されている型とメソッドのリソースとAPIドキュメントへのリンクを提供します

MongoDB 照合

MongoDB はデフォルトでバイナリ照合を使用して string をソートします。 この照合メソッドでは、ASCII 標準文字値を使用して string を比較して順序付けます。 特定の言語とロケールには、ASCII 標準とは異なる特定の文字順序付け規則があります。

たとえば、カナダフランス語では、他の文字が同じ場合、string の順序を決定します。 次のカナダフランス語の単語について考えてみます。

• コピー

• coté

• côte

• côté

デフォルトのバイナリ照合を使用する場合、MongoDB は単語を次の順序でソートします。

cote
coté
côte
côté

このソート順序では、ASCII 標準では文字「o」が文字「」の前に配置されているため、「コテ」が「コテ」より前に配置されています。

カナダ フランス語の照合を使用する場合、MongoDB は単語を次の順序でソートします。

cote
côte
coté
côté

このソート順では、「connector 」が「cote」の後に配置されます。これは、カナダフランス語の照合ルールでは「e」が文字「ele」の前に配置されているためです。

照合の指定

照合を定義するには、 Collation構造体インスタンスで照合ロケールとその他のオプションを指定します。 Collationインスタンスの構築を開始するには、 Collation::builder()メソッドを呼び出します。

次の表では、 Collationインスタンスのフィールドを設定するために使用できるビルダ メソッドについて説明します。 有効なCollation構造体を構築するには、 locale()メソッドを使用する必要がありますが、他のビルダ メソッドはすべて任意です。

let collation = Collation::builder()
    .locale("en_US")
    .build();

コレクションでの照合の設定

新しいコレクションを作成する際に、そのコレクションで呼び出される将来の操作の照合を定義できます。 照合を設定するには、 collation()関数をcreate_collection()メソッドに連結して、 Collationインスタンスをcollation()にパラメータとして渡します。

let collation = Collation::builder()
    .locale("fr")
    .strength(CollationStrength::Primary)
    .build();
let result = my_db.create_collection("books")
    .collation(collation)
    .await?;

{ "name" : "Emma", "length" : "474" }
{ "name" : "Les Misérables", "length": "1462" }
{ "name" : "Infinite Jest", "length" : "1104" }
{ "name" : "Cryptonomicon", "length" : "918" }
{ "name" : "Ça", "length" : "1138" }

let query = doc! { "name": doc! { "$lt": "Infinite Jest" } };
let mut cursor = my_coll.find(query).await?;
while let Some(doc) = cursor.try_next().await? {
   println!("{}", doc);
}

インデックスでの照合の設定

コレクションに新しいインデックスを作成すると、インデックスによってカバーされる操作の照合を定義できます。 インデックスとその照合を使用する操作を実行するには、操作とインデックスで同じ照合を指定する必要があります。

collation()関数を使用してIndexOptionsインスタンスを構築し、インデックス照合を設定します。 次に、 IndexOptionsをIndexModelビルダ関数の引数として渡し、 IndexModelをcreate_index()メソッドの引数として渡します。

let collation = Collation::builder()
    .locale("en_US")
    .build();
let index_opts = IndexOptions::builder()
    .collation(collation)
    .build();
let index = IndexModel::builder()
    .keys(doc! { "name": 1 })
    .options(index_opts)
    .build();
let result = my_coll.create_index(index).await?;
println!("Created index: {}", result.index_name);

操作での照合の設定

コレクションからドキュメントを読み取り、更新、削除する操作では、照合を使用できます。 操作に照合を適用すると、コレクションまたはインデックスに対して以前に定義された照合が上書きされます。

インデックスの照合とは異なる操作に照合を適用する場合、そのインデックスは使用できません。 その結果、操作は、インデックスによってカバーされる操作のように効率的に実行されない可能性があります。 インデックスで説明されていないソート操作の悪影響の詳細については、サーバー マニュアルの「インデックスを使用してクエリ結果をソートする」を参照してください。

let collation = Collation::builder()
    .locale("en_US")
    .numeric_ordering(true)
    .build();
let filter = doc! { "length": doc! { "$gt": "1000" } };
let mut cursor = my_coll.find(filter)
    .collation(collation)
    .await?;
while let Some(result) = cursor.try_next().await? {
    println!("{}", result);
};

詳細情報

find()メソッドの詳細については、「データの取得」ガイドを参照してください。

照合の詳細については、次のサーバー マニュアル ページを参照してください。

• 照合

• 照合ロケールとデフォルト パラメーター