$text（自我管理部署）

短语

要匹配短语（而不是单个词），请将短语包含在转义双引号 (\") 中，如下所示：

"\"ssl certificate\""

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

例如，传递了一个 $search 字符串：

"\"ssl certificate\" authority key"

$text 操作符返回包含短语 "ssl certificate" 的文档。

否定

在单词前面加上连字符减号 (-) 可以否定单词：

• 否定词从结果集中排除包含否定词的文档。

• 当传递仅包含否定词的字符串时，$text 不会匹配任何文档。

• 带连字符的单词，例如 pre-market，不是否定词。如果在带连字符的单词中使用，$text 操作符会将减号连字符（-）视为分隔符。要在本例中否定单词 market，请在 pre 和 -market 之间添加一个空格，即 pre -market。

$text 操作符使用逻辑 AND 操作符将所有否定词添加到操作中。

非索引字

$text 操作符会忽略特定语言的停用词，例如英语中的 the 和 and。

词干处理

对于不区分大小写和不区分变音符号的搜索，$text 操作符会匹配完整的词干。如果文档字段包含单词 blueberry ，则 $search 词为 blue 的 $text 操作不匹配。然而，blueberry 或 blueberries 匹配。

$caseSensitive 选项

要在 text 索引不区分大小写时支持区分大小写，请指定 $caseSensitive: true。

区分大小写的流程

如果 $caseSensitive: true 且 text 索引不区分大小写，则 $text 操作符：

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

• 然后，为了仅返回与指定词语大小写相匹配的文档，$text 操作会包括一个额外的阶段，用于过滤出与指定大小写不匹配的文档。

如果 $caseSensitive: true 并且如果后缀词干包含大写字母，则 $text 操作符将匹配准确的单词。

指定 $caseSensitive: true 可能会影响性能。

$diacriticSensitive 选项

要支持针对 text 索引进行区分变音符号的搜索，请指定 $diacriticSensitive: true。

针对早期版本的 text 索引的文本查询本质上是区分变音符号的，并且不能不区分变音符号。因此，$text 操作符的 $diacriticSensitive 选项对早期版本的 text 索引没有影响。

区分变音符号的搜索过程

要对版本 3 text 索引使用区分变音符号 ( $diacriticSensitive: true，$text 操作符会：

• 首先查询 text 索引，该索引不区分变音符号。

• 然后，为了仅返回与指定词语的变音符号相匹配的文档，$text 操作会包括一个额外的阶段，用于过滤不匹配的文档。

指定 $diacriticSensitive: true 可能会影响性能。

如果将 $diacriticSensitive: true 与早期版本的 text 索引一起使用，则 $text 操作符将查询 text 索引，该索引区分变音符号。

如果 $diacriticSensitive: true 并且如果后缀词干包含变音符号或标记，则 $text 操作符将匹配准确的单词。

搜索词区分大小写

以下示例对搜索词 Coffee 执行区分大小写的查询：

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

该操作仅与以下文档匹配：

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

短语区分大小写

以下示例对短语 Café Con Leche 执行区分大小写的查询：

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

该操作仅与以下文档匹配：

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

区分大小写，需含否定词

否定词是指以减号 - 为前缀的词。如果否定一个词，$text 运算符将从结果中排除包含这些词的文档。您还可以为否定词指定是否区分大小写。

以下示例对包含单词 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" }

区分变音符号并使用否定词

$diacriticSensitive 选项也适用于否定词。否定词是带有负号 - 前缀的词。如果否定一个词，$text 操作符将从结果中排除包含这些词的文档。

以下示例对包含搜索词 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() 结合使用可返回前 n 个匹配的文档。

以下示例查询搜索词 coffee 并按降序分数对结果进行排序，将结果限制为前两个匹配的文档：

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

使用其他查询和排序表达式的文本搜索

以下示例匹配 author 等于 "xyz" 且带索引的字段 subject 包含搜索词 coffee 或 bake 的文档。该操作还指定按 date 升序排列，然后按相关性分数降序排列：

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