$regex (operador de predicado da query)

$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 AND implícitas para o campo

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 compatíveis comPCRE em uma expressão regular que não são suportadas no JavaScript, use o $regex operador e especifique o padrão 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ão regular. Para saber mais sobre PCRE2, consulte a documentação do PCRE.

$regex e a $not

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

• Objetos de expressão regular (/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ão regular que diferenciam maiúsculas de minúsculas, se existir um índice para o campo, o MongoDB corresponderá à expressão regular para os valores no índice. Isso pode ser mais rápido do que uma verificação de collection.

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 dentro do intervalo especificado.

Uma expressão regular é uma " expressão de prefixo " se começar com um sinal de intercalação (^) ou uma âncora à esquerda (\A), seguida por uma string de símbolos simples. Por exemplo, o regex /^abc.*/ é otimizado para corresponder somente aos 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 essas expressões utilizam um índice se existir um índice apropriado. No entanto, /^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 não melhoram o desempenho para queries $regex, pois o operador $regex não é sensível à agrupamentos e, portanto, não pode tirar proveito de tais índices.