Ignorar resultados devolvidos

Nesta página

Visão geral

Ignorar
Agregação
Informações adicionais

Visão geral

Neste guia, você pode aprender como ignorar um número específico de resultados retornados de operações de leitura.

Dados de amostra

Para executar o exemplo neste guia, carregue estes documentos na collection tea.ratings com o seguinte trecho:

coll := client.Database("tea").Collection("ratings")
docs := []interface{}{
	bson.D{{"type", "Masala"}, {"rating", 10}},
	bson.D{{"type", "Assam"}, {"rating", 5}},
	bson.D{{"type", "Oolong"}, {"rating", 7}},
	bson.D{{"type", "Earl Grey"}, {"rating", 8}},
	bson.D{{"type", "English Breakfast"}, {"rating", 5}},
}
result, err := coll.InsertMany(context.TODO(), docs)
if err != nil {
	panic(err)
}
fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))

Dica

Bancos de Dados e Coleções Inexistentes

Se o banco de dados e a collection necessários não existirem quando você executar uma operação de escrita, o servidor implicitamente os criará.

Cada documento contém uma classificação para um tipo de chá que corresponde aos campos type e rating .

Observação

Cada exemplo trunca o valor ObjectID porque o driver o gera exclusivamente.

Ignorar

Para ignorar um número especificado de resultados retornados de uma query, passe o número de documentos que você deseja ignorar para o método SetSkip() das opções da operação de leitura.

Especifique as opções como o último parâmetro para os seguintes métodos de operação de leitura:

Find()
FindOne()
CountDocuments()
gridfs.Bucket.Find()

Se o número de documentos exceder o número de documentos correspondentes para uma query, essa query não retornará nenhum documento.

Dica

Passar um número negativo para o método SetSkip() resulta em um erro de tempo de execução.

Os documentos retornam em uma ordem natural, o que pode levar à pular documentos aleatórios. Para evitar isso, use um método SetSort() antes do método SetSkip() .

Exemplo

O exemplo a seguir executa as seguintes ações em ordem com o método Find() :

Uma classificação crescente no campo rating
Pula os dois primeiros documentos

filter := bson.D{}
opts := options.Find().SetSort(bson.D{{"rating", 1}}).SetSkip(2)
cursor, err := coll.Find(context.TODO(), filter, opts)
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   fmt.Println(result)
}

Agregação

Você também pode incluir o estágio $skip para especificar um salto em um pipeline de agregação .

Exemplo

O exemplo a seguir executa as seguintes ações em ordem com o método Aggregate() :

Uma classificação decrescente no campo rating
Pula os três primeiros documentos

sortStage := bson.D{{"$sort", bson.D{{"rating", -1}}}}
skipStage := bson.D{{"$skip", 3}}
cursor, err := coll.Aggregate(context.TODO(), mongo.Pipeline{sortStage, skipStage})
if err != nil {
   panic(err)
}
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   fmt.Println(result)
}

Informações adicionais

Para saber mais sobre as operações mencionadas, consulte os seguintes guias:

Documentação da API

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

← Classificar resultados Limite o número de resultados retornados →