Docs Menu
Docs Home
/
Atlas
/ /

MongoDB Search에서 뷰 사용

에 MongoDB Search 인덱스 생성하여 문서 및 컬렉션을 변환하여 컬렉션 부분적으로 인덱스, 호환되지 않는 데이터 유형 또는 데이터 모델 등을 지원 등의 작업을 수행할 수 있습니다.

다음 예시에서는 sample_mflixsample_airbnb 샘플 데이터베이스를 사용합니다.


언어 선택 드롭다운 메뉴를 사용하여 이 페이지의 예시에 사용할 인터페이스 언어를 설정합니다.


참고

명확화

이 페이지에서는 표준 보기에 대해 설명합니다. 온디맨드 구체화된 보기에 대한 자세한 내용은 온디맨드 구체화 보기를 참조하세요.

보기 유형 간의 차이점에 대해 알아보려면 온디맨드 구체화 보기의 비교를 참조하세요.

MongoDB 8.0 이상을 사용해야 합니다.

보기를 편집하려면 사용자 관리자 역할이 있어야 하며 collMod 데이터베이스 명령을 사용해야 합니다.

  • MongoDB Search는 다음 단계로 뷰를 지원합니다.

  • 인덱스 이름은 소스 컬렉션과 모든 보기에서 고유해야 합니다.

  • MongoDB Search는 $$USER_ROLES 시스템 변수 및 $rand 집계 연산자 와 같이 동적 결과를 생성하는 연산자가 있는 뷰 정의를 지원 하지 않습니다.

  • MongoDB Search 쿼리는 소스 컬렉션 에 나타나는 원본 문서를 반환합니다.

  • 변환된 문서를 조회하려면 storedSource 옵션을 사용합니다.

보기를 생성하려면 createCollection 권한이 필요합니다.

컬렉션의 일부만 인덱싱하여 문서를 필터링할 수 있습니다. 다음 예시는 sample_mflix.movies 컬렉션에 보기를 생성하여 2000년 1월 1일 이후에 개봉한 영화만 검색할 수 있도록 합니다.

1

자세한 학습은 mongosh 통해 클러스터에 연결을참조하세요.

2
use sample_mflix
3
db.createView(
"movies_ReleasedAfter2000",
"movies",
[
{
$match: {
$expr: {
$gt: [
"$released",
ISODate("2000-01-01")
]
}
}
}
]
)
4

경고: 탐색 개선 진행 중 현재 새롭고 향상된 탐색 환경을 도입하고 있습니다. 다음 단계가 Atlas UI 의 보기와 일치하지 않는 경우 미리 보기 설명서를 참조하세요.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.

    Clusters(클러스터) 페이지가 표시됩니다.

5

사이드바, Data Explorer 또는 클러스터 세부 정보 페이지에서 MongoDB 검색 페이지 고 (Go) 수 있습니다.

  1. 사이드바에서 Services 제목 아래의 Atlas Search를 클릭합니다.

    클러스터가 없는 경우 Create cluster를 클릭하여 클러스터를 생성합니다. 자세히 알아보려면 클러스터 생성을 참조하세요.

  2. 프로젝트에 여러 클러스터가 있는 경우 Select cluster 드롭다운에서 사용할 클러스터를 선택한 후 Go to Atlas Search를 클릭합니다.

    Atlas Search 페이지가 표시됩니다.

  1. cluster의 Browse Collections 버튼을 클릭합니다.

  2. 데이터베이스를 확장하고 컬렉션을 선택합니다.

  3. 컬렉션의 Search Indexes 탭을 클릭합니다.

    Atlas Search 페이지가 표시됩니다.

  1. 클러스터 이름을 클릭합니다.

  2. Atlas Search 탭을 클릭합니다.

    Atlas Search 페이지가 표시됩니다.

6
7

페이지에서 다음 항목을 선택한 후 Next를 클릭합니다.

Search Type

MongoDB Search 인덱스 유형을 선택합니다.

Index Name and Data Source

