結果を並べ替える

Overview

このガイドでは、ソート操作を使用して、MongoDB Java ドライバーによる読み取り操作の結果を並べ替える方法を学習します。

ソート操作では、クエリから返されたドキュメントを、指定されたソート条件で並べ替えます。 ソート基準は、データの順序付け方法を説明する MongoDB に渡すルールです。 ソート条件の例は、次のとおりです。

• 最小数から最大数へ

• 時刻までの時刻から最新時刻まで

• 名がアルファベット順に並べられている

次の場合は、こちらのガイドをお読みください。

• 昇順ソートと降順ソートを実行します。

• ソート条件を組み合わせます。

• テキスト検索のテキスト スコアで並べ替えます。

このガイドの例では、次のドキュメントを含むサンプル コレクションを使用します。

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 6, "letter": "c", "food": "maple donut"}

ソートの方法

クエリによって検索した結果をソートすることも、集計パイプライン内の結果をソートすることもできます。 クエリ結果を並べ替えるには、 FindIterableインスタンスの sort()メソッドを使用します。 集計パイプライン内で結果を並べ替えるには、 Aggregates.sort()静的ファクトリー メソッドを使用します。 これらのメソッドはどちらも、 Bsonインターフェースを引数として実装するオブジェクトを受け取ります。 詳細については、 BSON インターフェース用の API ドキュメントを参照してください。

次のように、 FindIterableインスタンスのsort()メソッドを使用できます。

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("_id"));

集計パイプライン内で次のようにAggregates.sort()メソッドを使用できます。

import com.mongodb.client.model.Aggregates;
import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.aggregate(Arrays.asList(Aggregates.sort(ascending("_id"))));

上記のコード スニペットは、サンプル コレクション内のドキュメントを_idフィールドの最小値から最大値の順にソートします。

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
...

上記のコード スニペットでは、 Sortsビルダ クラスを使用して並べ替え条件を指定しています。 Bsonインターフェースを実装する任意のクラスを使用して並べ替え条件を指定することも可能ですが、 Sortsビルダを使用して並べ替え条件を指定することをお勧めします。 Sortsビルダ クラスの詳細については、 Sort ビルダに関するガイドを参照してください。

このセクションのクラスとインターフェースの詳細については、次の API ドキュメントを参照してください。

• FindIterable

• 集計

• ソート

• BSON

• ドキュメント

ソート方向

並べ替えの方向は昇順または降順のいずれかです。 昇順で並べ替えると、結果が最小から最大の順に並べられます。 降順で並べ替えると、結果が最大から最小の順に並べられます。

以下に、昇順でソートされたデータの例をいくつか示します。

• Numbers: 1, 2, 3, 43, 43, 55, 120

• Dates: 1990-03-10, 1995-01-01, 2005-10-30, 2005-12-21

• 単語（ASCII） : バナー、ディル、によう

以下に、降順でソートされたデータの例をいくつか示します。

• Numbers: 100, 30, 12, 12, 9, 3, 1

• Dates: 2020-01-01, 1998-12-11, 1998-12-10, 1975-07-22

• 単語（逆 ASCII）: ピアリング、品種、Apple、チームメイトのチーム

次のサブセクションでは、これらのソート条件を指定する方法を示します。

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("<field name>"));

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
List<Document> results = new ArrayList<>();
collection.find().sort(ascending("_id")).into(results);
for (Document result : results) {
      System.out.println(result.toJson());
}

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
...

import static com.mongodb.client.model.Sorts.descending;
// <MongoCollection setup code here>
collection.find().sort(descending("_id"));

{"_id": 6, "letter": "c", "food": "maple donut"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
...

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("letter"));

{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}

import static com.mongodb.client.model.Sorts.ascending;
// <MongoCollection setup code here>
collection.find().sort(ascending("letter", "_id"));

{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 6, "letter": "c", "food": "maple donut"}

import static com.mongodb.client.model.Sorts.orderBy;
import static com.mongodb.client.model.Sorts.ascending;
import static com.mongodb.client.model.Sorts.descending;
// <MongoCollection setup code here>
Bson orderBySort = orderBy(descending("letter"), ascending("_id"));
collection.find().sort(orderBySort);

{"_id": 1, "letter": "c", "food": "coffee with milk"}
{"_id": 6, "letter": "c", "food": "maple donut"}
{"_id": 4, "letter": "b", "food": "coffee with sugar"}
{"_id": 2, "letter": "a", "food": "donuts and coffee"}
{"_id": 3, "letter": "a", "food": "maple syrup"}
{"_id": 5, "letter": "a", "food": "milk and cookies"}

テキスト検索

テキスト検索の結果の順序は、コレクションのテキストインデックスで指定された各結果のフィールドのstring値が検索stringとどの程度一致するかによって指定できます。 テキスト検索では、各結果が検索 string にどの程度一致するかを示す数値テキスト スコアが割り当てられます。 Sorts.metaTextScore()静的ファクトリー メソッドを使用して、テキスト スコアで並べ替える並べ替え条件を構築します。

次のコード例では、 Sorts.metaTextScore()メソッドを使用してサンプルコレクションのテキスト検索の結果を並べ替える方法を示しています。 このコード例では、フィルター、インデックス、およびプロジェクションビルダを使用します。 このコード例では、次のアクションが実行されます。

1. foodフィールドにサンプル コレクションのテキスト インデックスを作成します。 コレクションにすでに存在するインデックスを指定してcreateIndex()を呼び出す場合、操作では新しいインデックスは作成されません。

2. "maple double" というフレーズのテキスト検索を実行します。

3. クエリ結果にテキスト スコアをscoreフィールドとしてプロジェクションします。

4. 結果をテキスト スコアでソートします（一致が先）。

import com.mongodb.client.model.Sorts;
import com.mongodb.client.model.Projections;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.Indexes;
// <MongoCollection setup code here>
collection.createIndex(Indexes.text("food"));
Bson metaTextScoreSort = Sorts.metaTextScore("score");
Bson metaTextScoreProj = Projections.metaTextScore("score");
String searchTerm = "maple donut";
Bson searchQuery = Filters.text(searchTerm);
collection.find(searchQuery)
         .projection(metaTextScoreProj)
         .sort(metaTextScoreSort)
         .into(results);
for (Document result : results) {
      System.out.println(result.toJson());
}

上記のコード例の出力は、次のようになります。

{"_id": 6, "letter": "c", "food": "maple donut", "score": 1.5}
{"_id": 2, "letter": "a", "food": "donuts and coffee", "score": 0.75}
{"_id": 3, "letter": "a", "food": "maple syrup", "score": 0.75}

このセクションのクラスの詳細については、次の API ドキュメントを参照してください。

• フィルター

• Indexes

• プロジェクション

• MongoCollection

詳細については、「 ソート 」クラス を参照してください API ドキュメント。$textクエリ演算子と$meta集計パイプライン演算子の詳細については、サーバーのマニュアル ドキュメントを参照してください。