$regex

$in Expresiones

Para incluir una expresión regular en un operador de predicado de query $in, solo pueden utilizarse objetos de expresión regular de JavaScript (/pattern/ ).

Por ejemplo:

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

No puede usar expresiones de operador $regex dentro de un operador $in.

Condiciones implícitas AND para el campo

Para incluir una expresión regular en una lista separada por comas de condiciones de query para el campo, utilizar el operador $regex. Por ejemplo:

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

x y s Opciones

Para usar la opción x o las opciones s, debes usar la expresión del operador $regex con el operador $options. Por ejemplo, para especificar las opciones i y s, debes usar $options para ambas:

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

PCRE frente a JavaScript

Para utilizar Para las funciones compatibles conPCRE en una expresión regular que no son compatibles con JavaScript, debe usar el $regex operador y especificar la expresión regular como una cadena.

Para coincidir cadenas sin distinguir entre mayúsculas y minúsculas:

• "(?i)" inicia una coincidencia sin distinguir entre mayúsculas y minúsculas.

• "(?-i)" termina una coincidencia que no distingue entre mayúsculas y minúsculas.

Por ejemplo, la expresión regular "(?i)a(?-i)cme" coincide con cadenas que:

• Comienza con "a" o "A". Esto es una coincidencia insensible a mayúsculas y minúsculas.

• Finalizar con "cme". Esta es una coincidencia que distingue entre mayúsculas y minúsculas.

Estas cadenas coinciden con la expresión regular de ejemplo:

• "acme"

• "Acme"

El siguiente ejemplo utiliza el operador $regex para encontrar cadenas de campo name que coincidan con la expresión regular "(?i)a(?-i)cme":

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

A partir de la 6.1 versión, MongoDB utiliza la2 biblioteca PCRE (Perl Compatible Regular Expressions) para implementar la coincidencia de patrones de expresiones regulares. Para obtener más información sobre PCRE,2 consulte la documentación de PCRE.

$regex y $not

El operador$not puede realizar una operación lógica NOT en ambos:

• Objetos de expresiones regulares (es decir, /pattern/)

  Por ejemplo:

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

• $regex expresiones de operador

  Por ejemplo:

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

Los query que distinguen entre mayúsculas y minúsculas

Para los query de expresiones regulares que distinguen entre mayúsculas y minúsculas, si existe un índice para el campo, MongoDB compara la expresión regular con los valores del índice, lo que puede ser más rápido que un escaneo de colección.

Se puede lograr una mayor optimización si la expresión regular es una "expresión de prefijo", lo que significa que todas las coincidencias potenciales comienzan con la misma string. Esto permite a MongoDB construir un "rango" a partir de ese prefijo y solo coincidir con aquellos valores del índice que encajan dentro de ese rango.

Una expresión regular es una "expresión de prefijo" si comienza con un signo de intercalación (^) o un ancla izquierda (\A), seguido de un string de símbolos simples. Por ejemplo, la expresión regular /^abc.*/ se optimizará al coincidir solo con los valores del índice que comienzan con abc.

Además, aunque /^a/, /^a.*/ y /^a.*$/ coinciden con cadenas equivalentes, tienen diferentes características de rendimiento. Todas estas expresiones utilizan un índice si existe un índice apropiado; sin embargo, /^a.*/ y /^a.*$/ son más lentos. /^a/ puede dejar de escanear después de encontrar una coincidencia con el prefijo.

Los query que no detectan mayúsculas ni minúsculas

Los índices que distinguen entre mayúsculas y minúsculas no mejoran el rendimiento de los query $regex, ya que el operador $regex no es consciente de la intercalación y, por lo tanto, no puede aprovechar dichos índices.