Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
Docs Menu
Docs Home
/ /
검색 옵션
Docs Home
/ /
쿼리 참조
/
검색 옵션
Docs Home
/
개발
/
검색
/
쿼리 및 인덱스
/
쿼리 참조
/
검색 옵션

결과 페이지 매김

MongoDB 7.0.5+를 실행 클러스터에서 MongoDB Search를 사용하여 점 이후 또는 이전에 $search 쿼리 결과를 순차적으로 조회 . $search searchAfter 또는 searchBefore 옵션을 사용하여 결과를 순서대로 탐색하고 애플리케이션에 '다음 페이지' 및 '이전 페이지' 함수를 빌드.

사용법

페이지가 매겨진 결과를 조회하려면 다음 단계를 수행하세요.

  1. 쿼리하려는 필드에 대한 인덱스를 만듭니다.

  2. 점 을 반환하는 $search 쿼리 실행합니다. 자세한 학습 은 기준점 조회를 참조하세요.

  3. 후속 $search 쿼리에서 참조 지점을 사용하여 결과의 다음 또는 이전 문서 세트를 검색합니다.

고려 사항

  • 여러 문서가 동일한 값을 가진 필드를 기준으로 정렬할 때 타이가 발생합니다. MongoDB는 연결된 쿼리 결과의 순서를 보장하지 않으므로 searchAfter 및 searchBefore를 사용할 때 중복 및 불일치가 발생할 수 있습니다. 다음 원칙을 적용하여 연관성 점수 동점을 줄이세요.

    • 관련성 점수의 동점을 방지하기 위해 쿼리를 고유 필드로 정렬합니다. 예시는 점수 및 고유 필드별 정렬을 참조하세요.

    • 고유하지 않은 필드 기준으로 주로 정렬하려면 고유 필드 에 세컨더리 정렬 절을 추가하여 순위 결정자 제공 .

  • 쿼리 간에 문서를 업데이트하거나 삭제하면 결과 순서에 일관성 문제가 발생할 수 있습니다. 결정론적 검색 동작을 지원하도록 다음 원칙을 적용합니다.

    • 쿼리 결과를 _id과 같은 불변 필드로 정렬합니다. MongoDB 검색은 초기 쿼리와 후속 쿼리 사이에 컬렉션에 가한 업데이트를 반영합니다. updated_time과 같은 변경 가능한 필드로 정렬한 후 첫 번째와 두 번째 쿼리 사이에 컬렉션을 업데이트하면, MongoDB 검색이 동일한 문서를 다르게 정렬할 수 있습니다.

    • 전용 검색 노드를 배포하고 searchScore로 결과를 정렬하는 경우 다음을 고려합니다.

      • 기본적으로 MongoDB 검색는 MongoDB 검색 노드의 전체 문서 세트에 대한 텀 빈도를 계산하는 bm25 유사성 알고리즘을 사용하여 문서의 점수를 매깁니다. 각 MongoDB 검색 노드는 변경 스트림에서 독립적으로 복제되므로, 이 데이터 세트는 MongoDB 검색 노드마다 다를 수 있습니다. 결과적으로 동일한 쿼리가 다른 MongoDB 검색 노드로 라우팅될 때 서로 다른 bm25 점수를 반환할 수 있습니다. 후속 쿼리는 배포서버가 전용 MongoDB 검색 노드를 사용하거나 읽기 설정 이 secondary 또는 nearest로 설정된 경우, 다른 MongoDB 검색 노드로 라우팅될 가능성이 더 높습니다.

      • 후속 쿼리에서 일관적인 점수를 보장하려면 필드를 MongoDB 검색 string 또 autocomplete 유형으로 인덱스할 때 similarity.type 속성을 stableTfl 또는 boolean으로 설정합니다. 이렇게 하면text, phrase, queryString, autocomplete 연산자가 stableTfl 또는 boolean 유사성 알고리즘을 사용하여 색인된 필드에 대한 쿼리의 관련성 점수를 계산하도록 강제합니다. 이 알고리즘은 모든 MongoDB 검색 노드에서 일관되게 점수를 계산합니다. 자세한 내용은 점수 상세 정보를 참조하세요.

  • 페이지 매김 중에 검색 결과를 계산하려면 초기 $search 쿼리 또는 별도의 $searchMeta 쿼리에서 카운트 옵션을 사용합니다. 이 방법은 단계 이후에 단계를 $count 사용하는 $search 것보다 더 효율적입니다.

    개수 옵션은 검색 기준과 일치하는 총 문서 수를 반환하므로 페이지가 매겨진 결과를 생성하는 경우 이후 쿼리에서 count 옵션을 사용할 필요가 없습니다. 메인 $search 쿼리와 별도로 계산하려면 $searchMeta 단계를 count 옵션과 함께 사용합니다.

    검색 결과를 집계하면 성능에 영향을 미칠 수 있습니다. 개수 옵션은 첫 번째 페이지에 대한 검색 결과를 조회할 때와 같이 필요한 경우에만 사용합니다.

