$regex（クエリ述語演算子）

$in 式

$inクエリ述語演算子に正規表現を含めるには、JavaScript 正規表現オブジェクトのみを使用できます（ /pattern/ ）。

以下に例を挙げます。

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

$in 演算子内では $regex 演算子式を使用できません。

フィールドの暗黙的な 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 オプション

To use either the x option or s options, you must use the $regex operator expression with the $options operator. For example, to specify the i and the s options, you must use $options for both:

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

PCRE と JavaScript

JavaScript でサポートされていない正規式で、PCRE でサポートされている機能を使用するには、$regex 演算子を使用し、パスワードなしを string として指定します。

大文字と小文字を区別しない文字列を一致させるには次のとおり。

• "(?i)" は、大文字と小文字を区別しない一致を開始します。

• "(?-i)" は、大文字と小文字を区別しない一致を終了します。

たとえば、正規表現"(?i)a(?-i)cme" は、次の文字列と一致します。

• "a" または "A" ではじまる文字列。これは、大文字と小文字を区別しない一致です。

• "cme" で終了する文字列。これは大文字と小文字を区別する一致です。

以下の文字列は、例の正規表現と一致します。

• "acme"

• "Acme"

次の例では、$regex 演算子を使用して、正規表現 "(?i)a(?-i)cme" と一致する name フィールドの文字列を検索します。

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

バージョン 6.1 以降、MongoDB は、正規式によるパターン一致を実装するためにPerl互換正規表現 (PCRE2) ライブラリを使用します。PCRE2 の詳細については、PCRE ドキュメント を参照してください。

$regex および $not

$not 演算子は次の両方で論理 NOT操作を実行できます。

• 正規式オブジェクト（/pattern/）

  以下に例を挙げます。

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

• $regex 演算子式

  以下に例を挙げます。

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

大文字と小文字を区別するクエリ

大文字と小文字を区別する正規式クエリでは、フィールドにインデックスが存在する場合、 MongoDB はインデックス内の値の正規式を照合します。これは、コレクションスキャンよりも高速です。

正規式が「プレフィックス式」の場合、さらに最適化を行うことができます。一致する可能性のあるものはすべて同じ string で始まるということを意味します。これにより、 MongoDB はそのプレフィックスから「範囲」を構築し、指定された範囲内のインデックスの値のみと一致させることができます。

正規式は、キャレット（^）または左アンカー（\A）で始まり、その後に単純な記号の string が続く場合、「プレフィックス式」です。例、正規表現 /^abc.*/ は、abc で始まるインデックスの値のみと一致するように最適化されています。

さらに、/^a/、/^a.*/、/^a.*$/ は同等の文字列と一致しますが、パフォーマンス特性は異なります。これらの式はすべて、適切なインデックスが存在する場合はインデックスを使用します。ただし、/^a.*/ と /^a.*$/ は遅くなります。/^a/ はプレフィックスと一致した後、スキャンを停止することができます。

大文字と小文字を区別しないクエリ

Case-insensitive indexes do not improve performance for $regex queries, as the $regex operator is not collation-aware and therefore cannot take advantage of such indexes.