정규식(쿼리 자 연산자)

정규식 대 /패턴/ 구문

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

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

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

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

인덱스 사용하기

Index use and performance for $regex queries depends on whether the query is case-sensitive or case-insensitive.

LIKE 매치 수행

다음 예시는 sku 필드가 "%789" 과 같은 모든 문서와 일치합니다.

db.products.find( { sku: { $regex: /789$/ } } )

The example is similar to the following SQL LIKE statement:

SELECT * FROM products
WHERE sku like "%789";

출력 예시:

[
   { _id: 101, sku: 'abc789', description: 'First line\nSecond line' },
   { _id: 103, sku: 'xyz789', description: 'Multiple\nline description' },
   { _id: 104, sku: 'Abc789', description: 'SKU starts with A' }
]

대소문자를 구분하지 않는 정규식 일치 수행

The following example uses the i option to perform a case-insensitive match for sku values that start with ABC:

db.products.find( { sku: { $regex: /^ABC/i } } )

출력 예시:

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' },
   { _id: 101, sku: 'abc789', description: 'First line\nSecond line' },
   { _id: 104, sku: 'Abc789', description: 'SKU starts with A' }
]

Match Whole Words Only

Use the \b word boundary anchor to match whole words only. A word boundary matches the position between a word character and a non-word character, or at the start or end of a string.

The following example matches documents where the description field contains the word line as a complete word, but not as part of another word like multiline:

db.products.find( { description: { $regex: /\bline\b/ } } )

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' },
   { _id: 101, sku: 'abc789', description: 'First line\nSecond line' },
   { _id: 102, sku: 'xyz456', description: 'Many spaces before     line' }
]

MongoDB does not return the document with _id: 103 because its description field contains line only as part of the word Multiple\nline. The \n (newline) acts as a word boundary for the second occurrence.

지정된 패턴으로 시작하는 줄에 대한 여러 줄 일치 검색

다음 예시에서는 m 옵션을 사용하여 여러 줄 문자열에 대해 S 문자로 시작하는 줄을 일치시킵니다.

db.products.find( { description: { $regex: /^S/, $options: 'm' } } )

출력 예시:

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' },
   { _id: 101, sku: 'abc789', description: 'First line\nSecond line' },
   { _id: 104, sku: 'Abc789', description: 'SKU starts with A' }
]

m 옵션이 없는 경우 예시 출력은 다음과 같습니다.

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' },
   { _id: 104, sku: 'Abc789', description: 'SKU starts with A' }
]

If the $regex pattern doesn't contain an anchor, the pattern matches against the whole string. For example:

db.products.find( { description: { $regex: /S/ } } )

출력 예시:

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' },
   { _id: 101, sku: 'abc789', description: 'First line\nSecond line' },
   { _id: 104, sku: 'Abc789', description: 'SKU starts with A' }
]

. 점 문자를 사용하여 새 줄과 일치시키기

The following example uses the s option to allow the dot character (.) to match all characters including new line, and the i option to perform a case-insensitive match:

db.products.find( { description: { $regex: /m.*line/, $options: 'si' } } )

출력 예시:

[
   { _id: 102, sku: 'xyz456', description: 'Many spaces before     line' },
   { _id: 103, sku: 'xyz789', description: 'Multiple\nline description' }
]

Without the s option, the query returns:

[
   { _id: 102, sku: 'xyz456', description: 'Many spaces before     line' }
]

패턴에서 공백 무시

다음 예에서는 x 옵션을 사용하여 공백과 일치 패턴에서 # 로 표시되고 \n 로 끝나는 주석을 무시합니다.

var pattern = "abc #category code\n123 #item number"
db.products.find( { sku: { $regex: pattern, $options: "x" } } )

출력 예시:

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' }
]

정규식을 사용하여 문자열의 대소문자 일치시키기

다음 예시에서는 표현식 "(?i)a(?-i)bc" 을(를) 사용하여 sku 필드 문자열이 포함된 항목과 일치시킵니다:

• "abc"

• "Abc"

db.products.find( { sku: { $regex: "(?i)a(?-i)bc" } } )

출력 예시:

[
   { _id: 100, sku: 'abc123', description: 'Single line description.' },
   { _id: 101, sku: 'abc789', description: 'First line\nSecond line' },
   { _id: 104, sku: 'Abc789', description: 'SKU starts with A' }
]

정규식 옵션을 확장하여 ASCII 이외의 문자와 일치시키기

By default, some regex options (such as /b and /w) only recognize ASCII characters. This can cause unexpected results when performing regex matches against UTF-8 characters.

MongoDB 6.1부터는 UTF-8 문자와 일치하도록 *UCP 정규식 옵션을 지정할 수 있습니다.

예를 들어 songs collection에 다음 문서가 있다고 가정해 보겠습니다.

db.songs.insertMany( [
   { _id: 0, "artist" : "Blue Öyster Cult", "title": "The Reaper" },
   { _id: 1, "artist": "Blue Öyster Cult", "title": "Godzilla" },
   { _id: 2, "artist" : "Blue Oyster Cult", "title": "Take Me Away" }
] )

다음 정규식 쿼리는 정규식 일치에서 \b 옵션을 사용합니다. \b 옵션은 단어 경계와 일치합니다.

db.songs.find( { artist: { $regex: /\byster/ } } )

출력 예시:

[
   { _id: 0, artist: 'Blue Öyster Cult', title: 'The Reaper' },
   { _id: 1, artist: 'Blue Öyster Cult', title: 'Godzilla' }
]

The previous results are unexpected because none of the whole words in the returned artist fields begin with the matched string (yster). The Ö character in documents _id: 0 and _id: 1 is ignored when performing the match because Ö is a UTF-8 character.

The expected result is the query doesn't return any documents.

쿼리에서 UTF-8 문자를 인식할 수 있도록 하려면 패턴 앞에 *UCP 옵션을 지정하십시오.

db.songs.find( { artist: { $regex: "(*UCP)/\byster/" } } )

The previous query doesn't return any documents, which is the expected result because none of the whole words in the artist fields begin with the string yster.