기준점 조회

특정 지점의 쿼리 결과를 검색하려면 $search 쿼리에서 참조 지점을 제공해야 합니다. $search 단계 이후의 $project 단계에서 $meta 키워드 searchSequenceToken을 사용하여 참조 지점을 검색할 수 있습니다.

구문

searchSequenceToken 구문
1[{
2  "$search": {
3    "index": "<index-name>",
4    "<operator-name>"|"<collector-name>": {
5      <operator-specification>|<collector-specification>
6    },
7    "sort": {
8      "score": {
9        "$meta": "searchScore"
10      }
11    },
12    ...
13  },
14  {
15    "$project": {
16       "paginationToken" : { "$meta" : "searchSequenceToken" }
17  },
18  ...
19}]

출력

searchSequenceToken 은 결과의 각 문서에 대해 기본64인코딩된 토큰을 생성합니다. 토큰의 길이는 쿼리의 정렬 옵션에 지정된 필드 수에 따라 늘어납니다. 토큰은 데이터베이스의 스냅샷에 연결되지 않습니다.

쿼리 에 sort 옵션을 지정하지 않는 한 결과의 문서는 기본값 순서로 정렬됩니다. 결과 정렬에 대해 학습하려면 MongoDB 검색 결과 정렬을 참조하세요.

특정 참조 지점 후 Atlas Search

참조 지점 이후를 검색하려면 $search 쿼리에서 searchAfter 옵션과 searchSequenceToken으로 생성된 토큰을 사용하여 참조 지점을 지정해야 합니다. searchSequenceToken에서 생성된 토큰은 searchSequenceToken 토큰을 생성한 $search 쿼리를 다시 실행할 때만 사용할 수 있습니다. 토큰을 사용하는 후속 $search 쿼리의 의미(검색 필드 및 값)는 searchSequenceToken이 토큰을 생성한 쿼리와 동일해야 합니다.

옵션을 사용하여 애플리케이션 에서 '다음 페이지' 함수를 빌드 할 수 있습니다.searchAfter 이에 대한 데모는 이 페이지의 예시 를 참조하세요.

searchAfter 구문

searchAfter 구문
1[{
2  "$search": {
3    "index": "<index-name>",
4    "<operator-name>"|"<collector-name>": {
5      <operator-specification>|<collector-specification>
6    },
7    "searchAfter": "<base64-encoded-token>",
8    "sort": {
9      "score": {
10        "$meta": "searchScore"
11      }
12    },
13    ...
14  },
15  "$project": {
16    "paginationToken" : { "$meta" : "searchSequenceToken" }
17  },
18  ...
19}]

출력

MongoDB Search는 지정된 토큰 뒤의 결과에서 문서를 반환합니다. 줄에 표시된 searchSequenceToken $project 대로 단계 이후 $search 단계에서 11 을(를) 지정했기 때문에 MongoDB Search는 결과에서 문서에 대해 생성된 토큰을 반환합니다. 이러한 토큰은 동일한 의미 체계를 가진 다른 쿼리 의 점 으로 사용할 수 있습니다.

쿼리 에 sort 옵션을 지정하지 않는 한 결과의 문서는 기본값 순서로 정렬됩니다. 결과 정렬에 대해 학습하려면 MongoDB 검색 결과 정렬을 참조하세요.

특정 참조 지점 이전 Atlas Search

기준점 앞에서 Atlas Search를 하려면 searchSequenceToken 에 의해 생성된 토큰과 함께 searchBefore 옵션을 사용하여 $search 쿼리에서 기준점을 지정해야 합니다. searchSequenceToken 이(가) 토큰을 생성한 $search 쿼리를 다시 실행하는 경우에만 searchSequenceToken 에서 생성된 토큰을 사용할 수 있습니다. 토큰을 사용하는 후속 $search 쿼리의 시맨틱(Atlas Search 필드 및 값)은 searchSequenceToken 토큰을 생성한 쿼리와 동일해야 합니다.

searchBefore 옵션을 사용하여 애플리케이션 에서 ' 이전 페이지' 함수를 빌드 할 수 있습니다. 이렇게 하려면 다음을 결합합니다.

이에 대한 searchBefore 데모는 이 페이지의 쿼리 예제를 참조하세요.

searchBefore 구문

searchBefore 구문
1[{
2  "$search": {
3    "index": "<index-name>",
4    "<operator-name>"|"<collector-name>": {
5      <operator-specification>|<collector-specification>
6    },
7    "searchBefore": "<base64-encoded-token>",
8    "sort": {
9      "score": {
10       "$meta": "searchScore"
11     }
12    },
13    ...
14  },
15  "$project": {
16    "paginationToken" : { "$meta" : "searchSequenceToken" }
17  },
18  ...
19}]

searchBefore 출력

MongoDB Search는 지정된 토큰 앞에 오는 결과의 문서를 역순으로 반환합니다. 줄에 표시된 searchSequenceToken $project 대로 단계 이후 $search 단계에서 11 을(를) 지정했기 때문에 MongoDB Search는 결과에서 문서에 대해 생성된 토큰도 반환합니다. 이러한 토큰은 동일한 의미 체계를 가진 다른 쿼리 의 점 으로 사용할 수 있습니다.

예시

다음 예제에서는 메서드를 db.collection.aggregate() 사용하여 sample_mflix $search 데이터베이스 대해 쿼리를 실행 . 첫 번째 예시 쿼리 점 조회 방법을 보여 주며, 이후 예시 쿼리에서 점 이후 또는 이전의 페이지에 대한 추가 결과를 조회 데 사용합니다.

mongosh:에서 이러한 예시 쿼리를 실행 하려면 다음을 수행합니다.

  1. sample_mflix.movies 컬렉션 로드

  2. 동적 매핑을 사용하여 pagination-tutorial 인덱스 만듭니다. 인덱스 만드는 방법을 학습하려면 MongoDB Search 인덱스 관리를 참조하세요.

  3. mongosh 을(를) 사용하여 클러스터에 연결하고 sample_mflix 데이터베이스로 전환합니다.

참고

기본값 으로 MongoDB Search는 문서의 관련성 점수를 기준으로 결과의 문서를 정렬합니다. 결과의 여러 문서에 동일한 점수가 있는 경우 MongoDB Search는 임의로 정렬된 결과를 반환합니다. 문서를 정해진 순서로 반환하기 위해 쿼리는 고유한 필드released을 지정하여 결과를 정렬합니다.

페이지 1 조회 및 페이지 매김 토큰 생성

첫 번째 페이지에 대한 결과를 조회하고 후속 쿼리에 대한 토큰 또는 참조 지점을 조회합니다.

샘플 쿼리는 다음 파이프라인 단계를 사용하여 첫 번째 페이지에 대한 결과를 검색하고 토큰 또는 후속 쿼리에 대한 참조 지점을 검색합니다.

파이프라인 단계
설명

$search

  • 텍스트 연산자를 사용하여 title 필드에 summer가 포함된 제목을 검색합니다.

  • 정렬 옵션을 사용하여 released 필드 값에 따라 결과를 오름차순으로 정렬합니다.

$limit

결과를 10 문서로 제한합니다.

$project

결과에는 문서의 title, released 및 genres 필드만 포함됩니다. 또한 이 쿼리는 결과의 각 문서에 다음 필드를 추가합니다.

  • paginationToken후속 쿼리에서 참조 지점으로 사용할 수 있는 토큰입니다.

  • score결과에서 문서의 관련성 점수입니다.

db.movies.aggregate([
  {
    "$search": {
      "index": "pagination-tutorial",
      "text": {
        "path": "title",
        "query": "summer"
      },
      "sort": { "released": 1 }
    }
  },
  {
    "$limit": 10
  },
  {
    "$project": {
      "_id": 0,
      "title": 1,
      "released": 1,
      "genres": 1,
      "paginationToken": { "$meta" : "searchSequenceToken" },
      "score": { "$meta": "searchScore" }
    }
  }
])
[
  {
    genres: [ 'Drama' ],
    title: "A Summer at Grandpa's",
    paginationToken: 'CKUdGgJgAA==',
    score: 2.262615203857422
  },
  {
    genres: [ 'Musical', 'Romance' ],
    title: 'Summer Stock',
    released: ISODate('1951-01-22T00:00:00.000Z'),
    paginationToken: 'CJsFGgkpAHw/0HT///8=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Comedy', 'Romance' ],
    title: 'Smiles of a Summer Night',
    released: ISODate('1957-12-23T00:00:00.000Z'),
    paginationToken: 'CKIHGgkpAKDlpaf///8=',
    score: 2.0149309635162354
  },
  {
    genres: [ 'Drama' ],
    title: 'Violent Summer',
    released: ISODate('1959-11-13T00:00:00.000Z'),
    paginationToken: 'CI8JGgkpAJhJh7X///8=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Drama', 'Romance' ],
    title: 'A Summer Place',
    released: ISODate('1959-11-18T00:00:00.000Z'),
    paginationToken: 'CLoJGgkpAGQJobX///8=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Drama' ],
    title: 'The End of Summer',
    released: ISODate('1962-02-01T00:00:00.000Z'),
    paginationToken: 'CK0KGgkpAAzP18X///8=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Drama', 'Romance' ],
    title: 'Summer and Smoke',
    released: ISODate('1962-04-01T00:00:00.000Z'),
    paginationToken: 'CMQKGgkpAECmB8f///8=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Documentary', 'Sport' ],
    title: 'The Endless Summer',
    released: ISODate('1968-08-17T00:00:00.000Z'),
    paginationToken: 'CO4MGgkpAJjH5vX///8=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Comedy', 'Drama', 'Romance' ],
    title: "Summer of '42",
    released: ISODate('1971-04-09T00:00:00.000Z'),
    paginationToken: 'CPQQGgkpAGRgUAkAAAA=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Drama' ],
    title: 'That Certain Summer',
    released: ISODate('1972-11-01T00:00:00.000Z'),
    paginationToken: 'COwRGgkpAPQV0hQAAAA=',
    score: 2.579726457595825
  }
]

