AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

MongoDB Search 結果のソート

インターフェース

MongoDB Search を使用すると、 MongoDB Searchインデックスで定義したフィールドに対して、結果を昇順または降順でソートできます。sort オプションを使用して、次のフィールドタイプで並べ替えることができます。

  • boolean

  • date

  • number (整数、浮動小数、double 値)

  • objectId

  • uuid

  • string (トークンの種類としてインデックス付け)

結果内のドキュメントのスコアや、null 値で並べ替えたりできます。

Atlas は、 MongoDB 7.0 以降のバージョンのすべてのメジャー リリースとマイナー リリースに対して、シャーディングされていないソートクエリとシャーディングされたソートクエリの両方をサポートしています。

  • embeddedDocuments型のフィールドではソートできません。

  • 非推奨の knnBeta 演算子では sort オプションは使用できません。

MongoDB Search の結果を並べ替えるには、次の操作を行う必要があります。

  1. 結果を並べ替えるには、 フィールドにMongoDB Searchインデックスを作成します。

    boolean 、 date 、 number 、 UUID 、 objectIdフィールドで並べ替えるには、動的マッピングまたは静的マッピングを使用します。 string フィールドでソートするには、静的マッピングを使用してフィールドをtokenタイプとしてインデックス付けする必要があります。

  2. 並べ替え用インデックスで定義したフィールドに対してsortオプションを使用してクエリを作成し、実行します。 詳しくは、「構文 」を参照してください。

sort オプションには、並べ替えるフィールドとそれぞれの並べ替え順序を指定するドキュメントが指定されます。MongoDB Search は、サポートされているデータ型のMongoDB比較順序 に従います。UUID 値は BinData のように扱われます。詳細については、存在しないフィールドを参照してください。

次の並べ替え順序を指定して、結果を並べ替えることができます。

1

昇順でソートします。

昇順でソートすると、 MongoDB Search は、 値を持つドキュメントの前に欠損値を持つドキュメントを返します。

-1

降順でソートします。

スコアの昇順または降順で並べ替えることもできます。sortオプションには$meta式を指定するドキュメントが必要です。これにはsearchScore値が必要です。

例

アプリケーションで、ユーザーが検索結果の最後のページにスキップできるとします。 次の例では、結果をスコアの昇順でソートし、スコアが最も低いドキュメントが結果の上部に表示されるようにします。

sort: {score: {$meta: "searchScore", order: 1}}

sort を使用すると、結果内の複数のドキュメントのスコアが同じである場合に、結果の順序が特定の順序になるようにすることもできます。例、次の例に示すように、lastUpdated という名前の日付フィールドなど、 一意のフィールドで結果をソートすると、 MongoDB Search は決定された順序で同じスコアを持つ結果を返します。

例

sort: {score: {$meta: "searchScore"}, lastUpdated: 1}

ただし、結果を並べ替えるための一意のフィールドを指定しない場合、 MongoDB Search はスコアの降順で並べ替えられた結果を返します。MongoDB Search では、スコアまたは値が同一の結果が任意の順序で返されます。次の例では、結果を一意のフィールドでソートしません。

例

sort: {score: {$meta: "searchScore"}}

詳細については、「 結果内のドキュメントにスコアを付ける 」を参照してください。

MongoDB Search は、ソート用に配列をフラット化します。

例

次の配列について考えてみましょう。

[4, [1, [8,5], 9], 2]

MongoDB Search は、次のように、前述の配列をフラット化します。

4, 1, 8, 5, 9, 2

昇順 並べ替えでは、 MongoDB Search は 1 を使用して配列を他の値と比較します。降順並べ替えでは、 MongoDB Search は 9 を使用して配列を他の値と比較します。

配列内の要素と比較する場合:

  • 昇順ソートでは、 MongoDB Search は配列の最小要素を比較するか、(<)未満の比較を実行します。

    例

    MongoDB Search では、数値で昇順にソートすると、次の順序で結果がソートされます。

    -20[-3, 12] // <- -3 comes before 5.5[6, 18] // <- 6 comes after 5.1314
  • 降順ソートでは、 MongoDB Search は配列の最大要素を比較するか、(>)より大きい比較を実行します。

    例

    MongoDB Search では、数値で降順にソートすると、次の順序で結果がソートされます。

    [6, 18] // <- 18 comes before 14.1413[-3, 12] // <- 12 comes after 13.5-20