다음 정보를 지정합니다.

  • Index Name: releasedAfter2000Index

  • Database and Collection:

    • sample_mflix

    • movies_ReleasedAfter2000

Configuration Method

For a guided experience, select Visual Editor.

To edit the raw index definition, select JSON Editor.

중요:

MongoDB Search 인덱스 의 이름은 기본값 으로 default 으로 지정됩니다. 이 이름을 유지하면 해당 인덱스 연산자에 다른 index 옵션을 지정하지 않는 모든 MongoDB Search 쿼리 대한 기본값 검색 인덱스 됩니다. 여러 인덱스를 생성하는 경우 인덱스 전체에서 일관적인 되고 설명이 포함된 명명 규칙을 유지하는 것이 좋습니다.

8

Atlas는 인덱스가 구축 중임을 알리기 위해 토스트(간단한 비대화형 알림)를 표시합니다.

9

새로 생성된 인덱스가 Atlas Search 탭에 나타납니다. 인덱스가 빌드되는 동안 Status 필드는 Build in Progress를 읽습니다. 인덱스 빌드가 완료되면 Status 필드에 Active가 표시됩니다.

참고: 컬렉션이 클수록 인덱스 데 시간이 오래 걸립니다. 인덱스 작성이 완료되면 이메일 알림을 받게 됩니다.

10

참고

다음 예시는 이름이 movies_ReleasedAfter2000인 뷰에 대해 .aggregate 명령을 실행하여 releasedAfter2000Index 인덱스를 쿼리합니다. 클러스터가 MongoDB v8.0을 실행 중인 경우 뷰의 인덱스를 사용하여 소스 컬렉션(예: movies)을 쿼리해야 합니다. 뷰를 직접 쿼리하려면 MongoDB v8.1+로 업그레이드하세요.

use sample_mflix
db.movies_ReleasedAfter2000.aggregate([
{
$search: {
index: "releasedAfter2000Index",
text: {
path: "title",
query: "foo"
},
sort: {
released: 1
}
}
}
])
[
{
_id: ObjectId('573a13d2f29313caabd929f8'),
plot: "Rising from the ashes of Nirvana, the Foo Fighters became a Grammy-winning sensation on their own. Sixteen years of the band's history comes to life in this documentary, from their demo ...",
genres: [ 'Documentary', 'Music' ],
runtime: 150,
cast: [
'Shawn Cloninger',
'William Goldsmith',
'Jessy Greene',
'Dave Grohl'
],
num_mflix_comments: 0,
poster: 'https://m.media-amazon.com/images/M/MV5BMzE4OTczMTgxM15BMl5BanBnXkFtZTcwNTU1NjQxOA@@._V1_SY1000_SX677_AL_.jpg',
title: 'Foo Fighters: Back and Forth',
fullplot: `Rising from the ashes of Nirvana, the Foo Fighters became a Grammy-winning sensation on their own. Sixteen years of the band's history comes to life in this documentary, from their demo tapes through the creation of their 2011 album, "Wasting Light."`,
languages: [ 'English' ],
released: ISODate('2011-04-05T00:00:00.000Z'),
directors: [ 'James Moll' ],
awards: { wins: 1, nominations: 1, text: '1 win & 1 nomination.' },
lastupdated: '2015-08-19 00:00:25.937000000',
year: 2011,
imdb: { rating: 8.4, votes: 3745, id: 1853563 },
countries: [ 'USA' ],
type: 'movie',
tomatoes: {
viewer: { rating: 4.4, numReviews: 857, meter: 96 },
dvd: ISODate('2011-08-08T00:00:00.000Z'),
website: 'http://us.foofightersfilm.com/',
production: 'Cinedigm Digital Cinema',
lastUpdated: ISODate('2015-09-12T18:42:01.000Z')
}
}
]
1

자세한 학습은 mongosh 통해 클러스터에 연결을참조하세요.