참고

검색 결과 카운트

페이지 매김 중에 검색 결과를 계산하려면 $searchMeta 쿼리를 카운트 옵션을 사용하여 별도로 실행. 검색 기준과 일치하는 총 문서 수가 포함된 메타데이터 문서 반환합니다.

다음 샘플 쿼리 title 필드 에 summer 이라는 텀 포함된 총 문서 수를 가져옵니다.

db.movies.aggregate([
  {
    "$searchMeta": {
      "index": "pagination-tutorial",
      "text": {
        "path": "title",
        "query": "summer"
      },
      "count": {
         "type": "lowerBound",
         "threshold": 5000
      }
    }
  }
])
[ { count: { lowerBound: Long("65") } } ]

searchAfter를 사용하여 2 페이지 조회

애플리케이션에서 "다음 페이지"와 같은 함수를 빌드하기 위해 결과를 조회하세요.

추가 결과를 조회하려면 결과를 조회할 참조 지점을 지정합니다.

샘플 쿼리 다음 파이프라인 단계를 사용하여 동일한 텀 에 대한 searchSequenceToken 이전 쿼리 에서 가 생성한 토큰을 사용하여 두 번째 페이지에 대한 결과를 조회 .

파이프라인 단계
설명

$search

  • 텍스트 연산자를 사용하여 title 필드에 summer가 포함된 제목을 검색합니다.

  • 쿼리를 실행하여 1 페이지를 검색하고 페이지 매김 토큰을 생성한 결과에서 열 번째 문서와 연결된 페이지 매김 토큰과 함께 searchAfter 옵션을 사용하여 결과에서 열 번째 문서 이후의 문서를 반환합니다.

  • 정렬 옵션을 사용하여 released 필드 값에 따라 결과를 오름차순으로 정렬합니다.

