`$regex` în MongoDB & NoSQL

Operatori de Interogare & Filtrare MongoDB 1.x

Operatorul $regex caută șiruri de caractere care se potrivesc unei expresii regulate (PCRE), cu opțiuni ca i pentru majuscule.

Sintaxă

{ <camp>: { $regex: /tipar/, $options: 'i' } }
{ <camp>: /tipar/i }

Ce face `$regex`

$regex găsește documentele în care un câmp text se potrivește unei expresii regulate. În mongosh poți scrie direct literalul JavaScript /tipar/i sau forma { $regex: 'tipar', $options: 'i' }. Opțiuni: i (ignoră majusculele), m (multilinie), x, s.

Doar tiparele ancorate la început (/^Ana/), sensibile la majuscule, pot folosi eficient un index. Un tipar ca /ana/i verifică fiecare valoare din index sau din colecție, deci e lent pe colecții mari. Pentru căutare de cuvinte în texte, un index text sau Atlas Search sunt mai potrivite.

Parametri

Parametru	Descriere
`$regex`	Expresia regulată (literal /…/ sau șir).
`$options`	`i`, `m`, `x`, `s`.

Ce returnează

Un cursor cu documentele găsite.

Exemple

Exemplele de pe această pagină pornesc de la datele de mai jos. Rulează mai întâi acest cod, apoi exemplul.

use magazin
db.clienti.insertMany([
  { _id: 1, nume: 'Ana', email: 'ana@exemplu.ro', telefon: '0722000111' },
  { _id: 2, nume: 'Dan', email: null },
  { _id: 3, nume: 'Ioana', email: 'ioana@exemplu.ro', varsta: 28 },
  { _id: 4, nume: 'Mihai', varsta: '35' }
])

Exemplul 1: Adrese de email de pe un domeniu

Punctul se scrie \., iar $ ancorează la final.

db.clienti.find({ email: { $regex: /@exemplu\.ro$/ } }, { nume: 1, email: 1 })

Ieșire în mongosh

[
  { _id: 1, nume: 'Ana', email: 'ana@exemplu.ro' },
  { _id: 3, nume: 'Ioana', email: 'ioana@exemplu.ro' }
]

Exemplul 2: Nume care încep cu „an”, fără să conteze majusculele

Opțiunea i potrivește și „Ana”.

db.clienti.find({ nume: { $regex: '^an', $options: 'i' } }, { nume: 1 })