$正则表达式_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 查询和投影运算符 > 评估查询运算符 > $正则表达式

在本页面

定义
行为
例子

定义¶

$regex¶

为查询中的模式匹配字符串提供正则表达式功能。MongoDB使用具有UTF-8支持的Perl兼容正则表达式（即“ PCRE”）版本8.42。

要使用$regex，请使用以下语法之一：

复制

{ <field>: { $regex: /pattern/, $options: '<options>' } }
{ <field>: { $regex: 'pattern', $options: '<options>' } }
{ <field>: { $regex: /pattern/<options> } }

在MongoDB中，您还可以使用正则表达式对象（即 /pattern/）来指定正则表达式：

复制

{ <field>: /pattern/<options> }

有关特定语法使用的限制，请参见 $ regex与/ pattern /语法。

$options¶

以下内容<options>可用于正则表达式。

选项	描述	语法限制
`i`	不区分大小写，以匹配大小写。有关示例，请参见执行不区分大小写的正则表达式匹配。
`m`	对于包含锚点的模式（即`^`开始， `$`结束），请在每行的开头或结尾匹配具有多行值的字符串。如果没有此选项，这些锚点将在字符串的开头或结尾匹配。有关示例，请参见以指定模式开头的行的多行匹配。如果模式不包含锚点，或者字符串值不包含换行符（例如`\n`），则该`m`选项无效。
`x`	“扩展”功能可以忽略模式中的所有空白字符，`$regex`除非转义或包含在字符类中。此外，它会忽略中间的字符，包括未转义的井号/磅（`#`）字符和下一个新行，因此您可以在复杂模式中添加注释。这仅适用于数据字符；空格字符永远不会出现在图案的特殊字符序列中。该`x`选项不影响VT字符（即代码11）的处理。	需要`$regex`与`$options`语法
`s`	允许点字符（即`.`）匹配所有字符，包括换行符。有关示例，请参阅使用。点字符以匹配换行符。	需要`$regex`与`$options`语法

行为¶

$ regex vs./pattern/语法¶

`$in`表达式¶

要在$in查询表达式中包含正则表达式，您只能使用JavaScript正则对象（即/pattern/ ）。例如：

复制

{ name: { $in: [ /^acme/i, /^ack/ ] } }

您不能在中使用$regex运算符表达式 $in。

隐`AND`条件字段¶

要将正则表达式包含在该字段的查询条件的逗号分隔列表中，请使用$regex运算符。例如：

复制

{ name: { $regex: /acme.*corp/i, $nin: [ 'acmeblahcorp' ] } }
{ name: { $regex: /acme.*corp/, $options: 'i', $nin: [ 'acmeblahcorp' ] } }
{ name: { $regex: 'acme.*corp', $options: 'i', $nin: [ 'acmeblahcorp' ] } }

`x`和`s`选项¶

要使用任一x选项或s选项，则必须使用 $regex运营商的表达与该$options 运营商。例如，要指定i和s选项，必须同时使用$options：

复制

{ name: { $regex: /acme.*corp/, $options: "si" } }
{ name: { $regex: 'acme.*corp', $options: "si" } }

PCRE VS的JavaScript ¶

要在regex模式中使用JavaScript不支持的PCRE支持的功能，必须将$regex运算符表达式与模式一起用作字符串。例如，要(?i) 在模式中使用来为剩余的模式打开不区分大小写并为剩余的模式(?-i)打开区分大小写，您必须$regex将该模式的运算符用作字符串：

复制

{ name: { $regex: '(?i)a(?-i)cme' } }

`$regex`和`$not`¶

从4.0.7版开始，$not操作员可以NOT 对以下两种方式执行逻辑操作：

正则表达式对象（即/pattern/）

例如：

复制

db.inventory.find( { item: { $not: /^p.*/ } } )

$regex 运算符表达式（从MongoDB 4.0.7开始）。

例如：

复制

db.inventory.find( { item: { $not: { $regex: "^p.*" } } } )
db.inventory.find( { item: { $not: { $regex: /^p.*/ } } } )

在4.0.6及更低版本中，您可以将$not运算符与正则表达式对象（即/pattern/）一起使用，但不能与$regex 运算符表达式一起使用。

索引使用¶

对于区分大小写的正则表达式查询，如果该字段存在索引，则MongoDB会将正则表达式与索引中的值进行匹配，这可能比集合扫描更快。如果正则表达式是“前缀表达式”，则可能会发生进一步的优化，这意味着所有潜在的匹配都以相同的字符串开头。这允许MongoDB从该前缀构造一个“范围”，并且仅与该范围内的索引值匹配。