$limit

결과를 10 문서로 제한합니다.

$project

결과에는 문서의 title, released 및 genres 필드만 포함됩니다. 또한 결과의 각 문서에 다음 필드를 추가합니다.

  • paginationToken은 후속 쿼리에서 참조 지점으로 사용할 수 있는 토큰입니다.

  • score결과에서 문서의 관련성 점수입니다.

db.movies.aggregate([
  {
    "$search": {
      "index": "pagination-tutorial",
      "text": {
        "path": "title",
        "query": "summer"
      },
      "searchAfter": "COwRGgkpAPQV0hQAAAA=",
      "sort": { "released": 1 }
    }
  },
  {
    "$limit": 10
  },
  {
    "$project": {
      "_id": 0,
      "title": 1,
      "released": 1,
      "genres": 1,
      "paginationToken" : { "$meta" : "searchSequenceToken" },
      "score": { "$meta": "searchScore" }
    }
  }
])
  
[
  {
    genres: [ 'Drama' ],
    title: 'Summer Wishes, Winter Dreams',
    released: ISODate('1974-09-09T00:00:00.000Z'),
    paginationToken: 'CMwSGgkpAECHcCIAAAA=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Drama', 'Thriller' ],
    title: 'Shadows of a Hot Summer',
    released: ISODate('1978-09-01T00:00:00.000Z'),
    paginationToken: 'CPEVGgkpAGw/qz8AAAA=',
    score: 2.0149309635162354
  },
  {
    genres: [ 'Drama' ],
    title: 'Indian Summer',
    released: ISODate('1978-11-01T00:00:00.000Z'),
    paginationToken: 'CNYRGgkpAFhj5UAAAAA=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Drama' ],
    title: 'Indian Summer',
    released: ISODate('1978-11-01T00:00:00.000Z'),
    paginationToken: 'CNsRGgkpAFhj5UAAAAA=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Drama', 'Mystery' ],
    title: 'One Deadly Summer',
    released: ISODate('1983-05-11T00:00:00.000Z'),
    paginationToken: 'COwcGgkpAAjtIGIAAAA=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Comedy' ],
    title: 'Summer Rental',
    released: ISODate('1985-08-09T00:00:00.000Z'),
    paginationToken: 'CL8fGgkpABTypHIAAAA=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Drama', 'Romance' ],
    title: 'Summer',
    released: ISODate('1986-08-29T00:00:00.000Z'),
    paginationToken: 'CO0gGgkpAHCiY3oAAAA=',
    score: 3.5844719409942627
  },
  {
    genres: [ 'Drama', 'Thriller' ],
    title: 'Summer Camp Nightmare',
    released: ISODate('1987-04-17T00:00:00.000Z'),
    paginationToken: 'CNkiGgkpAHQ/CX8AAAA=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Action', 'Crime', 'Drama' ],
    title: 'Cold Summer of 1953',
    released: ISODate('1988-06-01T00:00:00.000Z'),
    paginationToken: 'CNsjGgkpACjVTYcAAAA=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Drama', 'War' ],
    title: 'That Summer of White Roses',
    released: ISODate('1989-07-11T00:00:00.000Z'),
    paginationToken: 'CI0mGgkpALSEc48AAAA=',
    score: 2.0149309635162354
  }
]

