Paginar os resultados

Em clusters Atlas executando MongoDB 6.0.13+ ou 7.0.5+, use o Atlas Search para recuperar os resultados da sua query $search sequencialmente depois ou antes de um ponto de referência. Use as opções $search searchAfter ou searchBefore para percorrer os resultados em ordem e criar funções "Próxima página" e "Página anterior" em seu aplicativo.

Uso

Para recuperar resultados paginados, execute as seguintes etapas:

Crie um índice nos campos que você deseja consultar.
Execute uma query $search que retorna um ponto de referência. Para saber mais, consulte Recuperar ponto de referência.
Use o ponto de referência em sua query $search subsequente para recuperar o conjunto de documentos seguinte ou anterior nos resultados.
- Para saber mais sobre como recuperar resultados para criar uma função "Próxima página", consulte Atlas Search após um ponto de referência específico.
- Para saber mais sobre como recuperar resultados para criar uma função de "Página anterior", consulte Atlas Search antes de um ponto de referência específico.
- Para ir para uma página em seus resultados, combine $skip e $limit com as opções $search searchAfter ou searchBefore. Por exemplo, para ir para os resultados da página 3 para a página 5, com 10 resultados por página, faça o seguinte:
  1. Recupere resultados usando searchAfter com o ponto de referência do último resultado na página 3 (Result 30).
  2. Use $skip para pular os resultados 10 na página 4 (Resultados 31-40) e $limit para limitar os resultados a 10 documentos.
  3. Retorne resultados para a página 5 (Resultados 41-50).
  Aqui, usar $skip com a opção searchAfter otimiza a query para ignorar somente a página de resultados 1 (documentos 10). Por comparação, se você usar $skip sem a opção $search searchAfter, a query pulará 4 páginas de resultados (40 documentos). Para saber mais, consulte Saltar da página 2 para a página 5 Usando searchAfter e $skip.

Considerações

Um empate ocorre quando você classifica em um campo para o qual vários documentos têm valores idênticos. O MongoDB não garante a ordenação de resultados de query vinculados, o que pode levar à duplicação e inconsistência quando você usa searchAfter e searchBefore. Aplique os seguintes princípios para garantir um comportamento de pesquisa determinístico:

Classifique sua query por um campo exclusivo para evitar empates de pontuação de relevância.
Se você quiser classificar principalmente por um campo não exclusivo, adicione uma cláusula de classificação secundária em um campo exclusivo para servir como desempate.
Classifique os resultados da consulta por um campo imutável. O Atlas Search reflete as atualizações que você faz em sua collection entre as queries inicial e subsequentes. Se você classificar por um campo mutável como updated_time e atualizar sua coleção entre a primeira e a segunda queries, o Atlas Search poderá ordenar os mesmos documentos de forma diferente.

Para aprender como classificar os resultados da query por um campo imutável ou único, consulte Classificar resultados do Atlas Search.

Se você distribuiu nós de pesquisa, considere o seguinte:

Evite classificar os resultados por searchScore porque ele pode ser diferente em todos os nós de pesquisa.
Para calcular searchScore, um host leva em consideração todos os documentos existentes nele, incluindo documentos excluídos que ainda não foram removidos do índice. Como a exclusão ocorre de forma independente em cada host, isso pode causar alterações em searchScore dependendo de para qual host a query é roteada.

Para oferecer suporte à paginação ao classificar por searchScore nos nós de pesquisa, vote nesta solicitação no MongoDB Feedback Engine.

Recuperar ponto de referência

Para recuperar resultados de query em um determinado ponto, você deve fornecer o ponto de referência em sua query $search . Você pode recuperar o ponto de referência usando a palavra-chave $meta searchSequenceToken no estágio $project após o estágio $search .

Sintaxe

Sintaxe do 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", _id:1
10       }
11     }
12     ...
13   },
14   {
15     "$project": {
16       { "paginationToken" : { "$meta" : "searchSequenceToken" } }
17   },
18   ...
19 }]

Saída

O searchSequenceToken gera um token codificado de Base64para cada documento nos resultados. O comprimento do token aumenta com o número de campos especificados na opção de classificação da sua query. O token não está vinculado a um snapshot do banco de dados.

Os documentos nos resultados são classificados na ordem padrão, a menos que você especifique a opção sort em sua query. Para saber mais sobre como classificar seus resultados, consulte Classificar resultados do Atlas Search.

Atlas Search após um ponto de referência específico

Para pesquisar um ponto de referência, você deve especificar o ponto de referência em sua query $search usando a opção searchAfter com o token gerado por searchSequenceToken. Você pode usar o token gerado por searchSequenceToken somente ao executar novamente a query $search para a qual searchSequenceToken gerou o token. A semântica (campos e valores de pesquisa) da query $search subsequente na qual você usa o token deve ser idêntica à query para a qual searchSequenceToken gerou o token.

Você pode utilizar a opção searchAfter para construir uma função "Próxima Página" em seu aplicativo. Para uma demonstração disso, consulte o exemplo nesta página.

