인

이 페이지의 내용

정의

구문
필드
예시
샘플 인덱스
샘플 쿼리

정의

in 연산자는 지정된 경로에서 BSON number, date, boolean, objectId, uuid 또는 string 값의 배열에 대해 Atlas Search를 수행합니다. 필드 값이 지정된 배열의 임의 값과 동일한 문서를 반환합니다. 필드에 배열이 있는 경우 in 연산자는 지정된 배열의 값과 일치하는 요소가 하나 이상 포함된 배열이 필드에 있는 문서를 선택합니다.

구문

in 연산자의 구문은 다음과 같습니다.

{
  $search: {
    "index": <index name>, // optional, defaults to "default"
    "in": {
      "path": "<field-to-search>",
      "score": <options>,
      "value": <single-or-array-of-values-to-search>
    }
  }
}

필드

필드	유형	설명	필요성
`path`	문자열	검색할 인덱싱된 필드입니다. 와일드카드 경로를 지정하여 검색할 수도 있습니다. 자세한 내용은 쿼리 경로 구성을 참조하세요. 필드에서 string 값을 검색하려면 해당 필드를 Atlas Search 토큰 유형으로 인덱싱해야 합니다.	필수 사항
`score`	객체	일치하는 검색어 결과에 할당할 점수입니다. 다음 옵션 중 하나를 사용하여 기본 점수를 수정합니다. `boost`결과 점수에 주어진 숫자를 곱합니다. `constant`결과 점수를 주어진 숫자로 바꿉니다. `function`: 함수 표현식을 사용하여 결과 점수를 대체합니다.	옵션
`value`	boolean, objectId, number, date, uuid 또는 문자열	검색할 값입니다. Value는 단일 값이거나 지원되는 BSON types 중 하나의 값 배열일 수 있으며 서로 다른 유형을 혼합할 수 없습니다. 필드에서 문자열 값을 검색하려면 해당 필드를 Atlas Search 토큰 유형으로 인덱싱해야 합니다.	필수 사항

예시

다음 예제에서는 in 연산자를 사용하여 sample_analytics.customers 컬렉션의 컬렉션을 쿼리합니다. Atlas 클러스터에 샘플 데이터를 로드하고 컬렉션에 정적 매핑을 사용하는 default라는 Atlas Search 인덱스를 생성하면 컬렉션에 대해 다음 쿼리를 실행할 수 있습니다.

샘플 인덱스

샘플 인덱스 정의는 컬렉션의 인덱싱된 필드에 대한 in 연산자 쿼리를 지원하기 위해 다음 작업을 지정합니다.

컬렉션에서 동적으로 인덱싱할 수 있는 모든 필드를 자동으로 인덱싱합니다.
name 필드를 토큰 유형으로 정적으로 인덱싱하고 필드의 텍스트를 소문자로 변환합니다.

{
  "mappings": {
    "index": "default",
    "dynamic": true,
    "fields": {
      "name": {
        "normalizer": "lowercase",
        "type": "token"
      }
    }
  }
}

Atlas Search 인덱스를 생성하는 방법은 Atlas Search 인덱스 생성을 참조하세요.

샘플 쿼리

다음 쿼리는 지정된 날짜에 태어난 고객에 대해 단일 값이 포함된 birthdate 필드를 Atlas Search하기 위해 in 연산자를 사용합니다. 쿼리는 $project 단계를 사용하여 다음을 수행합니다.

결과에서 _id 필드를 생략합니다.
결과에 name 및 birthdate 필드만 포함합니다.

1 db.customers.aggregate([
2   {
3     "$search": {
4       "in": {
5         "path": "birthdate",
6         "value": [ISODate("1977-03-02T02:20:31.000+00:00"), ISODate("1977-03-01T00:00:00.000+00:00"), ISODate("1977-05-06T21:57:35.000+00:00")]
7       }
8     }
9   },
10   {
11     "$project": {
12       "_id": 0,
13       "name": 1,
14       "birthdate": 1
15     }
16   }
17 ])

1 [
2   {
3     name: 'Elizabeth Ray',
4     birthdate: ISODate("1977-03-02T02:20:31.000Z")
5   },
6   {
7     name: 'Brad Cardenas',
8     birthdate: ISODate("1977-05-06T21:57:35.000Z")
9   }
10 ]

Atlas Search는 쿼리에 지정된 날짜와 일치하는 두 개의 문서를 반환합니다.

다음 쿼리는 in 연산자를 사용하여 계정 번호가 371138, 371139 또는 371140 인 고객에 대해 숫자 배열이 포함된 accounts 필드를 쿼리합니다. 쿼리는 $project 단계를 사용하여 다음을 수행합니다.

