$text（自我管理部署）

精确字符串

要匹配精确的多单词字符串而不是单个术语，请将字符串括在转义双引号 (\") 中：如下所示：

"\"ssl certificate\""

如果 $text 操作的 $search 字符串包含多词字符串和单个词，$text 仅会匹配包含该多词字符串的文档。

示例，此 $search 字符串返回具有完全相同的字符串 "ssl certificate" 的文档：

"\"ssl certificate\" authority key"

否定

在单词前缀加上连字符减号 (-) 可对其表示否定：

• 否定词会从结果设立排除包含否定词的文档。

• 仅包含否定词的字符串不匹配任何文档。

• 像 pre-market 这样的带连字符的单词不是否定词。 MongoDB将连字符视为分隔符。要取反 market，请使用 pre -market。

MongoDB将所有否定应用于具有逻辑 AND 的操作。

非索引字

MongoDB会忽略特定语言的停用词，例如英语中的 the 和 and。

词干处理

由于不区分大小写和变音符号，$text 会匹配完整的词干词。如果文档字段包含blueberry ，则$search 的blue 术语不匹配。但是，blueberry 或blueberries 会匹配。

启用区分大小写

指定 $caseSensitive: true 可在文本索引不区分大小写时启用区分大小写功能。

区分大小写的流程

当 $caseSensitive: true 且文本索引不区分大小写时，$text：

• 查询文本索引是否存在不区分大小写和不区分变音符号的匹配项。

• 筛选结果以仅返回与指定大小写匹配的文档。

当 $caseSensitive: true 且后缀词干包含大写字母时，$text 匹配精确的单词。

启用 $caseSensitive: true 可能会降低性能。

启用区分变音符号

指定 $diacriticSensitive: true 可启用3 版本文本索引区分变音符号的功能。

早期的文本索引版本始终区分变音符号，因此 $diacriticSensitive 不起作用。

区分变音符号的搜索过程

对于 3 版本的文本索引和 $diacriticSensitive: true、$text：

• 查询不区分变音符号的文本索引。

• 筛选结果以仅返回与指定术语中的变音符号匹配的文档。

启用 $diacriticSensitive: true 可能会降低性能。

对于早期的文本索引版本，$diacriticSensitive: true 会查询已经区分变音符号的文本索引。

当 $diacriticSensitive: true 且后缀词干包含变音符号时，$text 会匹配精确的单词。

区分大小写的术语搜索

此示例对 Coffee 执行区分大小写的查询：

db.articles.find( { $text: { $search: "Coffee", $caseSensitive: true } } )

这仅匹配：

{ "_id" : 2, "subject" : "Coffee Shopping", "author" : "efg", "views" : 5 }

区分大小写的精确字符串搜索

此示例对精确的多单词字符串执行区分大小写的查询：

db.articles.find( {
   $text: { $search: "\"Café Con Leche\"", $caseSensitive: true }
} )

这仅匹配：

{ "_id" : 5, "subject" : "Café Con Leche", "author" : "abc", "views" : 200 }

区分大小写的否定词搜索

-您可以使用案例大小写。

此示例对包含 Coffee 但不包含 shop 的文档执行区分大小写的查询（词干处理版本）：

db.articles.find( { $text: { $search: "Coffee -shop", $caseSensitive: true } } )

这匹配：

{ "_id" : 2, "subject" : "Coffee Shopping", "author" : "efg" }

区分变音符号的术语搜索

此示例对 CAFÉ（词干提取版本）执行区分变音符号的查询：

db.articles.find( { $text: { $search: "CAFÉ", $diacriticSensitive: true } } )

这仅匹配：

{ "_id" : 5, "subject" : "Café Con Leche", "author" : "abc" }

区分变音符号的否定词搜索

您可以使用区分变音符号与否定词（前缀为 - 的词）。

此示例对包含 leches 但不包含 cafés 的文档执行区分变音符号的查询（词干提取版本）：

db.articles.find(
  { $text: { $search: "leches -cafés", $diacriticSensitive: true } }
)

这匹配：

{ "_id" : 8, "subject" : "Cafe con Leche", "author" : "xyz" }

返回相关性评分

此示例查询cake 并使用$meta 将相关性分数附加到每个匹配的文档：

db.articles.find(
   { $text: { $search: "cake" } },
   { score: { $meta: "textScore" } }
)

返回的文档包含一个带有相关性分数的 score字段：

{ "_id" : 3, "subject" : "Baking a cake", "author" : "abc", "views" : 90, "score" : 0.75 }

按相关性得分排序

• 您可以在 sort() 中指定 { $meta: "textScore" } 表达式，而无需在投影中指定表达式。例如：

  db.articles.find(
     { $text: { $search: "cake" } }
  ).sort( { score: { $meta: "textScore" } } )

  因此，您可以根据相关性对结果文档进行排序，而无需对 textScore 投影。

• 如果在投影和 sort() 中都包含 { $meta: "textScore" } 表达式，则投影和排序文档的表达式可以有不同的字段名。

  For example, in the following operation, the projection uses a field named score for the expression and the sort() uses the field named ignoredName.

  db.articles.find(
     { $text: { $search: "cake" } } ,
     { score: { $meta: "textScore" } }
  ).sort( { ignoredName: { $meta: "textScore" } } )

返回前 2 个匹配文档

使用limit() 和sort() 可返回最匹配的文档。

此示例查询 coffee，按分数降序排序，并将结果限制为前两个文档：

db.articles.find(
   { $text: { $search: "coffee" } },
   { score: { $meta: "textScore" } }
).sort( { score: { $meta: "textScore" } } ).limit(2)

将 $text 与其他查询和排序操作相结合

此示例匹配 author 为 "xyz" 且 subject 包含 coffee 或 bake 的文档。它按 date 升序排序，然后相关性分数降序排序：

db.articles.find(
   { author: "xyz", $text: { $search: "coffee bake" } },
   { score: { $meta: "textScore" } }
).sort( { date: 1, score: { $meta: "textScore" } } )