Menu Docs
Página inicial do Docs
/ / /
Go
/ /

Encontrar um documento

Você pode recuperar um único documento de uma coleção usando o método FindOne().

Dica

Leia osExemplos de uso de para saber como executar esse 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)
}

Veja um exemplo totalmente executável

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": [...]
}

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.

FindOne()

Voltar

Encontrar operações

Próximo

Localizar vários documentos