Encontrar um documento
Você pode recuperar um único documento de uma coleção usando o método FindOne()
.
Exemplo
Dica
Leia os Exemplos de uso para saber como executar este exemplo.
Este exemplo utiliza a seguinte estrutura Restaurant
como um modelo para documentos na collection restaurants
:
type Restaurant struct { ID primitive.ObjectID `bson:"_id"` Name string RestaurantId string `bson:"restaurant_id"` Cuisine string Address interface{} Borough string Grades []interface{} }
O exemplo a seguir corresponde a documentos na collection restaurants
em que o name
é "Bagels N Buns", retornando o primeiro documento correspondente:
coll := client.Database("sample_restaurants").Collection("restaurants") filter := bson.D{{"name", "Bagels N Buns"}} var result Restaurant err = coll.FindOne(context.TODO(), filter).Decode(&result) if err != nil { if err == mongo.ErrNoDocuments { // This error means your query did not match any documents. return } panic(err) }
Visualizar um exemplo completamente executável
Resultado esperado
A execução do exemplo completo imprime o seguinte documento, que é armazenado na variável result
como uma estrutura Restaurant
:
// results truncated { "ID": "5eb3d668b31de5d588f42950", "Name": "Bagels N Buns", "RestaurantId": "40363427" "Address": [...], "Borough": "Staten Island", "Cuisine": "Delicatessen", "Grades": [...] }
Informações adicionais
Para saber mais sobre como especificar filtros de query e lidar com possíveis erros, consulte Retrieve Data (Recuperar dados).
Para saber mais sobre operadores de query, consulte a documentação de referência do operador de query do MongoDB.