searchBefore를 사용하여 1 페이지로 돌아가기

애플리케이션에서 "이전 페이지"와 같은 함수를 빌드하기 위해 결과를 조회합니다.

이전 결과를 조회하려면 결과를 조회하기 전에 조회할 참조 지점을 지정합니다.

샘플 쿼리 다음 파이프라인 단계를 사용하여 동일한 텀 에 대한 searchSequenceToken 이전 쿼리 에서 에 의해 생성된 토큰을 사용하여 첫 번째 페이지의 결과로 반환합니다.

파이프라인 단계
설명

$search

  • 텍스트 연산자를 사용하여 title 필드에 summer가 포함된 제목을 검색합니다.

  • 2 searchAfter를 사용하여페이지 조회에 실행한 쿼리 결과에서 11번째 문서 와 연결된 페이지 매김 토큰과 함께 옵션을 사용하여 MongoDB Search 결과에서 ~ 문서를 반환합니다.1 10 searchBefore

  • 정렬 옵션을 사용하여 released 필드 값에 따라 결과를 오름차순으로 정렬합니다.

$limit

결과를 10 문서로 제한합니다.

$project

결과에는 문서의 title, released 및 genres 필드만 포함됩니다. 또한 결과의 각 문서에 다음 필드를 추가합니다.

  • paginationToken후속 쿼리에서 참조 지점으로 사용할 수 있는 토큰입니다.

  • score결과에서 문서의 관련성 점수입니다.

참고

기본값 으로 MongoDB Search는 참조 점 이전의 결과를 조회 위해 토큰을 지정하는 쿼리에 대해 결과를 역순으로 반환합니다. 문서를 순서대로 반환하기 위해 쿼리는 toArray() 및 JavaScript reverse() 메서드를 사용합니다.

