$文字_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 查询和投影运算符 > 评估查询运算符 > $文字

在本页面

定义
行为
例子

MongoDB Atlas搜索

Atlas Search使在MongoDB数据之上轻松构建基于关联的快速搜索功能成为可能。立即在MongoDB Atlas（我们完全托管的数据库即服务）上试用。

定义¶

$text¶

$text对用文本索引索引的字段的内容进行文本搜索。甲 $text表达的语法如下：

在版本3.2中更改。

复制

{
  $text:
    {
      $search: <string>,
      $language: <string>,
      $caseSensitive: <boolean>,
      $diacriticSensitive: <boolean>
    }
}

该$text运营商接受带有以下字段的文本查询文件：

领域	类型	描述
`$search`	串	MongoDB解析并用于查询文本索引的术语字符串。`OR`除非指定为短语，否则MongoDB会对术语进行逻辑搜索。有关该字段的更多信息，请参见行为。
`$language`	串	可选的。确定用于搜索的停用词列表以及词干分析器和分词器规则的语言。如果未指定，则搜索使用索引的默认语言。有关支持的语言，请参见“ 文本搜索语言”。如果您将语言值指定为`"none"`，则文本搜索将使用简单的标记化，其中没有停用词列表，也没有词干。
`$caseSensitive`	布尔值	可选的。一个布尔标志，用于启用或禁用区分大小写的搜索。默认为`false`; 即，搜索将根据文本索引的大小写不敏感。有关更多信息，请参见不区分大小写。 3.2版中的新功能。
`$diacriticSensitive`	布尔值	可选的。一个布尔标志，用于启用或禁用针对版本3文本索引的变音敏感搜索。默认为 `false`; 也就是说，搜索符合文本索引的变音符号不敏感。针对较早版本的文本索引的文本搜索本质上是变音符号敏感的，并且不能是变音符号不敏感的。因此，该`$diacriticSensitive`选项对早期版本的文本索引无效。有关更多信息，请参见变音符号不敏感。 3.2版中的新功能。

该$text运营商，默认情况下，也没有返回结果的得分方面来分类的结果。有关按文本搜索分数排序的更多信息，请参阅文本分数文档。

行为¶

限制¶

一个查询最多可以指定一个$text表达式。
该$text查询不能出现在$nor表达式中。
该$text查询不能出现在$elemMatch查询表达式或$elemMatch投影表达式中。
要$text在$or表达式中使用查询，$or必须对数组中的所有子句都建立索引。
hint()如果查询包含$text查询表达式，则无法使用。
$natural如果查询包含$text表达式，则不能指定排序顺序。
您不能将$text需要特殊文本索引的表达式与需要不同类型特殊索引的查询运算符组合在一起。例如，您不能将$text表达式与$near运算符结合在一起。
视图不支持文本搜索。

如果$text在聚合中使用运算符，则以下限制也适用。

$match包含a 的阶段$text必须是管道中的第一阶段。
一个text操作员在该阶段只能出现一次。
的text操作者表达不能出现在 $or或$not表达式。
默认情况下，文本搜索不会按匹配分数的顺序返回匹配的文档。$meta在$sort阶段中使用聚合表达式。

`$search`字段¶

在该$search字段中，指定一个字符串，该字符串由 text操作员解析并用于查询文本索引。

该text运营商对待大部分标点符号的字符串作为分隔符，除了一个连字符减号（-），其通过则无效条款或转义双引号\"指定的短语。

短语¶

要匹配短语而不是单个术语，请将短语用转义双引号（\"）括起来，如下所示：

复制

"\"ssl certificate\""

如果$search字符串包含短语和单个术语，则文本搜索将仅匹配包含短语的文档。

例如，传递了一个$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: true$text

变音符号敏感词和词干¶

对于变音符号敏感搜索（即），如果后缀词根包含一个或多个变音符号，则运算符会匹配确切的单词。$diacriticSensitive: true$text

不区分大小写¶

在版本3.2中更改。

该$text运营商默认为的不区分大小写的文本索引：

的版本3文本索引为具有或不具有从非拉丁字母，如西里尔字母变音符号和字符拉丁字符不区分大小写。有关详细信息，请参见文本索引。
text索引的早期版本对不带变音符号的拉丁字符不区分大小写；即为[A-z]。

`$caseSensitive`选项¶

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

