$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)

带有其他查询和排序表达式的 $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" } } )