$regex

$in Expressões

Para incluir uma expressão regular em um operador de predicado de consulta $in, você só pode usar objetos de expressão regular JavaScript (/pattern/ ).

Por exemplo:

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

Não é possível usar expressões de operador $regex dentro de um operador $in.

Condições implícitas para o campo AND

Para incluir uma expressão regular em uma lista separada por vírgula de condições de consulta para o campo, utilize o operador $regex. Por exemplo:

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

x e s opções

Para usar a opção x ou s, você deve usar a expressão do operador $regex com o operador $options. Por exemplo, para especificar as opções i e s, você deve utilizar $options para ambos:

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

PCRE versus JavaScript

Para usar funcionalidades suportadas por PCRE em uma expressão regular que não são suportadas no JavaScript, você deve usar o operador $regex e especificar a expressão regular como uma string.

Para corresponder strings insensíveis a maiúsculas e minúsculas:

• "(?i)" inicia uma correspondência insensível a maiúsculas e minúsculas.

• "(?-i)" encerra uma correspondência insensível a maiúsculas e minúsculas.

Por exemplo, a expressão regular "(?i)a(?-i)cme" corresponde a strings que:

• Começam com "a" ou "A". Esta é uma correspondência insensível a maiúsculas e minúsculas.

• Terminam com "cme". Esta é uma correspondência insensível a maiúsculas e minúsculas.

Estas strings correspondem ao exemplo de expressão regular:

• "acme"

• "Acme"

O exemplo a seguir usa o operador $regex para encontrar strings de campo name que correspondam à expressão regular "(?i)a(?-i)cme":

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

A partir da versão 6.1, o MongoDB usa a biblioteca PCRE2 (Perl Compatible Regular Expressions) para implementar a correspondência de padrões de expressões regulares. Para saber mais sobre PCRE2, consulte a documentação do PCRE.

$regex e a $not

O operador $not pode executar a operação lógica NOT em ambos:

• Objetos de expressão regular (ou seja, /pattern/)

  Por exemplo:

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

• $regex expressões de operador

  Por exemplo:

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

Consultas que diferenciam maiúsculas ou minúsculas

Para consultas de expressões regulares que diferenciam maiúsculas de minúsculas, se existir um índice para o campo, o MongoDB compara a expressão regular com os valores no índice, o que pode ser mais rápido do que uma verificação de coleção.

Pode ocorrer otimização adicional se a expressão regular for uma "expressão de prefixo", o que significa que todas as possíveis correspondências começam com a mesma string. Isso permite que o MongoDB construa um "intervalo" a partir desse prefixo e corresponda apenas aos valores do índice que se enquadram nesse intervalo.

Uma expressão regular é uma "expressão de prefixo" se começar com um acento circunflexo (^) ou uma âncora esquerda (\A), seguido por uma string de símbolos simples. Por exemplo, o regex /^abc.*/ será otimizado fazendo a correspondência apenas com os valores do índice que começam com abc.

Além disso, embora /^a/, /^a.*/ e /^a.*$/ correspondam a strings equivalentes, eles têm características de desempenho diferentes. Todas estas expressões utilizam um índice se um índice apropriado existir; entretanto, /^a.*/ e /^a.*$/ são mais lentos. /^a/ pode parar a digitalização depois de combinar o prefixo.

Consultas que não diferenciam maiúsculas ou minúsculas

Índices que não diferenciam maiúsculas de minúsculas normalmente não melhoram o desempenho de consultas $regex. A implementação $regex não reconhece agrupamentos e não pode utilizar índices que não diferenciam maiúsculas de minúsculas de forma eficiente.