Quick Reference

This page shows the driver syntax for several MongoDB operations in the Go driver and provides links to related reference and API documentation.

Operation	Syntax
Find a Document API Documentation Find Documents Guide	`err = coll.FindOne(context.TODO(), bson.D{{"firstName", Mike}}).Decode(&result)`
Find Multiple Documents API Documentation Find Documents Guide	`cursor, err := coll.Find(context.TODO(), bson.D{{"age", bson.D{{"$gte", 46}}}})`
Insert a Document API Documentation Insert Documents Guide	`result, err := coll.InsertOne( context.TODO(), bson.D{ {"firstName", "Aliya"}, {"lastName", "Sanders"} })`
Insert Multiple Documents API Documentation Insert Documents Guide	`docs := []any { bson.D{{"firstName", "Erik"}, {"age", 27}}, bson.D{{"firstName", "Mohammad"}, {"lastName", "Ahmad"}, {"age", 10}}, bson.D{{"firstName", "Todd"}}, bson.D{{"firstName", "Juan"}, {"lastName", "Pablo"}} } result, err := coll.InsertMany(context.TODO(), docs)`
Update a Document API Documentation Update Documents Guide	`result, err := coll.UpdateOne( context.TODO(), bson.D{{"firstName", "Erik"}}, bson.D{{"$set", bson.D{{"age", 28}}}})fmt.Printf("Number of modified documents: %d\n", result.ModifiedCount)`
Update Multiple Documents API Documentation Update Documents Guide	`result, err := coll.UpdateMany( context.TODO(), bson.D{{"age", bson.D{{"$gte", 65}}}}, bson.D{{"$set", bson.D{{"classification", "senior"}}}})fmt.Printf("Number of modified documents: %d\n", result.ModifiedCount)`
Update Arrays in Documents API Documentation Update Arrays Guide	`result, err := coll.UpdateMany( context.TODO(), bson.D{}, bson.D{{"$push", bson.D{{"hobbies", "painting"}}}})`
Replace a Document API Documentation Replace Documents Guide	`result, err := coll.ReplaceOne( context.TODO(), bson.D{{"firstName", "Mick"}, {"lastName", "Salazar"}}, bson.D{{"firstName", "Michael"}, {"lastName", "Salazar Jr."}})`
Delete a Document API Documentation Delete Documents Guide	`result, err := coll.DeleteOne( context.TODO(), bson.D{{"firstName", "Xiao"}})`
Delete Multiple Documents API Documentation Delete Documents Guide	`results, err := coll.DeleteMany( context.TODO(), bson.D{{"age", bson.D{{"$lte", 12}}}})`
Bulk Write API Documentation Bulk Operations Guide	`models := []mongo.WriteModel{ mongo.NewInsertOneModel().SetDocument(bson.D{{"firstName", "John"}, {"age", 5}}), mongo.NewUpdateOneModel().SetFilter(bson.D{{"firstName", "Juan"}}). SetUpdate(bson.D{{"$set", bson.D{{"age", 12}}}}),}opts := options.BulkWrite().SetOrdered(true) results, err := coll.BulkWrite(context.TODO(), models, opts)`
Monitor Data Changes API Documentation Change Streams Guide	`pipeline := mongo.Pipeline{bson.D{{"$match", bson.D{{"operationType", "insert"}}}}}cs, err := coll.Watch(context.TODO(), pipeline)`
Access Data from a Cursor Iteratively API Documentation Retrieve Documents Individually Reference	`cursor, err := coll.Find(context.TODO(), bson.D{}) for cursor.Next(context.TODO()) { var result bson.D if err := cursor.Decode(&result); err != nil { log.Fatal(err) } fmt.Println(result)}`
Access Data from a Cursor as an Array API Documentation Retrieve All Documents Reference	`cursor, err := coll.Find(context.TODO(), bson.D{}) var results []bson.Dif err = cursor.All(context.TODO(), &results); err != nil { panic(err)}`
Count Documents API Documentation Count Documents Guide	`count, err := coll.CountDocuments(context.TODO(), bson.D{})`
List Distinct Field Values API Documentation Distinct Values Guide	`var results []stringerr = coll.Distinct(context.TODO(), "firstName", bson.D{}).Decode(&results)`
Limit the Number of Documents Retrieved API Documentation Limit Documents Reference	`cursor, err := coll.Find(context.TODO(), bson.D{}, options.Find().SetLimit(2))`
Skip Retrieved Documents API Documentation Skip Documents Reference	`// the collection has 6 documentscursor, err := coll.Find(context.TODO(), bson.D{}, options.Find().SetSkip(4))`
Sort Retrieved Documents API Documentation Sort Documents Reference	`cursor, err := coll.Find(context.TODO(), bson.D{}, options.Find().SetSort(bson.D{{"age", 1}}))`
Project Document Fields in Results API Documentation Projection Guide	`cursor, err := coll.Find( context.TODO(), bson.D{}, options.Find().SetProjection( bson.D{{"age", 0}, {"_id",0}} ))`
Create an Index API Documentation Indexes Guide	`model := mongo.IndexModel{Keys: bson.D{{"firstName", 1}, {"lastName", -1}}}name, err := coll.Indexes().CreateOne(context.TODO(), model)`
Search Text API Documentation Search Text Guide	`// Only searches on fields covered by text indexescursor, err := coll.Find(context.TODO(), bson.D{{"$text", bson.D{{"$search", "arts"}}}})`

Back

Upgrade Guides

Issues & Help