뷰에서 MongoDB Search 인덱스를 생성하여 문서와 컬렉션을 변환할 수 있습니다. 이를 통해 컬렉션을 부분적으로 인덱스하고, 호환되지 않는 데이터 유형 또는 데이터 모델을 지원하는 등의 작업을 수행할 수 있습니다.
The following examples use the sample_mflix and sample_airbnb sample databases.
참고
명확화
이 페이지에서는 표준 보기에 대해 설명합니다. 온디맨드 구체화된 보기에 대한 자세한 내용은 온디맨드 구체화 보기를 참조하세요.
뷰 유형 간의 차이점에 대해 학습하려면 온디맨드 구체화된 뷰 와의 비교를 참조하세요.
요구 사항:
MongoDB 8.0 이상을 사용해야 합니다.
MongoDB v8.0 이상:
Atlas UI 또는 Atlas 관리 API 사용하여 View에 MongoDB Search 인덱스를 생성합니다.
소스 컬렉션 에 대해 MongoDB Search 쿼리를 실행합니다. 뷰에서 생성된 MongoDB Search 인덱스 참조합니다. 이러한 쿼리는 소스 컬렉션 에 나타나는 원본 문서를 반환합니다.
MongoDB v8.1 이상에서는 추가로 다음을 수행할 수 있습니다.
Use
mongoshand Driver methods,db.collection.createSearchIndex(),db.collection.updateSearchIndex(),db.collection.dropSearchIndex(), and$listSearchIndexesto create and manage MongoDB Search indexes on Views.뷰에 대해 MongoDB Search 쿼리를 실행합니다.
MongoDB v8.2 이상에서는 추가로 다음을 수행할 수 있습니다.
Use
$rankFusionin aggregation pipelines on Views.Query Views that include sharded sub-pipelines with
$lookupand$unionWith.
To edit a View, you must have a User Admin role and use the collMod database command.
제한 사항
인덱스 이름은 소스 컬렉션과 모든 보기에서 고유해야 합니다.
MongoDB Search doesn't support view definitions with operators that produce dynamic results, such as the $$USER_ROLES system variable and the
$randaggregation operator.MongoDB Search 쿼리는 소스 컬렉션 에 나타나는 원본 문서를 반환합니다.
- 변환된 문서를 조회하려면
storedSource옵션을 사용합니다.
필요한 권한
To create a View, your role must have the createCollection privilege.
예시
다음 예시에서는 뷰를 만들고 부분 인덱스를 만들고 인덱스를 사용하는 쿼리를 실행하는 방법을 보여줍니다. 예시들은 소스 컬렉션 또는 뷰에 대해 .aggregate 명령을 실행하여 인덱스를 쿼리합니다. MongoDB Search는 MongoDB v8.1 이후 버전에서만 뷰에 대한 쿼리를 직접 지원합니다.
문서를 필터링하여 컬렉션을 부분적으로 인덱싱할 수 있습니다. 다음 예시는 sample_mflix.movies 컬렉션에 보기를 생성하여 2000년 1월 1일 이후에 개봉한 영화만 검색할 수 있도록 합니다.
다음 예시에서는 price 및 cleaningFee 필드의 합계인 새 totalPrice 필드를 기반으로 sample_airbnb.listingsAndReviews 컬렉션에서 숙박 시설을 검색할 수 있습니다. 또한 MongoDB Search는 Decimal128 유형을 지원하지 않으므로 값을 Double로 변환해야 합니다.
To index fields matching a naming pattern, use a View to transform your data so that the fields to index are nested in a sub-document. This enables you to use dynamic mappings for the sub-document path so that you can automatically search all new fields with the suffix _type, without any changes to your index definition.
The following View named listings_SearchableTypes only matches field names that end with _type in the sample_airbnb.listingsAndReviews collection. Specifically, the $set stage adds a new field named searchable_types, which contains the filtered fields with the term _type in the field name. The $arrayToObject contains the filter input (entire document) and condition (regex match for _type).
십진수128 유형 필드에서 검색하려면 값을 double 유형으로 변환하는 것이 좋습니다.
다음 예시에서는 sample_airbnb.listingsAndReviews 네임스페이스에 뷰를 만들어 totalPrice라는 필드를 추가합니다. 이 필드에는 price 필드와 cleaning_fee 필드의 값을 double로 변환한 후의 합계가 포함되어 있습니다.
보기 편집
다음 예시는 2000년 이전 영화에 대한 movies_ReleasedAfter2000 MongoDB 보기를 업데이트합니다.
db.runCommand( { collMod: "movies_ReleasedAfter2000", viewOn: "movies", "pipeline": [ { $match: { $expr: { $lt: [ "$released", ISODate("2000-01-01T00") ] } } } ] } )
이 명령을 실행한 후 MongoDB Search는 보기 정의의 변경 사항을 자동으로 감지하고 다운타임 없이 재인덱싱을 수행합니다.
보기에 대한 파이프라인 반환
다음 예시는 movies_ReleasedAfter2000 보기에서 파이프라인을 반환합니다.
db.getCollectionInfos({ name: "movies_ReleasedAfter2000" })[0].options.pipeline
[ { '$match': { '$expr': { '$gt': [ '$released', ISODate('2000-01-01T00:00:00.000Z') ] } } } ]
성능 고려 사항
Highly complex view transformations can increase indexing and query time. This is because the mongod must read the view definition when it filters and transforms the oplog entries during indexing (initial sync and steady state replication), and when it applies those transformations to the returned documents at query-time.
Atlas 에서 예비 복제 로드를 방지하려면 구체화된 뷰 를 생성하는 것이 좋습니다. 소스 컬렉션 직접 쿼리 뷰 변환으로 인한 쿼리 지연 시간 방지할 수도 있습니다.
문제 해결
인덱스 변경 사항 FAILED
다음 시나리오에서는 인덱스 상태가 FAILED로 변경됩니다.
MongoDB Search와 호환되지 않는 뷰에 인덱스 생성합니다.
MongoDB Search 호환성 요구 사항을 충족하지 않는 방식으로 뷰를 편집합니다.
보기의 소스 컬렉션을 제거하거나 변경한 경우
예를 들어 하나의 보기가 다른 보기를 기반으로 생성되었고 그 상위 보기 소스를 다른 컬렉션으로 변경하는 경우입니다.
참고
이 제한은 뷰가 다른 뷰의 하위인 경우에도 적용됩니다. 예를 들어, 모든 하위 항목의 출처가 되는 소스 컬렉션을 변경하거나 제거할 수 없습니다.
인덱스 변경 사항 STALE
다음 시나리오에서는 인덱스 상태가 STALE로 변경됩니다.
경고
뷰에 정의된 집계 파이프라인이 컬렉션의 문서와 호환되지 않으면 검색 복제가 실패합니다. 예를 들어, 배열이 포함된 문서 필드에서 $toDouble 표현식이 작동하는 경우 복제가 실패합니다. 뷰가 컬렉션의 모든 문서에서 오류 없이 작동하는지 확인하세요.
인덱스
READY인 동안 뷰 정의로 인해 집계 실패가 발생하면 인덱스STALE이(가) 됩니다. 문서 확인하거나 더 이상 실패하지 않도록 뷰 정의를 변경한 후에는 인덱스READY(으)로 돌아갑니다.STALE인 경우 인덱스 쿼리 가능한 상태로 유지됩니다. 인덱스 oplog에서 떨어지면 인덱스 재작성이 트리거됩니다.인덱스가
BUILDING일 때 뷰 정의가 집계 파이프라인 오류를 일으키면 문서를 수정할 때까지 인덱스 생성이 중단됩니다. 문서를 해결하거나 뷰 정의를 변경하여 더 이상 실패하지 않도록 하면 인덱스가READY로 돌아갑니다.
Atlas UI의 인덱스 상태 세부 정보 페이지에서 인덱스 상태를 볼 수 있습니다.
오류: $search 은(는) 파이프라인의 첫 번째 단계로만 유효합니다
이 오류는 8.1 이전 MongoDB 버전을 사용하여 뷰를 쿼리 때 나타납니다.
8.0 이전 MongoDB 버전을 사용하는 경우 8.1+로 업그레이드 뷰를 직접 쿼리 것이 좋습니다. 8.0 으로 업그레이드 소스 컬렉션 쿼리 할 수 있습니다.
MongoDB 8.0을 사용하는 경우 소스 컬렉션 에 대해 뷰 인덱스 쿼리 해야 합니다. 예시 를 들어 보기 대신 컬렉션 에서
.aggregate()를 실행 .
인덱스 프로세스
뷰에서 MongoDB Search 인덱스 생성하면 mongot 프로세스 일반 컬렉션 에서 MongoDB Search 인덱스 생성할 때와 동일한 작업을 수행합니다. mongot 프로세스:
컬렉션 에 대한 인덱스 정의의 규칙을 기반으로 MongoDB Search 인덱스를 생성합니다.
MongoDB Search 인덱스를 정의한 컬렉션의 문서 및 인덱스의 현재 상태 에 대한 변경 스트림을 모니터링합니다.
MongoDB Search 쿼리를 처리하고 일치하는 문서에 대한 문서 ID 및 기타 검색 메타데이터
mongod에 반환한 다음, 전체 문서 조회를 수행하고 결과를 클라이언트 에 반환합니다.
View에 MongoDB 검색 인덱스 만들면 1 단계와 2 단계에서 View 정의가 적용되고 변환된 문서는 검색 인덱스 정의를 기반으로 인덱싱된 다음 디스크에 저장됩니다.
자세히 알아보기
뷰에 대해 자세히 학습 뷰를 참조하세요.
To create a MongoDB Vector Search index on a View, see Use Views with MongoDB Vector Search.