db.movies.aggregate([
  {
    "$search": {
      "index": "pagination-tutorial",
      "text": {
        "path": "title",
        "query": "summer"
      },
      "searchBefore": "CMwSGgkpAECHcCIAAAA=",
      "sort": { "released": 1 }
    }
  },
  {
    "$limit": 10
  },
  {
    "$project": {
      "_id": 0,
      "title": 1,
      "released": 1,
      "genres": 1,
      "paginationToken" : { "$meta" : "searchSequenceToken" },
      "score": { "$meta": "searchScore" }
    }
  }
]).toArray().reverse()
[
  {
    genres: [ 'Drama' ],
    title: "A Summer at Grandpa's",
    paginationToken: 'CKUdGgJgAA==',
    score: 2.262615203857422
  },
  {
    genres: [ 'Musical', 'Romance' ],
    title: 'Summer Stock',
    released: ISODate('1951-01-22T00:00:00.000Z'),
    paginationToken: 'CJsFGgkpAHw/0HT///8=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Comedy', 'Romance' ],
    title: 'Smiles of a Summer Night',
    released: ISODate('1957-12-23T00:00:00.000Z'),
    paginationToken: 'CKIHGgkpAKDlpaf///8=',
    score: 2.0149309635162354
  },
  {
    genres: [ 'Drama' ],
    title: 'Violent Summer',
    released: ISODate('1959-11-13T00:00:00.000Z'),
    paginationToken: 'CI8JGgkpAJhJh7X///8=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Drama', 'Romance' ],
    title: 'A Summer Place',
    released: ISODate('1959-11-18T00:00:00.000Z'),
    paginationToken: 'CLoJGgkpAGQJobX///8=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Drama' ],
    title: 'The End of Summer',
    released: ISODate('1962-02-01T00:00:00.000Z'),
    paginationToken: 'CK0KGgkpAAzP18X///8=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Drama', 'Romance' ],
    title: 'Summer and Smoke',
    released: ISODate('1962-04-01T00:00:00.000Z'),
    paginationToken: 'CMQKGgkpAECmB8f///8=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Documentary', 'Sport' ],
    title: 'The Endless Summer',
    released: ISODate('1968-08-17T00:00:00.000Z'),
    paginationToken: 'CO4MGgkpAJjH5vX///8=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Comedy', 'Drama', 'Romance' ],
    title: "Summer of '42",
    released: ISODate('1971-04-09T00:00:00.000Z'),
    paginationToken: 'CPQQGgkpAGRgUAkAAAA=',
    score: 2.579726457595825
  },
  {
    genres: [ 'Drama' ],
    title: 'That Certain Summer',
    released: ISODate('1972-11-01T00:00:00.000Z'),
    paginationToken: 'COwRGgkpAPQV0hQAAAA=',
    score: 2.579726457595825
  }
]

searchAfter 및 $skip을 사용하여 2 페이지에서 5 페이지로 이동

애플리케이션에서 페이지 건너뛰기를 허용하는 기능을 빌드하기 위해 결과를 조회합니다.

결과를 건너뛰고 페이지 2에서 5로 이동하려면 searchSequenceToken에서 생성된 토큰을 사용하여 결과를 조회할 참조 지점을 지정한 후 결과에서 문서 20개를 건너뛰세요.

샘플 쿼리 다음 파이프라인 단계를 사용하여 동일한 텀 5 searchSequenceToken 에 대해 이전 쿼리 에서 $skip 에 의해 생성된 토큰과 및 단계를 사용하여 $limit 페이지의 결과로 이동합니다.

파이프라인 단계
설명

$search

  • 텍스트 연산자를 사용하여 title 필드에 summer가 포함된 제목을 검색합니다.

  • 정렬 옵션을 사용하여 released 필드 값에 따라 결과를 오름차순으로 정렬합니다.

  • searchAfter를 사용하여 페이지 2를 조회하기 위해 실행한 쿼리에서 생성된 페이지 매김 토큰을 사용하여 지정된 20번째 문서 이후의 문서를 반환합니다.

$skip

searchAfter를 사용하여 페이지 2를 조회하기 위해 실행한 쿼리 결과의 20번째 문서와 관련된 토큰인 지정된 참조 지점 다음에 있는 결과의 20 개의 문서를 건너뜁니다.

$limit

결과를 10 문서로 제한합니다.

$project