複数のBSON types の値を含む配列フィールドをソートする場合、 MongoDB Search は 配列から表される要素を選択し、MongoDBの 比較とソートデフォルトに従って比較に使用します。

  • 昇順ソートの場合、 MongoDB Search はBSON型の最も低い要素を使用します。

  • 降順ソートの場合、 MongoDB Search は最も高いBSON type の要素を使用します。

配列内に同じ BSON 型の値が複数ある場合、選択した型の標準ソート動作が適用されます。

例

次の配列について考えてみましょう。

[ 'foo', null, 15, true, false ]
  • For an ascending sort, MongoDB Search uses null, as it is the lowest supported BSON type.

  • 降順でソートする場合、MongoDB Search は true を使用します。これは配列内で最も高い BSON 型であるため、MongoDB Search は true 値を false 値よりも上位にランク付けします。

ただし、 sort 構文で noData: highest を設定すると、 MongoDB Search は null 値と欠損値を最上位のBSON型と見なします。例配列では、次の動作が適用されます。

  • 昇順 ソートの場合、 MongoDB Search は配列内で最低のBSON型であるため、15 を使用します。

  • 降順ソートでは、 MongoDB Search は null を使用します。これは配列の最上位のBSONタイプになっています。

詳細については、「 Null および欠損値によるソート 」を参照してください。

例については、「 マルチタイプの配列でのソート 」を参照してください。

MongoDB Search では、null 値は欠落値と空の値と等しいものとして扱われ、これらの値を持つドキュメントの順序はソート時に非決定的になります。

デフォルトでは、MongoDB Search はMongoDB の比較とソート順序に従い、null 値はサポートされている他のすべてのBSON型よりも低い値と見なします。そのため、昇順ソートでは null 値が結果の上部に表示され、降順ソートでは結果の最下位に表示されます。

結果に null 値が表示される場所を設定するには、noData sort構文で フィールドを指定します。noDataフィールドは次の値を取ります。

  • lowest (デフォルト): ソート中に null 値を最小のBSONタイプとして設定します。昇順ソートでは null 値を結果の上部に、降順ソートでは最下位でソートします。

  • highest: ソート時に null 値を最上位のBSONタイプとして設定します。昇順ソートでは null 値を結果の下にソートし、降順ソートでは null 値を上部にソートします。

注意

同じ動作は、null または欠落値を含む複数のタイプを持つ配列をソートする場合にも適用されます。

例については、「 null 値によるソート 」および「 マルチタイプ配列でのソート 」を参照してください。

埋め込まれたドキュメント フィールドで親ドキュメントをソートするには、次の操作を行う必要があります。

  • 埋め込まれたドキュメント子フィールドの親をドキュメントタイプとしてインデックス化します。

  • 埋め込みドキュメント内のstring値を持つ子フィールドをトークンタイプとしてインデックスします。 数値値と日付値を持つ子フィールドの場合は、動的マッピングを有効にして、それらのフィールドを自動的にインデックス化します。

MongoDB Search は親ドキュメントのみをソートします。ドキュメントの配列内の子フィールドはソートされません。の例については、「 ソートの例 」を参照してください。

MongoDB Search インデックスは結果整合性があり、結果で返される値はソートで使用される値と異なる場合があります。

この機能により、後続の ステージとして$search$limit とともに を使用するクエリが最適化されます。MongoDB Search がコレクション内のすべてのドキュメントをソートする必要がある場合、応答が遅くなる可能性があります。

MongoDB Search では、結果内にすべてのドキュメントのスコアが返されます。ただし、スコアで明示的に並べ替えない限り、結果内のドキュメントの順序が並べ替え条件に基づいているため、スコアの低いドキュメントの後にスコアの高いドキュメントが表示される可能性があります。

sort の構文は次のとおりです。

