기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# \$1regexFind
<a name="regexFind"></a>

버전 5.0에서 새로 추가되었습니다.

Elastic 클러스터에서는 지원되지 않습니다.

Amazon DocumentDB의 `$regexFind` 연산자는 문서 내의 문자열 필드에서 정규식 일치를 수행하는 데 사용됩니다. 이를 통해 지정된 정규식 패턴과 일치하는 특정 하위 문자열을 검색하고 추출할 수 있습니다.

**파라미터**
+ `input`: 검색할 문자열 필드 또는 표현식입니다.
+ `regex`: 일치시킬 정규식 패턴입니다.
+ `options`: (선택 사항) 대소문자 구분 및 여러 줄 일치와 같은 정규 표현식의 선택적 파라미터를 지정하는 객체입니다. 지원되는 옵션은 `i` (대/소문자 비구분) 및 `m` (다중 줄)입니다.

## 예제(MongoDB 쉘)
<a name="regexFind-examples"></a>

다음 예제에서는 `$regexFind` 연산자를 사용하여 `name` 필드가 특정 정규식 패턴과 일치하는 문서를 검색하는 방법을 보여줍니다.

**샘플 문서 생성**

```
db.users.insertMany([
  { "_id": 1, name: "John Doe", email: "john@example.com" },
  { "_id": 2, name: "Diego Ramirez", email: "diego@example.com" },
  { "_id": 3, name: "Alejandro Rosalez", email: "alejandro@example.com" },
  { "_id": 4, name: "Shirley Rodriguez", email: "shirley@example.com" }
]);
```

**쿼리 예제**

```
db.users.aggregate([
  {
    $project: {
      names: {
        $regexFind: { input: '$name', regex: 'j', options: 'i' }
      }
    }
  },
  { $match: {names: {$ne: null}}}
])
```

이 쿼리는 `name` 필드에 문자 "j"(대소문자 비구분)가 포함된 모든 문서를 반환합니다.

**출력**

```
[
  { _id: 1, names: { match: 'J', idx: 0, captures: [] } }
]
```

**참고:** 쿼리가 Amazon DocumentDB 플래너 버전 1을 사용하는 경우 힌트를 사용하여 인덱스를 활용해야 합니다. 힌트가 없으면 쿼리가 컬렉션 스캔을 수행할 수 있습니다. 플래너 버전을 확인하고 힌트 사용에 대해 자세히 알아보려면 [Amazon DocumentDB Query Planner 설명서](https://docs.aws.amazon.com/documentdb/latest/developerguide/query-planner.html)를 참조하세요.

## 코드 예제
<a name="regexFind-code"></a>

`$regexFind` 명령을 사용하기 위한 코드 예제를 보려면 사용하려는 언어의 탭을 선택합니다.

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function main() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const users = db.collection('users');

  const results = await users.aggregate([
    { $project: { names: { $regexFind: { input: "$name", regex: "john", options: "i" }}}},
    { $match: {names: {$ne: null}}}
  ]).toArray();
  

  console.log(results);

  await client.close();
}

main();
```

------
#### [ Python ]

```
from pymongo import MongoClient

client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
users = db['users']

results = list(users.aggregate([
    { "$project": { "names": { "$regexFind": { "input": "$name", "regex": "john", "options": "i" }}}},
    { "$match": {"names": {"$ne": None}}}
]))

print(results)

client.close()
```

------