결과에는 문서의 title, released 및 genres 필드만 포함됩니다. 또한 결과의 각 문서에 다음 필드를 추가합니다.

  • paginationToken후속 쿼리에서 참조 지점으로 사용할 수 있는 토큰입니다.

  • score결과에서 문서의 관련성 점수입니다.

db.movies.aggregate([
    {
      "$search": {
        "index": "pagination-tutorial",
        "text": {
          "path": "title",
          "query": "summer"
        },
        "searchAfter": "COwRGgkpAPQV0hQAAAA=",
        "sort": { "released": 1 }
      }
    },
    {
      "$skip": 20
    },
    {
      "$limit": 10
    },
    {
      "$project": {
        "_id": 0,
        "title": 1,
        "released": 1,
        "genres": 1,
        "paginationToken" : { "$meta" : "searchSequenceToken" },
        "score": { "$meta": "searchScore" }
      }
    }
])
[
  {
    genres: [ 'Drama' ],
    title: 'A Storm in Summer',
    released: ISODate('2000-02-27T00:00:00.000Z'),
    paginationToken: 'CO5FGgkpAChakN0AAAA=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Comedy', 'Romance' ],
    title: 'Wet Hot American Summer',
    released: ISODate('2002-04-11T00:00:00.000Z'),
    paginationToken: 'CKtIGgkpAFBUIu0AAAA=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Comedy', 'Drama', 'Romance' ],
    title: 'Summer Things',
    released: ISODate('2002-10-09T00:00:00.000Z'),
    paginationToken: 'CIpPGgkpAFxzxvAAAAA=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Adventure', 'Drama', 'Family' ],
    title: 'Wolf Summer',
    released: ISODate('2003-02-28T00:00:00.000Z'),
    paginationToken: 'COZWGgkpAGS6ofMAAAA=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Animation', 'Adventure' ],
    title: 'Nasu: Summer in Andalusia',
    released: ISODate('2003-06-26T00:00:00.000Z'),
    paginationToken: 'CNlaGgkpAMxoAfYAAAA=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Drama' ],
    title: 'Spring, Summer, Fall, Winter... and Spring',
    released: ISODate('2004-05-28T00:00:00.000Z'),
    paginationToken: 'CJ5ZGgkpAOjnyPwAAAA=',
    score: 1.8161234855651855
  },
  {
    genres: [ 'Comedy', 'Drama', 'Romance' ],
    title: 'Summer Storm',
    released: ISODate('2004-09-02T00:00:00.000Z'),
    paginationToken: 'CMVfGgkpAMRwvP4AAAA=',
    score: 3.000213623046875
  },
  {
    genres: [ 'Drama' ],
    title: 'Summer in the Golden Valley',
    released: ISODate('2004-10-08T00:00:00.000Z'),
    paginationToken: 'CNNWGgkpALTVdf8AAAA=',
    score: 2.0149309635162354
  },
  {
    genres: [ 'Drama', 'Romance' ],
    title: 'My Summer of Love',
    released: ISODate('2005-07-01T00:00:00.000Z'),
    paginationToken: 'CL5aGgkpAEyxzwQBAAA=',
    score: 2.262615203857422
  },
  {
    genres: [ 'Drama' ],
    title: 'Summer in Berlin',
    released: ISODate('2006-01-05T00:00:00.000Z'),
    paginationToken: 'CPZmGgkpANzclwgBAAA=',
    score: 2.579726457595825
  }
]

페이지화된 결과에 패싯 사용

searchSequenceToken을 MongoDB 검색 패싯과 함께 사용합니다.

MongoDB Search facet (MongoDB Search 연산자)를 사용하여 결과를 그룹 하려면 string 필드 token 유형으로 인덱스 해야 합니다. 다음 쿼리 실행 하고 movies 컬렉션 의 genres 필드 기준으로 결과를 그룹 하려면 인덱스 다음 예시 와 유사해야 합니다.

{
  "mappings": {
    "dynamic": true,
      "fields": {
        "genres": {
          "type": "token"
        }
      }
    }
  }
}

샘플 쿼리는 다음 파이프라인 단계를 사용합니다:

파이프라인 단계
설명

$search

  • facet (MongoDB Search Operator) 컬렉터를 사용하여 title 필드에서 summer 가 포함된 제목을 검색합니다.

  • facets 옵션을 사용하여 각 장르의 결과에서 총 영화 수를 조회합니다.

$addFields

