結果内のドキュメントのスコアリング

MongoDB Search またはMongoDB ベクトル検索クエリによって返されるすべてのドキュメントには関連性に基づいてスコアが割り当てられ、結果セットに含まれるドキュメントは最高スコアから最低スコアの順に返されます。

使用法

各ドキュメントのスコアを検索結果に含めるには、集計パイプラインの$project ステージを使用します。

$search ステージでは、score フィールドは $meta 式をとり、これには searchScore 値が必要です。scoreDetails フィールド $meta 式の searchScoreDetails 値を指定し、スコアの詳細な内訳を示すこともできます。
$vectorSearchステージでは、score フィールドは $meta 式をとり、これには、ベクトル検索結果内の各ドキュメントのスコアを返すために vectorSearchScore 値が必要です。

例

次のクエリは、$project ステージを使用して、返されるドキュメントに score という名前のフィールドを追加します。

1 db.movies.aggregate([
2   {
3     "$search": {
4       "text": {
5         <operator-specification>
6       }
7     }
8   },
9   {
10     "$project": {
11       "<field-to-include>": 1,
12       "<field-to-exclude>": 0,
13       "score": { "$meta": "searchScore" }
14     }
15   }
16 ])

1 db.movies.aggregate([
2   {
3     "$search": {
4       "text": {
5         <operator-specification>
6       },
7       "scoreDetails": true
8     }
9   },
10   {
11     "$project": {
12       "<field-to-include>": 1,
13       "<field-to-exclude>": 0,
14       "scoreDetails": { "$meta": "searchScoreDetails" }
15     }
16   }
17 ])

詳しくは、「検索スコアの詳細を返す」を参照してください。

1 db.movies.aggregate([
2   {
3     "$vectorSearch": {
4       <query-syntax>
5     }
6   },
7   {
8     "$project": {
9       "<field-to-include>": 1,
10       "<field-to-exclude>": 0,
11       "score": { "$meta": "vectorSearchScore" }
12     }
13   }
14 ])

詳細については、 MongoDB ベクトル検索 Score を参照してください。

動作

返されたドキュメントに割り当てられるスコアは、ドキュメントのメタデータの一部です。集計パイプラインで $project ステージを使用して、返された各ドキュメントのスコアを結果セットに含めることができます。ドキュメントは最高スコアから最低スコアの順に返されます。ドキュメントのスコアに影響を与える要因には、次のようなものがあります。

ドキュメント内の検索語の位置。
ドキュメント内の検索語の出現頻度。
MongoDB Search クエリが使用する演算子またはアナライザのタイプ。

Lucene スコアリングアルゴリズムの詳細については、 Lucene のドキュメントを参照してください。

追加オプション

デフォルトのスコアリング動作に加えて、 MongoDB Search は次のオプションをサポートしています。

特定のドキュメントに割り当てられたスコアを修正します。
スコアの詳細オプションを使用して、スコアの詳細な内訳を返します。
検索スコアを正規化します。

Considerations

結果内の複数のドキュメントのスコアが同じである場合、結果内のドキュメントの順序は非決定的になります。MongoDB Search の結果を特定の順序で表示したい場合は、 $searchステージで [ 並び替え ] オプションを含め、一意のフィールドで結果を並び替えます。並べ替えオプションを使用して、結果をスコア別に昇順で並べ替えることもできます。詳しくは、 MongoDB検索結果の並べ替えとスコアの例で並べ替えるを参照してください。

個別の検索ノードでは、各ノードがドキュメントに異なる内部 Lucene ID を割り当て、スコアが同一の場合にソートに使用します。結果をソートしてページ分割する際、クエリを処理しているノードの mongot プロセスには、内部 ID のページネーション順序がトークンよりも大きい場合、他のノードのドキュメントが含まれる可能性があります。これを防ぐには、$match を $search の後に使用して、_id によってドキュメントを除外します。

配列値をクエリする場合、 MongoDB Search は、配列内のクエリに一致する値の数に関係なく、同じスコアを割り当てます。

Tutorials

MongoDB Search クエリで追加の `score` オプションを使用する方法の例については、次のページを参照してください。	スコアを修正するスコアの詳細を返すサンプルクエリ
一般的なMongoDB Search クエリで `score`フィールドを使用する方法の例については、次のページを参照してください。	複合クエリの例埋め込みドキュメントの例文字列ソートの例

戻る

検索オプション

スコアのオプション

1	db.movies.aggregate([
2	{
3	"$search": {
4	"text": {
5	<operator-specification>
6	}
7	}
8	},
9	{
10	"$project": {
11	"<field-to-include>": 1,
12	"<field-to-exclude>": 0,
13	"score": { "$meta": "searchScore" }
14	}
15	}
16	])

1	db.movies.aggregate([
2	{
3	"$vectorSearch": {
4	<query-syntax>
5	}
6	},
7	{
8	"$project": {
9	"<field-to-include>": 1,
10	"<field-to-exclude>": 0,
11	"score": { "$meta": "vectorSearchScore" }
12	}
13	}
14	])