Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

$skip (agregação)

Nesta página

  • Definição
  • Comportamento
  • Exemplo
$skip

Ignora o número especificado de documentos que passam para o estágio e passa os documentos restantes para o próximo estágio no pipeline.

O estágio $skip tem a seguinte forma de protótipo:

{ $skip: <positive 64-bit integer> }

$skip tira um número inteiro positivo que especifica o número máximo de documentos para ignorar.

Observação

A partir do MongoDB 5.0, a agregação do pipeline $skip tem um limite de número inteiro de 64bits. Os valores passados para o pipeline que excedem esse limite retornarão um erro de argumento inválido.

Se estiver usando o estágio $skip com qualquer um dos seguintes:

  • a fase de agregação$sort,

  • o método sort(), ou

  • o campo sort ao comando findAndModify ou ao método findAndModify() shell,

Certifique-se de incluir pelo menos um campo em sua classificação que contenha valores exclusivos, antes de passar os resultados para o estágio $skip.

A classificação em campos que contêm valores duplicados pode retornar uma ordem de classificação diferente para esses campos duplicados em várias execuções, especialmente quando a coleção está recebendo gravações ativamente.

A maneira mais fácil de garantir consistência de classificação é incluir o campo _id em sua query de classificação.

Consulte o seguinte para obter mais informações sobre cada um deles:

Considere o seguinte exemplo:

db.article.aggregate([
{ $skip : 5 }
]);

Essa operação ignora os primeiros 5 documentos passados pelo pipeline. $skip não tem efeito no conteúdo dos documentos que ele transmite pelo pipeline.

Dica

Veja também:

Voltar

$shardedDataDistribtion