$text

短语

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

"\"ssl certificate\""

如果$search $text操作的string包含短语和单个术语，则搜索仅匹配包含该短语的文档。

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

"\"ssl certificate\" authority key"

$text操作符搜索短语"ssl certificate" 。

否定

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

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

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

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

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

非索引字

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

词干处理

对于不区分大小写和不区分变音符号的搜索，$text 操作符匹配完整的 词干 单词。因此，如果文档字段包含单词blueberry ，则对术语blue 的搜索将不匹配。但是，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 可能会影响性能。

要对早期版本的text索引执行区分变音符号的搜索， $text操作符会搜索区分变音符号的text索引。

对于区分变音符号的搜索，如果后缀词干包含一个或多个变音符号，则$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 }

按文本搜索分数排序

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

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

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

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

  例如，在以下操作中，投影使用名为 score 的字段作为表达式，而 sort() 则使用名为 ignoredName 的字段。

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

• 在 MongoDB 4.2 中，要按文本分数排序，请同时在投影文档和排序表达式中包含相同的 $meta 表达式。以下查询搜索术语 coffee 并按分数降序对结果进行排序：

  db.articles.find(
     { $text: { $search: "coffee" } },
     { score: { $meta: "textScore" } }
  ).sort( { score: { $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" } } )