2
use sample_mflix
3
db.createView(
"movies_ReleasedAfter2000",
"movies",
[
{
$match: {
$expr: {
$gt: [
"$released",
ISODate("2000-01-01")
]
}
}
}
]
)
4
db.movies_ReleasedAfter2000.createSearchIndex(
"releasedAfter2000Index",
{
"mappings": {
"dynamic": true
}
}
)
5

참고

다음 예시는 이름이 movies_ReleasedAfter2000인 뷰에 대해 .aggregate 명령을 실행하여 releasedAfter2000Index 인덱스를 쿼리합니다. 클러스터가 MongoDB v8.0을 실행 중인 경우 뷰의 인덱스를 사용하여 소스 컬렉션(예: movies)을 쿼리해야 합니다. 뷰를 직접 쿼리하려면 MongoDB v8.1+로 업그레이드하세요.

use sample_mflix
db.movies_ReleasedAfter2000.aggregate([
{
$search: {
index: "releasedAfter2000Index",
text: {
path: "title",
query: "foo"
},
sort: {
released: 1
}
}
}
])
[
{
_id: ObjectId('573a13d2f29313caabd929f8'),
plot: "Rising from the ashes of Nirvana, the Foo Fighters became a Grammy-winning sensation on their own. Sixteen years of the band's history comes to life in this documentary, from their demo ...",
genres: [ 'Documentary', 'Music' ],
runtime: 150,
cast: [
'Shawn Cloninger',
'William Goldsmith',
'Jessy Greene',
'Dave Grohl'
],
num_mflix_comments: 0,
poster: 'https://m.media-amazon.com/images/M/MV5BMzE4OTczMTgxM15BMl5BanBnXkFtZTcwNTU1NjQxOA@@._V1_SY1000_SX677_AL_.jpg',
title: 'Foo Fighters: Back and Forth',
fullplot: `Rising from the ashes of Nirvana, the Foo Fighters became a Grammy-winning sensation on their own. Sixteen years of the band's history comes to life in this documentary, from their demo tapes through the creation of their 2011 album, "Wasting Light."`,
languages: [ 'English' ],
released: ISODate('2011-04-05T00:00:00.000Z'),
directors: [ 'James Moll' ],
awards: { wins: 1, nominations: 1, text: '1 win & 1 nomination.' },
lastupdated: '2015-08-19 00:00:25.937000000',
year: 2011,
imdb: { rating: 8.4, votes: 3745, id: 1853563 },
countries: [ 'USA' ],
type: 'movie',
tomatoes: {
viewer: { rating: 4.4, numReviews: 857, meter: 96 },
dvd: ISODate('2011-08-08T00:00:00.000Z'),
website: 'http://us.foofightersfilm.com/',
production: 'Cinedigm Digital Cinema',
lastUpdated: ISODate('2015-09-12T18:42:01.000Z')
}
}
]

다음 예시 pricecleaningFee 필드의 합계인 새 totalPrice 필드 를 기반으로 sample_airbnb.listingsAndReviews 컬렉션 에서 숙박 시설을 검색 할 수 있습니다. 또한 MongoDB Search는 Decimal128 유형을 지원 하지 않으므로 값을 Double로 변환합니다.

1

자세한 학습은 mongosh 통해 클러스터에 연결을참조하세요.

2
use sample_airbnb
3
db.createView(
"listingsAndReviews_totalPrice",
"listingsAndReviews",
[
{
$addFields: {
totalPrice: {
$add: [
{
$ifNull: [{ $toDouble: "$price" }, 0]
},
{
$ifNull: [{ $toDouble: "$cleaning_fee" }, 0]
}
]
}
}
}
]
)
4

경고: 탐색 개선 진행 중 현재 새롭고 향상된 탐색 환경을 도입하고 있습니다. 다음 단계가 Atlas UI 의 보기와 일치하지 않는 경우 미리 보기 설명서를 참조하세요.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.

    Clusters(클러스터) 페이지가 표시됩니다.

5

