Acessar dados de um cursor

Visão geral

Neste guia, você pode aprender como acessar dados com um cursor.

Um cursor é um mecanismo que permite que um aplicação itere sobre os resultados do banco de dados de dados enquanto mantém apenas um subconjunto deles na memória em determinado momento. Operações de leitura que correspondem a vários documentos usam um cursor para retornar esses documentos em lotes em vez de todos de uma vez.

cursor, err := coll.Find(context.TODO(), bson.D{})
if err != nil {
	panic(err)
}

Recuperar documentos individualmente

Para recuperar documentos do cursor individualmente enquanto bloqueia a goroutine atual, use o método Next().

O método retorna um documento se cada um dos seguintes for verdadeiro:

• Um documento está atualmente ou estará disponível posteriormente

• Não ocorreram erros

• O contexto não expirou

for cursor.Next(context.TODO()) {
	var result bson.D
	if err := cursor.Decode(&result); err != nil {
		log.Fatal(err)
	}
	fmt.Println(result)
}
if err := cursor.Err(); err != nil {
	log.Fatal(err)
}

for {
	if cursor.TryNext(context.TODO()) {
		var result bson.D
		if err := cursor.Decode(&result); err != nil {
			log.Fatal(err)
		}
		fmt.Println(result)
		continue
	}
	if err := cursor.Err(); err != nil {
		log.Fatal(err)
	}
	if cursor.ID() == 0 {
		break
	}
}

Recuperar todos os documentos

Para preencher uma array com todos os seus resultados de query, utilize o método All():

var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
	panic(err)
}
for _, result := range results {
	fmt.Println(result)
}

Fechar o cursor

Quando seu aplicação não precisar mais usar um cursor, feche o cursor com o método Close() . Esse método libera os recursos que o cursor consome no aplicação cliente e no servidor MongoDB .

defer cursor.Close(context.TODO())

Informações adicionais

Para saber mais sobre as operações abordadas neste guia, consulte os seguintes guias:

• Retrieve Data

• Especificar uma query

• Trabalhe com BSON

• Cursores persistentes