ドキュメントの検索

FindOne() メソッドを使用して、コレクションから単一のドキュメントを取得できます。

例

Tip

この例を実行する方法については、「使用例」をお読みください。

この例では、 restaurants コレクション内のドキュメントのモデルとして次の Restaurant 構造体を使用します。

type Restaurant struct {
	ID           primitive.ObjectID `bson:"_id"`
	Name         string
	RestaurantId string `bson:"restaurant_id"`
	Cuisine      string
	Address      interface{}
	Borough      string
	Grades       []interface{}
}

次の例では、name が「Bagels N Buns」である restaurants コレクション内のドキュメントに一致しており、一致した最初のドキュメントを返しています。

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)
}

が完全に実行可能な例を表示

期待される結果

完全な例を実行すると、次のドキュメントが出力されます。これは、result 変数に Restaurant 構造体として保存されます。

// results truncated
{
   "ID": "5eb3d668b31de5d588f42950",
   "Name": "Bagels N Buns",
   "RestaurantId": "40363427"
   "Address": [...],
   "Borough": "Staten Island",
   "Cuisine": "Delicatessen",
   "Grades": [...]
}

詳細情報

クエリフィルターの指定と潜在的なエラーの処理の詳細については、「データの取得」を参照してください。

クエリ演算子の詳細については、 MongoDB クエリ演算子のリファレンスドキュメントを参照してください。

API ドキュメント

FindOne()

← 検索操作複数ドキュメントの検索 →