Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs 菜单
Docs 主页
/ /

$similarityDotProduct(表达式操作符)

8.3版本新增

$similarityDotProduct

返回以数组或 binData 值表示的两个数值向量的点积。点积等于相应元素的乘积之和。

$similarityDotProduct 有两种语法形式。

简洁语法返回原始点积分数:

{ $similarityDotProduct: [ <vector1>, <vector2> ] }

完整语法接受可选的规范化参数:

{
$similarityDotProduct: {
vectors: [ <vector1>, <vector2> ],
score: <boolean>
}
}

使用完整语法时,$similarityDotProduct 接受以下字段:

字段
类型
必要性
说明

vectors

阵列

必需

恰好包含两个表达式的数组。每个表达式必须解析为一个数值大量或一个 binData 值。两个向量必须具有相同的长度。

score

布尔

Optional

true 时,使用公式 (1 + dotProduct) / 2 返回规范化分数。默认为 false

有关表达式的更多信息,请参阅表达式。

如果任一参数解析为null 或引用缺失字段,则$similarityDotProduct null会返回 。

$similarityDotProduct会返回double 。当scorefalse (默认)时,结果为原始点积。该值取决于输入向量的大小。幅度较大的向量会产生较大的点积值。

scoretrue 时,使用公式 (1 + dotProduct) / 2 对结果进行归一化。此归一化假定单位长度(归一化)输入向量。对于单位长度向量,原始点积在 [-1, 1]范围内,归一化分数在 [0, 1]范围内。

$similarityDotProduct 在以下情况下返回错误:

  • 任一参数均未解析为大量或 binData 值。

  • 输入数组或 binData 值具有不同的长度。

  • 这两个大量都包含非数字元素。

以下示例使用 vectors集合:

db.vectors.insertMany( [
{ _id: 1, a: [1, 2, 3], b: [1, 2, 3] },
{ _id: 2, a: [1, 2, 3], b: [3, 2, 1] },
{ _id: 3, a: [1, 2, 3], b: [4, 5, 6] }
] )

以下聚合管道计算每个文档的 ab 字段之间的点积,并返回原始分数和标准化分数:

db.vectors.aggregate( [
{
$project: {
raw: { $similarityDotProduct: [ "$a", "$b" ] },
normalized: {
$similarityDotProduct: {
vectors: [ "$a", "$b" ],
score: true
}
}
}
}
] )

操作返回以下结果:

{ _id: 1, raw: 14, normalized: 7.5 }
{ _id: 2, raw: 10, normalized: 5.5 }
{ _id: 3, raw: 32, normalized: 16.5 }

后退

$similarityCosine

在此页面上