결과에서 _id 필드를 생략합니다.
결과에 name 및 accounts 필드만 포함합니다.

1 db.customers.aggregate([
2   {
3     "$search": {
4       "in": {
5         "path": "accounts",
6         "value": [371138, 371139, 371140]
7       }
8     }
9   },
10   {
11     "$project": {
12       "_id": 0,
13       "name": 1,
14       "accounts": 1
15     }
16   }
17 ])

1 [
2   {
3     name: 'Elizabeth Ray',
4     accounts: [ 371138, 324287, 276528, 332179, 422649, 387979 ]
5   }
6 ]

Atlas Search는 쿼리에 지정된 계정 번호 371138 와 일치하는 문서를 하나만 반환합니다.

다음 쿼리는 text 연산자를 사용하여 name 필드에서 이름이 James 인 고객을 쿼리합니다. 쿼리는 _id 필드에 지정된 objectId와 연결된 고객에 대해 in 연산자를 사용하여 기본 설정을 지정합니다. 쿼리는 $limit 단계를 사용하여 출력을 5 결과로 제한하고 $project 단계를 사용하여 다음과 같이 제한합니다.

결과에 _id 및 name 필드만 포함합니다.
결과에 score 이라는 필드를 추가합니다.

1 db.customers.aggregate([
2   {
3     "$search": {
4       "compound": {
5         "must": [{
6           "in": {
7             "path": "name",
8             "value": ["james sanchez", "jennifer lawrence"]
9           }
10         }],
11         "should": [{
12           "in": {
13             "path": "_id",
14             "value": [ObjectId("5ca4bbcea2dd94ee58162a72"), ObjectId("5ca4bbcea2dd94ee58162a91")]
15           }
16         }]
17       }
18     }
19   },
20   {
21     "$limit": 5
22   },
23   {
24     "$project": {
25       "_id": 1,
26       "name": 1,
27       "score": { $meta: "searchScore" }
28     }
29   }
30 ])

1 [
2   {
3     _id: ObjectId("5ca4bbcea2dd94ee58162a72"),
4     name: 'James Sanchez',
5     score: 2
6   },
7   {
8     _id: ObjectId("5ca4bbcea2dd94ee58162a71"),
9     name: 'Jennifer Lawrence',
10     score: 1
11   }
12 ]

Atlas Search는 name 필드에 James Sanchez 및 Jennifer Lawrence 가 포함된 문서를 반환합니다. Atlas Search는 name: 'James Sanchez' 가 포함된 문서가 should 절에 지정된 ObjectId 와 일치하기 때문에 더 높은 점수를 줍니다.

돌아가기

geoWithin

KNNBeta (더 이상 사용되지 않음)

1	db.customers.aggregate([
2	{
3	"$search": {
4	"in": {
5	"path": "birthdate",
6	"value": [ISODate("1977-03-02T02:20:31.000+00:00"), ISODate("1977-03-01T00:00:00.000+00:00"), ISODate("1977-05-06T21:57:35.000+00:00")]
7	}
8	}
9	},
10	{
11	"$project": {
12	"_id": 0,
13	"name": 1,
14	"birthdate": 1
15	}
16	}
17	])

1	[
2	{
3	name: 'Elizabeth Ray',
4	birthdate: ISODate("1977-03-02T02:20:31.000Z")
5	},
6	{
7	name: 'Brad Cardenas',
8	birthdate: ISODate("1977-05-06T21:57:35.000Z")
9	}
10	]

1	[
2	{
3	name: 'Elizabeth Ray',
4	accounts: [ 371138, 324287, 276528, 332179, 422649, 387979 ]
5	}
6	]

1	db.customers.aggregate([
2	{
3	"$search": {
4	"compound": {
5	"must": [{
6	"in": {
7	"path": "name",
8	"value": ["james sanchez", "jennifer lawrence"]
9	}
10	}],
11	"should": [{
12	"in": {
13	"path": "_id",
14	"value": [ObjectId("5ca4bbcea2dd94ee58162a72"), ObjectId("5ca4bbcea2dd94ee58162a91")]
15	}
16	}]
17	}
18	}
19	},
20	{
21	"$limit": 5
22	},
23	{
24	"$project": {
25	"_id": 1,
26	"name": 1,
27	"score": { $meta: "searchScore" }
28	}
29	}
30	])

1	[
2	{
3	_id: ObjectId("5ca4bbcea2dd94ee58162a72"),
4	name: 'James Sanchez',
5	score: 2
6	},
7	{
8	_id: ObjectId("5ca4bbcea2dd94ee58162a71"),
9	name: 'Jennifer Lawrence',
10	score: 1
11	}
12	]