사이드바, Data Explorer 또는 클러스터 세부 정보 페이지에서 MongoDB 검색 페이지 고 (Go) 수 있습니다.

  1. 사이드바에서 Services 제목 아래의 Atlas Search를 클릭합니다.

    클러스터가 없는 경우 Create cluster를 클릭하여 클러스터를 생성합니다. 자세히 알아보려면 클러스터 생성을 참조하세요.

  2. 프로젝트에 여러 클러스터가 있는 경우 Select cluster 드롭다운에서 사용할 클러스터를 선택한 후 Go to Atlas Search를 클릭합니다.

    Atlas Search 페이지가 표시됩니다.

  1. cluster의 Browse Collections 버튼을 클릭합니다.

  2. 데이터베이스를 확장하고 컬렉션을 선택합니다.

  3. 컬렉션의 Search Indexes 탭을 클릭합니다.

    Atlas Search 페이지가 표시됩니다.

  1. 클러스터 이름을 클릭합니다.

  2. Atlas Search 탭을 클릭합니다.

    Atlas Search 페이지가 표시됩니다.

6
7

페이지에서 다음 항목을 선택한 후 Next를 클릭합니다.

Search Type

MongoDB Search 인덱스 유형을 선택합니다.

Index Name and Data Source

다음 정보를 지정합니다.

  • Index Name: totalPriceIndex

  • Database and Collection:

    • sample_airbnb

    • listingsAndReviews_totalPrice

Configuration Method

For a guided experience, select Visual Editor.

To edit the raw index definition, select JSON Editor.

중요:

MongoDB Search 인덱스 의 이름은 기본값 으로 default 으로 지정됩니다. 이 이름을 유지하면 해당 인덱스 연산자에 다른 index 옵션을 지정하지 않는 모든 MongoDB Search 쿼리 대한 기본값 검색 인덱스 됩니다. 여러 인덱스를 생성하는 경우 인덱스 전체에서 일관적인 되고 설명이 포함된 명명 규칙을 유지하는 것이 좋습니다.

8

Atlas는 인덱스가 구축 중임을 알리기 위해 토스트(간단한 비대화형 알림)를 표시합니다.

9

새로 생성된 인덱스가 Atlas Search 탭에 나타납니다. 인덱스가 빌드되는 동안 Status 필드는 Build in Progress를 읽습니다. 인덱스 빌드가 완료되면 Status 필드에 Active가 표시됩니다.

참고: 컬렉션이 클수록 인덱스 데 시간이 오래 걸립니다. 인덱스 작성이 완료되면 이메일 알림을 받게 됩니다.

10

참고

다음 예시는 이름이 listingsAndReviews_totalPrice인 뷰에 대해 .aggregate 명령을 실행하여 totalPriceIndex 인덱스를 쿼리합니다. 클러스터가 MongoDB v8.0을 실행 중인 경우 뷰의 인덱스를 사용하여 소스 컬렉션(예: listingsAndReviews)을 쿼리해야 합니다. 뷰를 직접 쿼리하려면 MongoDB v8.1+로 업그레이드하세요.

use sample_airbnb
db.listingsAndReviews_totalPrice.aggregate([
{
$search: {
index: "totalPriceIndex",
range: {
path: "totalPrice",
lte: 300
},
returnStoredSource: true
}
}
])
[
{ _id: '10006546', totalPrice: 115 },
{ _id: '1001265', totalPrice: 215 },
{ _id: '10021707', totalPrice: 40 },
{ _id: '1003530', totalPrice: 270 },
{ _id: '10038496', totalPrice: 269 },
{ _id: '10051164', totalPrice: 250 },
{ _id: '10057447', totalPrice: 50 },
{ _id: '10057826', totalPrice: 205 },
{ _id: '10059244', totalPrice: 43 },
{ _id: '10066928', totalPrice: 140 },
{ _id: '10082422', totalPrice: 60 },
{ _id: '10083468', totalPrice: 40 },
{ _id: '10084023', totalPrice: 231 },
{ _id: '10091713', totalPrice: 231 },
{ _id: '10092679', totalPrice: 58 },
{ _id: '10096773', totalPrice: 205 },
{ _id: '10112159', totalPrice: 90 },
{ _id: '10117617', totalPrice: 55 },
{ _id: '10120414', totalPrice: 150 },
{ _id: '10133554', totalPrice: 121 }
]
2
use sample_airbnb
3
db.createView(
"listingsAndReviews_totalPrice",
"listingsAndReviews",
[
{
$addFields: {
totalPrice: {
$add: [
{
$ifNull: [{ $toDouble: "$price" }, 0]
},
{
$ifNull: [{ $toDouble: "$cleaning_fee" }, 0]
}
]
}
}
}
]
)
4
db.listingsAndReviews_totalPrice.createSearchIndex(
"totalPriceIndex",
{
"mappings": {
"dynamic": true
},
"storedSource": {
"include": [
"totalPrice"
]
}
}
)
5