searchSequenceToken 옵션을 사용하여 생성된 결과에 각 문서의 토큰을 저장하기 위해 paginationToken 필드를 추가합니다.

$limit

결과를 10 문서로 제한합니다.

$facet

다음과 같은 필드를 반환합니다.

  • docs 이 필드는 결과 및 paginationToken 필드에 있는 문서의 title, released 및 genres 필드만 포함합니다.

  • meta 이 필드는 $$SEARCH_META 변수에 저장된 각 장르의 검색 결과에 포함된 총 영화 수를 포함합니다.

db.movies.aggregate([
    {
      "$search": {
        "index": "pagination-tutorial",
        "facet": {
          "operator": {
            "text": {
              "path": "title",
              "query": "summer"
            } 
          },
          "facets": {
            "genresFacet": {
              "type": "string",
              "path": "genres"
            }
          }
        }
      }
    },
    { 
      "$addFields": {
        "paginationToken" : { "$meta" : "searchSequenceToken" }
      }
    },
    { "$limit": 10 },
    {
      "$facet": {
        "docs": [
          { "$project":
            {
              "_id": 0,
              "title": 1,
              "released": 1,
              "genres": 1,
              "paginationToken" : 1
            }
          }
        ],
        "meta": [
          { "$replaceWith": "$$SEARCH_META" },
          { "$limit": 1 }
        ]
      }
    },
    {
      "$set": {
        "meta": {
          "$arrayElemAt": ["$meta", 0]
        }
      }
    }
])
[
    {
      docs: [
        {
          genres: [ 'Drama', 'Romance' ],
          title: 'Summer',
          released: ISODate('1986-08-29T00:00:00.000Z'),
          paginationToken: 'CO0gFf1nZUA='
        },
        {
          genres: [ 'Musical', 'Romance' ],
          title: 'Summer Stock',
          released: ISODate('1951-01-22T00:00:00.000Z'),
          paginationToken: 'CJsFFYADQEA='
        },
        {
          genres: [ 'Drama' ],
          title: 'Violent Summer',
          released: ISODate('1959-11-13T00:00:00.000Z'),
          paginationToken: 'CI8JFYADQEA='
        },
        {
          genres: [ 'Drama' ],
          title: 'Indian Summer',
          released: ISODate('1978-11-01T00:00:00.000Z'),
          paginationToken: 'CNYRFYADQEA='
        },
        {
          genres: [ 'Drama' ],
          title: 'Indian Summer',
          released: ISODate('1978-11-01T00:00:00.000Z'),
          paginationToken: 'CNsRFYADQEA='
        },
        {
          genres: [ 'Comedy' ],
          title: 'Summer Rental',
          released: ISODate('1985-08-09T00:00:00.000Z'),
          paginationToken: 'CL8fFYADQEA='
        },
        {
          genres: [ 'Comedy', 'Drama', 'Romance' ],
          title: 'Summer Things',
          released: ISODate('2002-10-09T00:00:00.000Z'),
          paginationToken: 'CIpPFYADQEA='
        },
        {
          genres: [ 'Adventure', 'Drama', 'Family' ],
          title: 'Wolf Summer',
          released: ISODate('2003-02-28T00:00:00.000Z'),
          paginationToken: 'COZWFYADQEA='
        },
        {
          genres: [ 'Comedy', 'Drama', 'Romance' ],
          title: 'Summer Storm',
          released: ISODate('2004-09-02T00:00:00.000Z'),
          paginationToken: 'CMVfFYADQEA='
        },
        {
          genres: [ 'Drama', 'Romance' ],
          title: 'Summer Palace',
          released: ISODate('2007-04-18T00:00:00.000Z'),
          paginationToken: 'CIRrFYADQEA='
        }
      ],
      meta: {
        count: { lowerBound: Long('65') },
        facet: {
          genresFacet: {
            buckets: [
              { _id: 'Drama', count: Long('48') },
              { _id: 'Romance', count: Long('20') },
              { _id: 'Comedy', count: Long('19') },
              { _id: 'Family', count: Long('7') },
              { _id: 'Adventure', count: Long('5') },
              { _id: 'Crime', count: Long('5') },
              { _id: 'Mystery', count: Long('5') },
              { _id: 'Thriller', count: Long('5') },
              { _id: 'Horror', count: Long('4') },
              { _id: 'Action', count: Long('3') }
            ]
          }
        }
      }
    }
]

돌아가기

카운트

다음

returnScope

이 페이지의 내용