`searchAfter` Sintaxe

Sintaxe 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", _id:1
11       }
12     }
13     ...
14   },
15   "$project": {
16     { "paginationToken" : { "$meta" : "searchSequenceToken" } }
17   },
18   ...
19 }

Saída

O Atlas Search retorna os documentos nos resultados após o token especificado. O Atlas Search retorna os tokens gerados para os documentos nos resultados porque você especificou o searchSequenceToken no estágio $project após o estágio $search (como mostrado na linha 11). Esses tokens podem ser usados como ponto de referência para outra query com a mesma semântica.

Atlas Search antes de um ponto de referência específico

Para o Atlas Search antes de um ponto de referência, você deve especificar o ponto de referência em sua query do $search utilizando a opção searchBefore com o token gerado pelo searchSequenceToken. Você pode usar o token gerado por searchSequenceToken somente quando executar novamente a query $search para a qual searchSequenceToken gerou o token. A semântica (campos e valores do Atlas Search ) da query subsequente do $search subsequente na qual você usa o token deve ser idêntica à query para a qual o searchSequenceToken gerou o token.

Você pode criar uma função "Página anterior" em seu aplicativo usando a opção searchBefore . Para criar uma função "Página anterior", combine o seguinte:

$search estágio com opção searchBefore
$limit estágio
toArray() e reverse() métodos.

Para uma demonstração disso, veja exemplos de query searchBefore nesta página.

`searchBefore` Sintaxe

Sintaxe 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", _id:1
11       }
12     }
13     ...
14   },
15   "$project": {
16     { "paginationToken" : { "$meta" : "searchSequenceToken" } }
17   },
18   ...
19 }

`searchBefore` Saída

O Atlas Search retorna documentos nos resultados anteriores ao token especificado na ordem inversa. O Atlas Search também retorna os tokens gerados para os documentos nos resultados porque você especificou o searchSequenceToken no estágio $project após o estágio $search (conforme mostrado na linha 11). Esses tokens podem ser usados como um ponto de referência para outra query com a mesma semântica.

Exemplos

Os exemplos a seguir usam a coleção sample-mflix.movies, que tem um índice do Atlas Search chamado default com mapeamentos dinâmicos. Se você carregar a coleção e criar o índice, poderá executar as seguintes queries na coleção.

As queries demonstram como recuperar um ponto de referência, que você então usa nas queries subsequentes para recuperar resultados adicionais para o mesmo termo antes e depois do ponto de referência especificado.

Estes exemplos demonstram como executar as seguintes tarefas:

Obter a página 1 e gerar tokens de paginação
Recuperar página 2 usando searchAfter
Retornar à página 1 Usando o searchBefore
Pule da página 2 para a página 5 usando searchAfter e $skip
Usar faceta com os resultados paginados

Observação

Por padrão, o Atlas Search classifica os documentos nos resultados pela pontuação de relevância dos documentos. Se vários documentos nos resultados tiverem pontuações idênticas, o Atlas Search retornará resultados ordenados arbitrariamente. Para retornar documentos em uma determinada ordem, as queries especificam um campo exclusivo, released, para classificar os resultados.

Obter a página 1 e gerar tokens de paginação

Recupere resultados para a primeira página e recupere tokens ou um ponto de referência para consultas subsequentes.

A query de amostra usa os seguintes estágios do pipeline para recuperar resultados para a primeira página e recuperar tokens ou um ponto de referência para queries subsequentes:

`$search`	Pesquisa títulos que contenham `summer` no campo `title` usando o operador de texto. Classifica os resultados pelo valor do campo `released` em ordem crescente usando a opção sort.
`$limit`	Limita os resultados a `10` documentos.
`$project`	Inclui somente os campos `title`, `released`, e `genres` dos documentos nos resultados. A query também adiciona os seguintes campos a cada documento nos resultados: `paginationToken`, que é o token que pode ser usado como ponto de referência em consultas subsequentes `score`, que é a pontuação de relevância do documento nos resultados

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
  }
]

Recuperar página 2 usando searchAfter

Recupere resultados para criar uma função como "Próxima página" em seu aplicação.

Para recuperar resultados adicionais, especifique o ponto de referência após o qual você deseja recuperar os resultados.

A query de amostra usa os seguintes estágios de pipeline para recuperar resultados para a segunda página usando o token gerado por searchSequenceToken na query anterior para o mesmo termo:

`$search`	Pesquisa títulos que contenham `summer` no campo `title` usando o operador de texto. Classifica os resultados pelo valor do campo `released` em ordem crescente usando a opção sort. Retorna documentos após o décimo documento nos resultados, que a consulta especifica usando o token de paginação gerado pela consulta executada para Recuperar página 1 e Gerar tokens de paginação.
`$limit`	Limita os resultados a `10` documentos.
`$project`	Inclui somente os campos `title`, `released`, e `genres` dos documentos nos resultados. Ele também adiciona os seguintes campos a cada documento nos resultados: `paginationToken`, que é o token que pode ser usado como ponto de referência em queries subsequentes `score`, que é a pontuação de relevância do documento nos resultados

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
  }
]