참고

다음 예시는 이름이 listingsAndReviews_totalPrice인 뷰에 대해 .aggregate 명령을 실행하여 totalPriceIndex 인덱스를 쿼리합니다. 클러스터가 MongoDB v8.0을 실행 중인 경우 뷰의 인덱스를 사용하여 소스 컬렉션(예: listingsAndReviews)을 쿼리해야 합니다. 뷰를 직접 쿼리하려면 MongoDB v8.1+로 업그레이드하세요.

use sample_airbnb
db.listingsAndReviews_totalPrice.aggregate([
{
$search: {
index: "totalPriceIndex",
range: {
path: "totalPrice",
lte: 300
},
returnStoredSource: true
}
}
])
[
{ _id: '10006546', totalPrice: 115 },
{ _id: '1001265', totalPrice: 215 },
{ _id: '10021707', totalPrice: 40 },
{ _id: '1003530', totalPrice: 270 },
{ _id: '10038496', totalPrice: 269 },
{ _id: '10051164', totalPrice: 250 },
{ _id: '10057447', totalPrice: 50 },
{ _id: '10057826', totalPrice: 205 },
{ _id: '10059244', totalPrice: 43 },
{ _id: '10066928', totalPrice: 140 },
{ _id: '10082422', totalPrice: 60 },
{ _id: '10083468', totalPrice: 40 },
{ _id: '10084023', totalPrice: 231 },
{ _id: '10091713', totalPrice: 231 },
{ _id: '10092679', totalPrice: 58 },
{ _id: '10096773', totalPrice: 205 },
{ _id: '10112159', totalPrice: 90 },
{ _id: '10117617', totalPrice: 55 },
{ _id: '10120414', totalPrice: 150 },
{ _id: '10133554', totalPrice: 121 }
]

다음 예시는 2000년 이전 영화에 대한 movies_ReleasedAfter2000 MongoDB 보기를 업데이트합니다.

db.runCommand(
{
collMod: "movies_ReleasedAfter2000",
viewOn: "movies",
"pipeline": [
{
$match: {
$expr: {
$lt: [
"$released",
ISODate("2000-01-01T00")
]
}
}
}
]
}
)

이 명령을 실행 하면 MongoDB Search는 View 정의의 변경 사항을 자동으로 감지하고 다운타임 없이 재인덱싱을 수행합니다.

다음 예시는 movies_ReleasedAfter2000 보기에서 파이프라인을 반환합니다.

db.getCollectionInfos({ name: "movies_ReleasedAfter2000" })[0].options.pipeline
[
{
'$match': {
'$expr': { '$gt': [ '$released', ISODate('2000-01-01T00:00:00.000Z') ] }
}
}
]

뷰 변환이 매우 복잡하면 Atlas 뷰를 읽어 소스 컬렉션 을 필터하다 하고 변환할 때 성능이 저하될 수 있습니다. 이 시나리오에서는 Atlas 에서 추가 복제 로드를 방지하기 위해 구체화된 뷰 를 생성하는 것이 좋습니다. 뷰 변환으로 인한 쿼리 지연 시간 방지하려면 소스 컬렉션 직접 쿼리 원본 문서를 조회 할 수 있습니다.

