Atlas Search
Atlas Searchオペレーター、compound/filter、score、highlight、sequence token、paging/countとDriver-native拡張パスを1.0.0基準で構成します。
基本のAtlas Search
$searchと$searchMetaは集約パイプラインの最初のステージである必要があるため、一般的なfields(...).end()フローとは分離されています。インデックスを省略した.search()も使用できます。
Searchオペレーター
• ルートビルダー: text, phrase, autocomplete, equals, exists, in, range, compound
• 再利用可能なクローズ: SearchOperators.text/phrase/autocomplete/equals/in/exists/range
• Driver-nativeルートオペレーター: operator(SearchOperator)
• 名前付きDriverラッパー: SearchOperators.driver(name, operator)
compoundはmust, mustNot, should, filter, minimumShouldMatch, scoreをサポートし、一般的なAtlasSearchOperatorを直接渡すこともできます。
Text / Phrase / Autocomplete
• text: path(s), query(ies), fuzzy, matchCriteria, synonyms, score
• phrase: path(s), query(ies), slop, synonyms, score
• autocomplete: single path, query(ies), tokenOrder, fuzzy, score
• fuzzy(...)とsynonyms(...)は同時に使用しません。
Searchクローズとポスト検索フィールドの違い
search().fields(...)は$search内部のフィルターではなく、$searchの後の一般的な$matchです。Searchインデックス段階で候補を制限するにはcompound.filter(...)を使用します。
Scoreとソート
scoreDesc()/scoreAsc()と一般的なソートは呼び出した順序で優先順位が決まります。安定したページネーションのために、スコアとともに安定したユニークフィールドのソートを行うことをお勧めします。
ハイライト / スコアの詳細 / シーケンストークン
デフォルトのエイリアスは highlights, scoreDetails, searchSequenceToken です。 addFieldsScoreDetails() は検索オプションのスコア詳細も有効にします。
ページング / シーケンストークン / カウント
count().execute()
post-search fields(...) とスコア閾値を反映した最終パイプラインカウントです。
count().executeSearchMeta()
$searchMeta メタデータカウントです。 SearchCountType.TOTAL/LOWER_BOUND をサポートし、post-search $match は実行しません。
existsQuery().execute()
検索パイプラインの結果が1件以上存在するか確認します。
Driver-native 拡張
stage(Bson) は $search の直後に入りますが、 executeSearchMeta() の $searchMeta メタデータカウントパイプラインには適用されません。新しいドライバ機能がDSL便利APIより先に追加されると、 operator, driverOptions, stage, SortSpec.driver, customizeAggregation を優先して使用します。