Menu Docs
Página inicial do Docs
/ /
opções de pesquisa
Página inicial do Docs
/ /
Referência de query
/
opções de pesquisa
Página inicial do Docs
/
Desenvolvimento
/
Pesquisa
/
Queries e índices
/
Referência de query
/
opções de pesquisa

Paginar os resultados

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

Uso

Para recuperar resultados paginados, execute as seguintes etapas:

  1. Crie um índice nos campos que você deseja consultar.

  2. Execute uma query $search que retorna um ponto de referência. Para saber mais, consulte Recuperar ponto de referência.

  3. 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 pular apenas 1 página de resultados (10 documentos). Em comparação, se você usar $skip sem a opção $search searchAfter , a query pulará 4 páginas de resultados (40 documentos). Para aprender mais, veja Vá 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 reduzir empates de pontuação de relevância:

  • Classifique sua query por um campo exclusivo para evitar empates de pontuação de relevância. Para obter um exemplo, consulte Classificar por pontuação e um campo exclusivo.

  • 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.

Atualizar ou excluir documentos entre queries pode causar inconsistências na ordem dos resultados. Aplique os seguintes princípios para dar suporte ao comportamento de pesquisa determinístico:

  • Classifique os resultados da consulta por um campo imutável , como _id. A Pesquisa do MongoDB reflete as atualizações que você faz à sua coleção entre as queries iniciais 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 MongoDB Search poderá ordenar os mesmos documentos de forma diferente.

  • Se você distribuiu nós de pesquisa dedicados e está classificando os resultados searchScore por, considere o seguinte:

    • Por padrão, o MongoDB Search classifica documentos usando o bm25 algoritmo de similaridade, que calcula a frequência de termo em relação a todo o corpus de documentos no bm25 nó do MongoDB secondary nearestSearch. Como cada nó do MongoDB Search replica o changestream de forma independente, esse corpus pode variar entre os nós do MongoDB Search. Como resultado, a mesma query pode retornar diferentes pontuações de quando roteada para diferentes nós do MongoDB Search. As queries subsequentes têm maior probabilidade de serem roteadas para diferentes nós do MongoDB Search se sua implantação usar nós dedicados do MongoDB Search ou se sua preferência de leitura estiver definida como ou.

    • Para garantir pontuações consistentes nas queries subsequentes, defina a similarity.type propriedade como stableTfl ou ao boolean indexar um campo como a string do MongoDB Search ou o tipo de preenchimento automático. Isso força os operadores de texto, frase, queryString e preenchimento automático a usar o stableTfl boolean algoritmo de similaridade ou para calcular as pontuações de relevância para queries no campo indexado. Esses algoritmos calculam pontuações consistentemente em todos os nós de Pesquisa MongoDB . Para saber mais, consulte Detalhes da pontuação.

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"
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 de pesquisa do MongoDB.

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

Saída

A Pesquisa do MongoDB retorna os documentos nos resultados após o token especificado. O MongoDB 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.

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 de pesquisa do MongoDB.

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:

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

searchBefore Saída

A Pesquisa do MongoDB retorna documentos nos resultados que precedem o token especificado em ordem inversa. O MongoDB 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 (como mostrado na linha 11). Esses tokens podem ser usados como 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 MongoDB Search chamado default com mapeamentos dinâmicos. Se você carregar a collection e criar o índice, poderá executar as seguintes queries na collection.

As queries demonstram como recuperar um ponto de referência, que é usado 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:

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

  2. Recupere a página 2 usando searchAfter

  3. Retorne à página 1 usando searchBefore

  4. Vá da página 2 para a página 5 usando searchAfter e $skip

  5. Usar faceta com os resultados paginados

Observação

Por padrão, o MongoDB 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 MongoDB Search retornará resultados ordenados arbitrariamente. Para retornar documentos em uma ordem determinada, as queries especificam um campo único, released, para classificar os resultados.

Voltar

contar

Próximo

returnScope

Nesta página