区分大小写的搜索过程¶

在索引不区分大小写的情况下执行区分大小写的搜索（）时，运算符：$caseSensitive: truetext$text

首先在text索引中搜索不区分大小写和变音符的匹配项。
然后，为了仅返回与搜索词大小写匹配的文档，$text查询操作包括一个附加阶段，用于过滤出与指定大小写不匹配的文档。

对于区分大小写的搜索（即），如果后缀词根包含大写字母，则运算符将匹配确切的单词。$caseSensitive: true$text

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

也可以看看

词干

变音符号不敏感¶

在版本3.2中更改。

该$text运营商默认为的音调符号不敏感的文本索引：

该版本3文本索引是区分符号不敏感。即，索引不包含变音符号和它们的未标记的对应，如字符区分é，ê和e。
该text索引的早期版本对变音符号敏感。

`$diacriticSensitive`选项¶

要支持针对第3版text索引的变音符号敏感文本搜索，请指定。$diacriticSensitive: true

针对较早版本的text索引进行的文本搜索本质上是变音符号敏感的，并且不能是变音符号不敏感的。因此，运算符的$diacriticSensitive选项对索引的$text早期版本无效text。

变音符号敏感搜索过程¶

要针对版本3 索引执行变音符号敏感文本搜索（），操作员：$diacriticSensitive: truetext$text

首先搜索text变音符号不敏感的索引。
然后，仅返回与搜索词的带变音符号的字符匹配的文档，$text查询操作包括一个附加阶段，用于过滤出不匹配的文档。

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

为了对较早版本的text索引执行变音符号敏感搜索，$text操作员搜索对text 变音符号敏感的索引。

对于变音符号敏感搜索，如果后缀词干中包含一个或多个变音符号，则$text运算符会匹配确切的单词。

也可以看看

词干

文字分数¶

该$text运营商分配的得分为包含在索引字段搜索词的每个文档。分数表示文档与给定文本搜索查询的相关性。分数可以是sort()方法规范的一部分，也可以是投影表达式的一部分。该表达式提供有关操作处理的信息。有关访问投影或排序分数的详细信息，请参见投影运算符。{ $meta: "textScore" }$text$meta

例子¶

以下示例假定一个在字段上articles具有版本3文本索引的集合subject：

复制

db.articles.createIndex( { subject: "text" } )

用以下文档填充集合：

复制

db.articles.insert(
   [
     { _id: 1, subject: "coffee", author: "xyz", views: 50 },
     { _id: 2, subject: "Coffee Shopping", author: "efg", views: 5 },
     { _id: 3, subject: "Baking a cake", author: "abc", views: 90  },
     { _id: 4, subject: "baking", author: "xyz", views: 100 },
     { _id: 5, subject: "Café Con Leche", author: "abc", views: 200 },
     { _id: 6, subject: "Сырники", author: "jkl", views: 80 },
     { _id: 7, subject: "coffee and cream", author: "efg", views: 10 },
     { _id: 8, subject: "Cafe con Leche", author: "xyz", views: 10 }
   ]
)

搜索一个单词¶

以下查询指定一个$search字符串coffee：

复制

db.articles.find( { $text: { $search: "coffee" } } )

此查询返回coffee在索引subject字段中或更确切地说词的词干版本中包含术语的文档：

复制

{ "_id" : 2, "subject" : "Coffee Shopping", "author" : "efg", "views" : 5 }
{ "_id" : 7, "subject" : "coffee and cream", "author" : "efg", "views" : 10 }
{ "_id" : 1, "subject" : "coffee", "author" : "xyz", "views" : 50 }

也可以看看

不区分大小写，词干

匹配任何搜索词¶

如果搜索字符串是用空格分隔的字符串，则$text 运算符OR将对每个术语执行逻辑搜索，并返回包含任何术语的文档。

以下查询指定$search由空格分隔的三个术语的字符串："bake coffee cake"

复制

db.articles.find( { $text: { $search: "bake coffee cake" } } )

该查询返回的文档中包含bake 或 coffee 或 cake位于索引subject字段中，或更准确地说，包含这些单词的词干版本：

复制