다음 시나리오에서는 인덱스 상태가 FAILED로 변경됩니다.

  • MongoDB Search와 호환되지 않는 뷰에 인덱스 생성합니다.

  • MongoDB Search 호환성 요구 사항을 충족하지 않는 방식으로 뷰를 편집합니다.

  • 보기의 소스 컬렉션을 제거하거나 변경한 경우

    예를 들어 하나의 보기가 다른 보기를 기반으로 생성되었고 그 상위 보기 소스를 다른 컬렉션으로 변경하는 경우입니다.

    참고

    이 제한은 뷰가 다른 뷰의 하위인 경우에도 적용됩니다. 예를 들어, 모든 하위 항목의 출처가 되는 소스 컬렉션을 변경하거나 제거할 수 없습니다.

다음 시나리오에서는 인덱스 상태가 STALE로 변경됩니다.

경고

뷰에 정의된 집계 파이프라인이 컬렉션의 문서와 호환되지 않으면 검색 복제가 실패합니다. 예를 들어, 배열이 포함된 문서 필드에서 $toDouble 표현식이 작동하는 경우 복제가 실패합니다. 뷰가 컬렉션의 모든 문서에서 오류 없이 작동하는지 확인하세요.

  • 인덱스 READY인 동안 뷰 정의로 인해 집계 실패가 발생하면 인덱스 STALE이(가) 됩니다. 문서 확인하거나 더 이상 실패하지 않도록 뷰 정의를 변경한 후에는 인덱스 READY (으)로 돌아갑니다. STALE인 경우 인덱스 쿼리 가능한 상태로 유지됩니다. 인덱스 oplog에서 떨어지면 인덱스 재작성이 트리거됩니다.

  • 인덱스가 BUILDING일 때 뷰 정의가 집계 파이프라인 오류를 일으키면 문서를 수정할 때까지 인덱스 생성이 중단됩니다. 문서를 해결하거나 뷰 정의를 변경하여 더 이상 실패하지 않도록 하면 인덱스가 READY로 돌아갑니다.

Atlas UI의 인덱스 상태 세부 정보 페이지에서 인덱스 상태를 볼 수 있습니다.

이 오류는 8.1 이전 MongoDB 버전을 사용하여 뷰를 쿼리 때 나타납니다.

  • 8.0 이전 MongoDB 버전을 사용하는 경우 8.1+로 업그레이드 뷰를 직접 쿼리 것이 좋습니다. 8.0 으로 업그레이드 소스 컬렉션 쿼리 할 수 있습니다.

  • MongoDB 8.0을 사용하는 경우 소스 컬렉션 에 대해 뷰 인덱스 쿼리 해야 합니다. 예시 를 들어 보기 대신 컬렉션 에서 .aggregate() 를 실행 .

뷰에서 MongoDB Search 인덱스 생성하면 mongot 프로세스 일반 컬렉션 에서 MongoDB Search 인덱스 생성할 때와 동일한 작업을 수행합니다. mongot 프로세스:

  1. 컬렉션 에 대한 인덱스 정의의 규칙을 기반으로 MongoDB Search 인덱스를 생성합니다.

  2. MongoDB Search 인덱스를 정의한 컬렉션의 문서 및 인덱스의 현재 상태 에 대한 변경 스트림을 모니터링합니다.

  3. MongoDB Search 쿼리를 처리하고 일치하는 문서에 대한 문서 ID 및 기타 검색 메타데이터 mongod에 반환한 다음, 전체 문서 조회를 수행하고 결과를 클라이언트 에 반환합니다.

View에 MongoDB Search 인덱스 생성하면 1 및 2 단계에서 View 정의가 적용되고 변환된 문서는 디스크의 MongoDB Search 인덱스 에 저장됩니다.

뷰에 대한 자세한 내용은 를 참조하세요.

뷰에 MongoDB Vector Search 인덱스 만들려면 MongoDB Vector Search에 뷰 사용을 참조하세요.

돌아가기

다중 컬렉션

이 페이지의 내용