Retornar à página 1 Usando o searchBefore

Recupere resultados para criar uma função como "Página anterior" em seu aplicação.

Para recuperar resultados anteriores, especifique o ponto de referência antes do qual você deseja recuperar os resultados.

A query de amostra usa os seguintes estágios de pipeline para retornar aos resultados na primeira página usando o token gerado por searchSequenceToken na query anterior para o mesmo termo:

`$search`	Pesquisa títulos que contenham `summer` no campo `title` usando o operador de texto. Classifica os resultados pelo valor do campo `released` em ordem crescente usando a opção sort. Retorna documentos 1 a 10 nos resultados do Atlas Search usando o token de paginação associado ao décimo primeiro documento nos resultados da query que você executou para Recuperar a página 2 usando searchAfter.
`$limit`	Limita os resultados a `10` documentos.
`$project`	Inclui somente os campos `title`, `released`, e `genres` dos documentos nos resultados. Ele também adiciona os seguintes campos a cada documento nos resultados: `paginationToken`, que é o token que pode ser usado como ponto de referência em consultas subsequentes `score`, que é a pontuação de relevância do documento nos resultados

Observação

Por padrão, o Atlas Search retorna os resultados na ordem inversa para consultas que especificam tokens para recuperar resultados antes de um ponto de referência. Para retornar documentos em ordem, a consulta usa os métodos toArray() e 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
  }
]

Pule da página 2 para a página 5 usando searchAfter e $skip

Recupere resultados para criar uma função em seu aplicação que permita pular páginas.

Para ignorar resultados e pular da página 2 para 5, use o token que o searchSequenceToken gera para especificar o ponto de referência após o qual você deseja recuperar os resultados e, em seguida, ignorar vinte documentos nos resultados.

A query de amostra usa os seguintes estágios do pipeline para acessar os resultados na página 5 usando o token gerado por searchSequenceToken da query anterior para o mesmo termo e usando os estágios $skip e $limit:

`$search`	Pesquisa títulos que contenham `summer` no campo `title` usando o operador de texto. Classifica os resultados pelo valor do campo `released` em ordem crescente usando a opção sort. Retorna documentos após o vigésimo documento especificado usando o token de paginação gerado pela query que você executou para Recuperar página 2 usando searchAfter.
`$skip`	Ignora 20 documentos nos resultados após o ponto de referência especificado, que é o token associado ao vigésimo documento nos resultados da query que você executou para Recuperar página 2 usando searchAfter.
`$limit`	Limita os resultados a `10` documentos.
`$project`	Inclui somente os campos `title`, `released`, e `genres` dos documentos nos resultados. Ele também adiciona os seguintes campos a cada documento nos resultados: `paginationToken`, que é o token que pode ser usado como ponto de referência em consultas subsequentes `score`, que é a pontuação de relevância do documento nos resultados

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
  }
]

Usar faceta com os resultados paginados

Use searchSequenceToken com facets Atlas Search .

Para agrupar resultados usando a faceta Atlas Search, você deve indexar qualquer campo string como o tipo stringFacet. Para executar a seguinte query e agrupar os resultados pelo campo genres na coleção movies, seu índice deve se assemelhar ao exemplo a seguir:

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

A query de amostra utiliza os seguintes estágios de pipeline:

`$search`	Pesquisa por títulos que contenham `summer` no campo `title` usando o coletor de facetas. Recupera uma contagem do número total de filmes nos resultados em cada gênero usando a opção `facets`.
`$addFields`	Adiciona o campo `paginationToken` para armazenar os tokens de cada documento nos resultados gerados usando a opção searchSequenceToken.
`$limit`	Limita os resultados a `10` documentos.
`$facet`	Retorna os seguintes campos: `docs` campo, que contém somente os campos `title`, `released` e `genres` dos documentos nos resultados e no campo `paginationToken`. `meta` campo, que contém uma contagem do número total de filmes nos resultados em cada gênero armazenado na variável `$$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') }
            ]
          }
        }
      }
    }
]

Voltar

contar

rastreamento

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", _id:1
10	}
11	}
12	...
13	},
14	{
15	"$project": {
16	{ "paginationToken" : { "$meta" : "searchSequenceToken" } }
17	},
18	...
19	}]

Uso

Considerações

Recuperar ponto de referência

Sintaxe

Saída

Atlas Search após um ponto de referência específico

searchAfter Sintaxe

Saída

Atlas Search antes de um ponto de referência específico

searchBefore Sintaxe

searchBefore Saída

Exemplos

Observação

Obter a página 1 e gerar tokens de paginação

Recuperar página 2 usando searchAfter

Retornar à página 1 Usando o searchBefore

Observação

Pule da página 2 para a página 5 usando searchAfter e $skip

Usar faceta com os resultados paginados

`searchAfter` Sintaxe

`searchBefore` Sintaxe

`searchBefore` Saída