/ /

$skip (etapa de agregación)

Definición

$skip

Salta sobre el número especificado de documentos que pasan a la etapa y pasa los documentos restantes a la siguiente etapa en la pipeline.

La $skip El escenario tiene la siguiente forma de prototipo:

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

$skip toma un entero positivo que especifica el número máximo de documentos a omitir.

Nota

A partir de MongoDB.5 0, el pipeline de agregación tiene $skip un límite de enteros de 64 bits. Los valores que se pasan al pipeline y que exceden este límite devolverán un error de argumento no válido.

Comportamiento

Usar $skip con resultados ordenados

Si utilizas la etapa $skip con cualquiera de:

la etapa de agregación $sort ,
el método sort(), o
el campo sort al comando findAndModify o al método de shell findAndModify(),

asegurarse de incluir al menos un campo en la ordenación que contenga valores únicos, antes de pasar los resultados a la etapa $skip.

La ordenación en campos que contienen valores duplicados puede devolver un orden de clasificación diferente para esos campos duplicados en múltiples ejecuciones, especialmente cuando la colección recibe escrituras activamente.

La forma más sencilla de garantizar la coherencia de ordenamiento es incluir el campo _id en la query de ordenación.

Consulte lo siguiente para obtener más información sobre cada uno:

Ejemplos

Considera el siguiente ejemplo:

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

Esta operación omite los primeros 5 documentos que la pipeline le pasa. $skip no tiene efecto en el contenido de los documentos que pasan a lo largo del pipeline.

Para utilizar el driver de MongoDB .NET/C# para agregar una etapa $skip a una pipeline de agregación, llama a la Skip()método en un PipelineDefinition objeto.

El siguiente ejemplo crea una etapa de pipeline que omite los primeros cinco documentos en la entrada y pasa los documentos restantes a la siguiente etapa en el pipeline:

 var pipeline = new EmptyPipelineDefinition<Movie>()
     .Skip(5);

Para utilizar el controlador de MongoDB Node.js para agregar una etapa de $skip a una canalización de agregación, utilice el Operador $skip en un objeto de canalización.

El siguiente ejemplo crea una etapa de pipeline que omite los primeros cinco documentos en la colección de entrada y pasa los documentos restantes a la siguiente etapa del pipeline. A continuación, el ejemplo ejecuta la pipeline de agregación:

const pipeline = [{ $skip: 5 }];
const cursor = collection.aggregate(pipeline);
return cursor;

Obtén más información

Para ver ejemplos completos de agregación que utilizan la etapa $skip, consulte los Tutoriales completos de la canalización de agregación.

Volver

$shardedDataDistribution

$sort