{ "$search": { "index": "<index name>", // optional, defaults to "default" "<operator>": { // such as "text", "compound", or "phrase" <operator-specification> }, "sort": { score: {$meta: "searchScore"}, // optional field "<field-to-sort>": <sort-order>, // 1 or -1, or a document ... } }}
Parameter
説明

score

任意.検索スコアでソートするかどうかを決定します。詳細については、スコアと一意のフィールドによるソートを参照してください。

<field-to-sort>

必須。 並べ替えるフィールドの名前。

<sort-order>

必須。 ソート順序を決定します。 昇順には 1 を使用し、降順には -1 を使用します。

noData フィールドを指定する場合は、次の構文のドキュメントを使用します。

"<field-to-sort>": { order: 1 | -1, // required field noData: "lowest" | "highest" // optional field},...

次の例では、 sample_mflix.movies 、 sample_airbnb.listingsAndReview 、またはusersという名前のカスタム コレクションを使用します。

このページのサンプル クエリでは、 sample_mflix.movies 、 sample_airbnb.listingsAndReview 、またはカスタム コレクションのいずれかを使用します。 これらのコレクションに次のインデックスを作成すると、インデックス フィールドに対してサンプル クエリを実行できます。

次のクエリは、複合演算子クエリを実行し、結果を日付フィールドでソートする方法を示しています。次の演算子を使用します。

  • ワイルドカード演算子を使用すると、 Summerで始まる映画タイトルを検索できます。

  • near演算子を使用すると、2014 年 4 月 18 日の前後で公開された映画を検索できます。

    注意

    日付フィールドで pivot を使用する場合、その測定単位はミリ秒単位になります。MongoDB Search は、日付フィールドが指定された日付にどれだけ近いかに基づいて、各ドキュメントのスコアを計算します。詳しくは、の近くを参照してください。

クエリは、次のパイプライン ステージを使用します。

  • ステージでは、$search フィールドとtitle releasedフィールドを検索し、その結果を フィールドで降順にソートします。released

  • $limitステージを使用して、出力を5の結果に制限します。

  • $project stageを次のように設定します。

    • titleとreleasedを除くすべてのフィールドを除外します。

    • scoreという名前のフィールドを追加します。

次のクエリは、結果を数値フィールドでソートする方法を示しています。 範囲演算子を使用して、10 個以上の賞を受賞した映画を検索し、結果を数値フィールド値で降順にソートします。

クエリは、次のパイプライン ステージを使用します。

  • $searchステージでは、 awards.winsフィールドを検索し、結果を降順でソートします。

  • $limitステージを使用して、出力を5の結果に制限します。

  • $projectステージでは、 titleとawards.winsを除くすべてのフィールドが除外されます。

sample_mflix.movies名前空間に対する次のクエリでは、 $searchステージを使用して次の処理が行われます。

  • タイトルにcountryというタームが含まれる映画を検索します。

  • sortオプションを使用して、結果を昇順で並べ替えます。

クエリは$limitステージを使用して出力を5ドキュメントに制限します。 また、 $projectステージを使用して次の操作を実行します。

  • 結果のtitleを除くすべてのフィールドを省略します。

  • scoreという名前のフィールドを追加します。

db.movies.aggregate([ { "$search": { "text": { "path": "title", "query": "country" }, "sort": { "title": 1 } } }, { "$limit": 5 }, { "$project": { "_id": 0, "title": 1, "score": { "$meta": "searchScore" } } }])

次のクエリは、結果を string フィールドでクエリしてソートする方法を示しています。 PranceまたはPrinceで始まるタイトルを検索し、結果をtitleフィールドで昇順にソートします。

クエリは、次のパイプライン ステージを使用します。

  • $searchは、ワイルドカード演算子とともにshould句を使用してtitleフィールドを検索し、 PranceとPrinceで始まるタイトルを検索します。 このクエリでは、結果がtitleフィールドで昇順にソートされる必要があることも指定しています。

  • $limitステージを使用して、出力を5の結果に制限します。

  • $project stageを次のように設定します。

    • titleを除くすべてのフィールドを除外します。

    • scoreという名前のフィールドを追加します。

次のクエリは、大文字と小文字に関係なく結果をソートする方法を示しています。 テキスト演算子を使用して、 titleフィールドにtrainというタームが含まれる映画を検索し、その結果をtitleフィールド値で昇順にソートします。

クエリでは、結果内のドキュメントを5に制限するための$limitステージと、次の操作を行うための$projectステージを指定します。

  • 結果には_id 、 title 、 awardsフィールドのみが結果に含まれます。

  • 結果にスコアという名前のフィールドを追加する。

次のクエリは、範囲演算子を使用して、 sample_mflix.moviesコレクションのreleasedフィールドで、 2015-01-01と2015-12-31の間に公開された映画を検索します。 結果は、タイプObjectIdの値を含む_idフィールドで降順にソートされます。

db.movies.aggregate([ { "$search": { "range": { "path": "released", "gt": ISODate("2015-01-01T00:00:00.000Z"), "lt": ISODate("2015-12-31T00:00:00.000Z") }, "sort": { "_id": -1 } } }, { "$limit": 5 }, { "$project": { "_id": 1, "title": 1, "released": 1, "score": { "$meta": "searchScore" } } }])

次のクエリは、 usersコレクションのフィールドbでhelloというタームを検索します。 クエリでは、多形データ(ソート順序を示すため)を含むフィールドaで結果が昇順でソートされます。

db.users.aggregate([ { "$search": { "text": { "path": "b", "query": "hello" }, "sort": { "a": 1 } } }, { "$project": { "_id": 1, "a": 1, "score": { "$meta": "searchScore" } } }])

テキスト 演算子を使用して、フィールド で bコレクション内の文字列hellousers を検索する次のクエリを検討してみましょう。次に、クエリは結果をフィールドc でソートします。このフィールドにはコレクション内の一部のドキュメントに null または欠損値が含まれています。

詳細については、「 Null および欠損値によるソート 」を参照してください。

注意

noData: lowest の設定はデフォルトの と同じです。

MongoDB Search はソート時に null 値と欠損値を等しいものとして扱うため、"_id": 4、"_id": 5、"_id": 6 を含むドキュメントの順序はランダムです。

フィールドc にマルチタイプの配列を含む追加のドキュメントがある場合、ユーザーコレクションに対する次のクエリを検討してみましょう。

db.users.insertOne({ "_id": 7, "a": UUID("03e32aa9-1cbd-43b8-b9d6-18b171a03cc7"), "b": "hello", "c": [ false, null, 15 ]})

bhello次のクエリは、テキスト演算子を使用してフィールド で文字列 を検索し、その結果をフィールドc でソートします。

注意

noData: lowest並べ替え構文で を設定する方法は、デフォルトのと同じです。

次のクエリは、ソート時に null 値を最も高い BSON 型として設定するために noData: highest を指定します。

次のクエリは、 sample_airbnb.listingsAndReviewsコレクションでPortugalの プロパティを検索し、その結果をbooleanフィールドis_location_exactの降順で並べ替えます。

クエリは$limitステージを使用して出力を5ドキュメントに制限します。 また、 $projectステージを使用して、結果のname 、 property_type 、 address.country 、 address.location.is_location_exact以外のすべてのフィールドを省略します。

db.listingsAndReviews.aggregate([ { "$search": { "text": { "path": "address.country", "query": "Portugal" }, "sort": { "address.location.is_location_exact": -1, } } }, { "$limit": 5 }, { "$project": { "_id": 0, "name": 1, "property_type": 1, "address.country": 1, "address.location.is_location_exact": 1 } }])

前述の結果では、ドキュメントの is_location_exact の値は true です。降順ソートでは、 MongoDB Search は true の値を false の値より超えてランク付けするためです。前のクエリの 9 行の値を 1 に変更して昇順ソートを実行すると、 MongoDB Search は false の値が true 値よりも高いドキュメントをランク付けし、次のドキュメントを返します。

[ { name: 'Ribeira Charming Duplex', property_type: 'House', address: { country: 'Portugal', location: { is_location_exact: false } } }, { name: 'Be Happy in Porto', property_type: 'Loft', address: { country: 'Portugal', location: { is_location_exact: false } } }, { name: 'Downtown Oporto Inn (room cleaning)', property_type: 'Hostel', address: { country: 'Portugal', location: { is_location_exact: false } } }, { name: 'A Casa Alegre é um apartamento T1.', property_type: 'Apartment', address: { country: 'Portugal', location: { is_location_exact: false } } }, { name: 'FloresRooms 3T', property_type: 'Apartment', address: { country: 'Portugal', location: { is_location_exact: false } } }]

次のクエリでは、 $searchステージを使用して次の操作を実行します。

  • タイトルにdanceというタームが含まれる映画を検索します。2 つ以上の賞を受賞し、1990 年 1 月 1 日以降にリリースされた映画が優先されます。

  • 結果を賞の数で降順に並べ替え、次に映画タイトルの昇順で並べ替え、次に公開日の降順で並べ替えます。

クエリは$limitステージを使用して出力を10ドキュメントに制限します。 また、 $projectステージを使用して次の操作を実行します。

  • 結果のtitle 、 released 、 awards.wins以外のすべてのフィールドを省略します。

  • scoreという名前のフィールドを追加します。

db.movies.aggregate([ { "$search": { "compound": { "must": [{ "text": { "path": "title", "query": "dance" } }], "should": [{ "range": { "path": "awards.wins", "gte": 2 } }, { "range": { "path": "released", "gte": ISODate("1990-01-01T00:00:00.000Z") } }] }, "sort": { "awards.wins": -1, "title": 1, "released": -1 } } }, { "$limit": 10 }, { "$project": { "_id": 0, "title": 1, "released": 1, "awards.wins": 1, "score": { "$meta": "searchScore" } } }])

次のクエリでは、 $searchステージを使用して次の操作を実行します。

  • 範囲演算子を使用して、2010 年 1 月 1 日から 2015 年 1 月 01 日の間に公開された映画を検索します。

  • 1 、 5 、 10 、 15の各賞を受賞した映画の数を取得します。

  • 2010-01-01 、 2011-01-01 、 2012-01-01 、 2013-01-01 、 2014-01-01 、 2015-01-01でリリースされた映画の数を取得します。

  • sortオプションを使用して、結果をリリース日の降順で並べ替えます。

クエリは、 $limitステージを使用して次の処理を実行します。

  • docs出力フィールドの5ドキュメントに出力を制限します。

  • meta出力フィールドの1ドキュメントへの出力を制限します。

$projectステージを使用して、 awards.wins 、 released 、 titleフィールドを除くすべてのフィールドを省略します。

また、 $replaceWithステージを使用して$$SEARCH_META変数に保存されているメタデータの結果をmeta出力フィールドに含め、 $setステージを使用してmetaフィールドを結果に追加します。

db.movies.aggregate([ { "$search": { "facet": { "operator": { "range": { "path": "released", "gt": ISODate("2010-01-01T00:00:00.000Z"), "lt": ISODate("2015-01-01T00:00:00.000Z") } }, "facets": { "awardsFacet": { "type": "number", "path": "awards.wins", "boundaries" : [1,5,10,15] }, "releasedFacet" : { "type" : "date", "path" : "released", "boundaries" : [ISODate("2010-01-01T00:00:00.000Z"), ISODate("2011-01-01T00:00:00.000Z"), ISODate("2012-01-01T00:00:00.000Z"), ISODate("2013-01-01T00:00:00.000Z"), ISODate("2014-01-01T00:00:00.000Z"), ISODate("2015-01-01T00:00:00.000Z")] } } }, "sort": { "released": -1 } } }, { "$facet": { "docs": [ { "$limit": 5 }, { "$project": { "_id": 0, "title": 1, "released": 1, "awards.wins": 1 } } ], "meta": [ {"$replaceWith": "$$SEARCH_META"}, {"$limit": 1} ] } }, { "$set": { "meta": { "$arrayElemAt": ["$meta", 0] } } }])

次の例は、結果内のドキュメントのスコアで結果を並べ替える方法を示しています。 例では、次のアクションを実行する方法が示されています。

  • 最初に、結果を昇順でソートして、スコアが最も低いドキュメントを取得します。

  • 結果をスコアの降順で並べ替え、スコアが同じ結果の場合は任意に並べ替えます。

  • 結果をスコアで並べ替え、スコアが同一の結果については、 一意の フィールドを使用して並べ替えます。

ドキュメンテーション