MongoDB 7.0.5+を実行中クラスターでは、MongoDB Search を使用して、参照点の後、または 前 で $search クエリ結果を連続して取得します。$search searchAfter または searchBefore オプションを使用して結果を順番に走査し、アプリケーション内で「次のページ」と「前のページ」関数を構築します。
使用法
ページ分割された結果を検索するには、次の手順を実行します。
クエリを実行したいフィールドにインデックスを作成します。
参照点を返す
$searchクエリを実行します。 詳細については、「 参照点の取得 」を参照してください。後続の
$searchクエリで参照点を使用して、結果内に次または前のドキュメント セットを検索します。"Next Page" 関数を構築するための結果の検索の詳細については、「特定の参照点の後の検索 」を参照してください。
「前のページ」関数を構築するための結果の検索の詳細については、「特定の参照点の前の検索 」を参照してください。
結果のページに移動するには、
$skipと$limitを$searchsearchAfterまたはsearchBeforeオプションと組み合わせて使用します。 たとえば、ページ3からページ5に移動し、1 ページあたり10の結果に移動するには、次の操作を実行します。ページ3の最後の結果の参照点を持つ
searchAfterを使用して結果を取得します(結果30 )。ページ5の結果を返します(結果41 - 50 )。
ここで、
$skipをsearchAfterオプションとともに使用すると、クエリが最適化され、結果の 1 ページのみをスキップします(10件のドキュメント)。比較すると、$searchsearchAfterオプションを使用せずに$skipを使用すると、クエリは結果の 4 ページ(40件のドキュメント)をスキップします。詳細については、「searchAfter と $skip を使用してページ 2 からページ 5 へジャンプする」をご覧ください。
Considerations
複数のドキュメントが同じ値を持つフィールドでソートすると、同点となります。Mongo DBは、結び付けられたクエリ結果の順序を保証しません。
searchAfterとsearchBeforeを使用すると、重複や不整合が発生する可能性があります。関連性スコアの同点を減らすために、次の原則を応用します。関連性スコアの同点を防ぐために、クエリを一意のフィールドで並べ替えます。例については、 「スコアと一意のフィールドによる並べ替え」を参照してください。
非 一意のフィールドで主にソートする場合は、タイブレークとして機能するために一意のフィールドに セカンダリ ソート句を追加 します。
クエリ間でドキュメントを更新または削除すると、結果順序の不整合が発生する可能性があります。決定的な検索する動作をサポートするには、次の原則を適用します。
クエリ結果を
_idなどの不変フィールドで並べ替えます。MongoDB Search は、最初のクエリと後続のクエリの間にコレクションに加えた更新を反映します。変更可能なフィールド(例:updated_time)でソートし、最初のクエリと2番目のクエリの間でコレクションを更新すると、MongoDB Search では同じドキュメントの順序が異なる場合があります。専用の検索ノードを配置し、
searchScore、結果をソートする場合は、以下を考慮してください。デフォルトでは、MongoDB Search は
bm25類似度アルゴリズムを使用してドキュメントにスコアを付けます。このアルゴリズムは、MongoDB Search ノード上のドキュメント全体のコーパスに対する用語の頻度を計算します。各 MongoDB Search ノードは変更ストリームから独立して複製されるため、このコーパスは MongoDB Search ノード間で異なる場合があります。その結果、同じクエリが異なる MongoDB Search ノードにルーティングされると、異なるbm25スコアが返される可能性があります。後続のクエリは、配置が専用の MongoDB Search ノード を使用する場合、または読み込み設定 がsecondaryまたはnearestに設定されている場合、異なる MongoDB Search ノードにルーティングされる可能性が高くなります。以降のクエリでコンシステントなスコアが得られるようにするには、フィールドを MongoDB Search のstringまたはautocomplete型としてインデックス化するときに
similarity.typeプロパティをstableTflあるいはbooleanに設定します。これにより、text、phrase、queryString、autocomplete 演算子は、インデックス付きフィールドのクエリの関連性スコアを計算するためにstableTflまたはboolean類似度アルゴリズムを使用するようになります。これらのアルゴリズムは、すべての MongoDB Search ノードで一貫してスコアを計算します。詳細については、「スコアの詳細」を参照してください。
ページネーション中に検索結果をカウントするには、最初の クエリまたは別の
$search$searchMetaクエリで カウント オプションを使用します。この方法は、$countステージの後に$searchステージを使用するよりも効率的です。count オプションは検索条件に一致するドキュメントの合計数を返すため、ページ分割された結果を生成している場合は、後のクエリで
countオプションを使用する必要がありません。$searchメインの クエリとは別にカウントするには、$searchMetaオプションを指定したcountステージを使用します。検索結果をカウントすると、パフォーマンスに影響する可能性があります。count オプションは必要な場合にのみ使用してください。例、最初のページの検索結果を取得する場合などです。
参照点の取得
特定の時点でクエリ結果を検索するには、 $searchクエリで参照点を指定する必要があります。 参照点を検索するには、 ステージの後の$meta searchSequenceToken$projectステージで$search キーワード を使用します。
構文
searchSequenceToken 構文
[{ "$search": { "index": "<index-name>", "<operator-name>"|"<collector-name>": { <operator-specification>|<collector-specification> }, "sort": { "score": { "$meta": "searchScore" } }, ... }, { "$project": { "paginationToken" : { "$meta" : "searchSequenceToken" } }, ...}]出力
searchSequenceTokenは、結果内の各ドキュメントに対して base 64でエンコードされたトークンを生成します。 トークンの長さは、クエリのソートオプションで指定されたフィールドの数に応じて増加します。 トークンはデータベースのスナップショットには関連付けられていません。
クエリで sort オプションを指定しない限り、結果内のドキュメントはデフォルトの順序でソートされます。結果の並べ替えの詳細については、「 MongoDB検索結果の並べ替え 」を参照してください。
特定の参照点の後の検索
参照点を検索するには、 searchSequenceTokenによって生成されたトークンでsearchAfterオプションを使用して、 $searchクエリで参照点を指定する必要があります。 searchSequenceTokenによって生成されたトークンは、 searchSequenceTokenがトークンを生成した$searchクエリを再実行した場合にのみ使用できます。 トークンを使用する後続の$searchクエリのセマンティクス(検索フィールドと値)は、 searchSequenceTokenがトークンを生成したクエリと同一である必要があります。
searchAfterオプションを使用して、アプリケーション内で「次のページ」機能を構築できます。 これを示すには、このページの例を参照してください。
searchAfter 構文
searchAfter 構文
[{ "$search": { "index": "<index-name>", "<operator-name>"|"<collector-name>": { <operator-specification>|<collector-specification> }, "searchAfter": "<base64-encoded-token>", "sort": { "score": { "$meta": "searchScore" } }, ... }, "$project": { "paginationToken" : { "$meta" : "searchSequenceToken" } }, ...}]出力
MongoDB Search では、指定されたトークンの後の結果内のドキュメントが返されます。MongoDB Search では、searchSequenceToken $project$searchステージの後の ステージで を指定したため、結果内のドキュメントの生成されたトークンが返されます(11 行に表示)。これらのトークンは、同じセマンティクスを持つ別のクエリの参照点として使用できます。
クエリで sort オプションを指定しない限り、結果内のドキュメントはデフォルトの順序でソートされます。結果の並べ替えの詳細については、「 MongoDB検索結果の並べ替え 」を参照してください。
特定の参照点の前の検索
参照点の前を検索するには、 searchSequenceTokenによって生成されたトークンでsearchBeforeオプションを使用して、 $searchクエリで参照点を指定する必要があります。 searchSequenceTokenによって生成されたトークンは、 searchSequenceTokenがトークンを生成した$searchクエリを再実行した場合にのみ使用できます。 トークンを使用する後続の$searchクエリのセマンティクス(検索フィールドと値)は、 searchSequenceTokenがトークンを生成したクエリと同一である必要があります。
searchBefore オプションを使用して、アプリケーションで「前のページ」機能を構築できます。これを行うには、以下を組み合わせます。
これを証明するために、このページのsearchBeforeクエリ例を参照してください。
searchBefore 構文
searchBefore 構文
[{ "$search": { "index": "<index-name>", "<operator-name>"|"<collector-name>": { <operator-specification>|<collector-specification> }, "searchBefore": "<base64-encoded-token>", "sort": { "score": { "$meta": "searchScore" } }, ... }, "$project": { "paginationToken" : { "$meta" : "searchSequenceToken" } }, ...}]searchBefore 出力
MongoDB Search では、指定されたトークンに先行する結果内のドキュメントが逆の順序で返されます。MongoDB Search では、searchSequenceToken $project$searchステージの後の ステージで を指定したため、結果内のドキュメントの生成されたトークンも返されます(11 行に表示)。これらのトークンは、同じセマンティクスを持つ別のクエリの参照点として使用できます。
例
次の例では、db.collection.aggregate() $searchメソッドを使用して、 sample_mflix データベースに対して クエリを実行します。最初のクエリ例では、参照点の検索方法を示します。後続のクエリ例では、この参照点の前後のページの追加結果を検索するためにこの参照点を使用します。
mongosh: でこれらの例クエリを実行するには、次のようにします。
sample_mflix.movies コレクションをロードする
動的マッピングを使用して
pagination-tutorialインデックスを作成します。インデックスの作成方法については、「MongoDB Search インデックスの管理」を参照してください。mongoshを使用してクラスターに接続し、sample_mflixデータベースに切り替えます
注意
デフォルトでは 、 MongoDB Search は結果内のドキュメントを、ドキュメントの関連性スコアでソートします。結果内の複数のドキュメントのスコアが同じである場合、 MongoDB Search は任意の順序付けられた結果を返します。特定の順序でドキュメントを返すには、クエリで一意のフィールドreleased を指定して結果をソートします。