Menu Docs

Página inicial do DocsDesenvolver aplicaçõesManual 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 o seguinte formato 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 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:

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

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

Dica

Veja também:

← $shardedDataDistribution (agregação)