如果正则表达式以尖号（^）或左锚（\A）开头，后跟一串简单符号，则为“前缀表达式” 。例如，/^abc.*/将仅通过匹配索引中以开头的值来优化正则表达式abc。

此外，虽然/^a/，/^a.*/和/^a.*$/匹配等效的字符串，但它们具有不同的性能特征。如果存在适当的索引，则所有这些表达式都使用索引；但是，/^a.*/和/^a.*$/较慢。/^a/ 匹配前缀后可以停止扫描。

不区分大小写的正则表达式查询通常不能有效地使用索引。该$regex实现不支持排序规则，并且无法使用不区分大小写的索引。

例子¶

以下示例将集合products与以下文档结合使用：

复制

{ "_id" : 100, "sku" : "abc123", "description" : "Single line description." }
{ "_id" : 101, "sku" : "abc789", "description" : "First line\nSecond line" }
{ "_id" : 102, "sku" : "xyz456", "description" : "Many spaces before     line" }
{ "_id" : 103, "sku" : "xyz789", "description" : "Multiple\nline description" }

执行`LIKE`匹配¶

以下示例匹配sku字段类似的所有文档"%789"：

复制

db.products.find( { sku: { $regex: /789$/ } } )

该示例类似于以下SQL LIKE语句：

复制

SELECT * FROM products
WHERE sku like "%789";

执行不区分大小写的正则表达式匹配¶

以下示例使用i选项对sku值以开头的文档执行 不区分大小写的匹配ABC。

复制

db.products.find( { sku: { $regex: /^ABC/i } } )

该查询与以下文档匹配：

复制

{ "_id" : 100, "sku" : "abc123", "description" : "Single line description." }
{ "_id" : 101, "sku" : "abc789", "description" : "First line\nSecond line" }

从指定模式开始的行的多行匹配¶

以下示例使用该m选项来匹配S多行字符串以字母开头的行：

复制

db.products.find( { description: { $regex: /^S/, $options: 'm' } } )

该查询与以下文档匹配：

复制

{ "_id" : 100, "sku" : "abc123", "description" : "Single line description." }
{ "_id" : 101, "sku" : "abc789", "description" : "First line\nSecond line" }

如果没有该m选项，则查询将仅匹配以下文档：

复制

{ "_id" : 100, "sku" : "abc123", "description" : "Single line description." }

如果该$regex模式不包含锚，则该模式将与整个字符串匹配，如以下示例所示：

复制

db.products.find( { description: { $regex: /S/ } } )

然后，$regex将匹配两个文档：

复制

{ "_id" : 100, "sku" : "abc123", "description" : "Single line description." }
{ "_id" : 101, "sku" : "abc789", "description" : "First line\nSecond line" }

使用`.`点字符来匹配换行符¶

以下示例使用s允许点字符（即.）匹配所有字符（包括换行符）的i选项以及执行不区分大小写的匹配的选项：

复制

db.products.find( { description: { $regex: /m.*line/, $options: 'si' } } )

该查询与以下文档匹配：

复制

{ "_id" : 102, "sku" : "xyz456", "description" : "Many spaces before     line" }
{ "_id" : 103, "sku" : "xyz789", "description" : "Multiple\nline description" }

如果没有该s选项，则查询将仅与以下文档匹配：

复制

{ "_id" : 102, "sku" : "xyz456", "description" : "Many spaces before     line" }

忽略Pattern中的空格¶

以下示例使用x选项“忽略空白”和注释，在匹配模式中#以表示并以结尾\n：

复制

var pattern = "abc #category code\n123 #item number"
db.products.find( { sku: { $regex: pattern, $options: "x" } } )

该查询与以下文档匹配：

复制

{ "_id" : 100, "sku" : "abc123", "description" : "Single line description." }

MongoDB 中文手册

$正则表达式

定义¶

行为¶

$ regex vs./pattern/语法¶

$in表达式¶

隐AND条件字段¶

x和s选项¶

PCRE VS的JavaScript ¶

$regex和$not¶

索引使用¶

例子¶

执行LIKE匹配¶

执行不区分大小写的正则表达式匹配¶

从指定模式开始的行的多行匹配¶

使用.点字符来匹配换行符¶

忽略Pattern中的空格¶

`$in`表达式¶

隐`AND`条件字段¶

`x`和`s`选项¶

`$regex`和`$not`¶

执行`LIKE`匹配¶

使用`.`点字符来匹配换行符¶