{ "_id" : 2, "subject" : "Coffee Shopping", "author" : "efg", "views" : 5 }
{ "_id" : 7, "subject" : "coffee and cream", "author" : "efg", "views" : 10 }
{ "_id" : 1, "subject" : "coffee", "author" : "xyz", "views" : 50 }
{ "_id" : 3, "subject" : "Baking a cake", "author" : "abc", "views" : 90 }
{ "_id" : 4, "subject" : "baking", "author" : "xyz", "views" : 100 }

也可以看看

不区分大小写，词干

搜索短语¶

要将确切的短语作为单个术语进行匹配，请不要使用引号。

以下查询搜索短语：coffee shop

复制

db.articles.find( { $text: { $search: "\"coffee shop\"" } } )

此查询返回包含以下短语的文档：coffee shop

复制

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

也可以看看

短语

排除包含术语的文档¶

一个否定词是由一个减号作为前缀的一个术语-。如果您否定一个术语，则$text运算符将从结果中排除包含这些术语的文档。

以下示例搜索包含单词 coffee但不包含术语shop或更确切地说单词的词干版本的文档：

复制

db.articles.find( { $text: { $search: "coffee -shop" } } )

该查询返回以下文档：

复制

{ "_id" : 7, "subject" : "coffee and cream", "author" : "efg", "views" : 10 }
{ "_id" : 1, "subject" : "coffee", "author" : "xyz", "views" : 50 }

也可以看看

否定词，词干

搜索不同的语言¶

使用表达式中的可选$language字段$text来指定一种语言，该语言确定停用词的列表以及搜索字符串的词干分析器和标记生成器的规则。

如果您将语言值指定为"none"，则文本搜索将使用简单的标记化，其中没有停用词列表，也没有词干。

以下查询指定es西班牙语（即西班牙语）作为确定标记，词干和停用词的语言：

复制

db.articles.find(
   { $text: { $search: "leche", $language: "es" } }
)

该查询返回以下文档：

复制

{ "_id" : 5, "subject" : "Café Con Leche", "author" : "abc", "views" : 200 }
{ "_id" : 8, "subject" : "Cafe con Leche", "author" : "xyz", "views" : 10 }

该$text表达式还可以接受名称为的语言 spanish。有关支持的语言，请参见文本搜索语言。

也可以看看

不区分大小写

大小写和变音符号不敏感搜索¶

在版本3.2中更改。

该$text运营商推迟到的情况和音调符号的不敏感text指数。版本3 text索引对变音符号不敏感，并且将其对大小写的不敏感性扩展到包括西里尔字母以及带变音符号的字符。有关详细信息，请参见“ 索引不区分大小写”和“ 索引变音不敏感”。

以下查询对术语сы́рники或进行不区分大小写和变音符号的文本搜索CAFÉS：

复制

db.articles.find( { $text: { $search: "сы́рники CAFÉS" } } )

使用版本3 text索引，该查询与以下文档匹配。

复制

{ "_id" : 6, "subject" : "Сырники", "author" : "jkl", "views" : 80 }
{ "_id" : 5, "subject" : "Café Con Leche", "author" : "abc", "views" : 200 }
{ "_id" : 8, "subject" : "Cafe con Leche", "author" : "xyz", "views" : 10 }

使用text索引的先前版本，查询将不匹配任何文档。

也可以看看

不区分大小写，变音符号不敏感，词干，文本索引

执行区分大小写的搜索¶

在版本3.2中更改。

要启用区分大小写的搜索，请指定。指定可能会影响性能。$caseSensitive: true$caseSensitive: true

区分大小写的术语搜索¶

以下查询对术语进行区分大小写的搜索 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 }
} )

搜索仅匹配文档：

复制

MongoDB 中文手册

$文字

定义¶

行为¶

限制¶

$search字段¶

短语¶

否定¶

匹配操作¶

停用词¶

词干¶

区分大小写的搜索和词干¶

变音符号敏感词和词干¶

不区分大小写¶

$caseSensitive选项¶

区分大小写的搜索过程¶

变音符号不敏感¶

$diacriticSensitive选项¶

变音符号敏感搜索过程¶

文字分数¶

例子¶

搜索一个单词¶

匹配任何搜索词¶

搜索短语¶

排除包含术语的文档¶

搜索不同的语言¶

大小写和变音符号不敏感搜索¶

执行区分大小写的搜索¶

区分大小写的术语搜索¶

区分大小写的短语¶

`$search`字段¶

`$caseSensitive`选项¶

`$diacriticSensitive`选项¶