クエリ結果の取得

クエリを作成した後、さまざまな取得オプションを指定して、クエリから返される結果をさらに制御できます。アプリに対するクエリの構成について詳しくは、データストア クエリをご覧ください。

クエリ結果を反復処理する

Query 値の Run メソッドを使用してクエリの結果を反復処理する場合、Datastore は結果をバッチで取得します。デフォルトでは、各バッチに 20 件の結果が含まれています。 すべての結果が返されるかリクエストがタイムアウトするまで、クエリ結果の反復処理を繰り返すことができます。

クエリと一致する各エンティティを反復処理するには、Run メソッドを使用して Iterator を取得します。これにより、Iterator の Next メソッドを使用して各エンティティを処理できます。

q := datastore.NewQuery("Person")
t := q.Run(ctx)
for {
	var p Person
	k, err := t.Next(&p)
	if err == datastore.Done {
		break // No further entities match the query.
	}
	if err != nil {
		log.Errorf(ctx, "fetching next Person: %v", err)
		break
	}
	// Do something with Person p and Key k
	doSomething(k, p)
}

クエリと一致するすべてのエンティティを一度に取得するには、GetAll メソッドを使用します。

q := datastore.NewQuery("Person")
var people []Person
keys, err := q.GetAll(ctx, &people)
if err != nil {
	log.Errorf(ctx, "fetching people: %v", err)
	return
}
for i, p := range people {
	k := keys[i]
	// Do something with Person p and Key k
	doSomething(k, p)
}

エンティティから選択したプロパティを取得する

エンティティ全体ではなくエンティティのプロパティの中から選択したもののみを取得するには、射影クエリを使用します。このタイプのクエリは、エンティティ全体を返すよりも迅速かつ低コストで実行できます。

同様に、キーのみのクエリではエンティティ全体ではなく一致するエンティティのキーのみが返されるので、時間とリソースを節約できます。この種のクエリを作成するには、 Query を作成するときに KeysOnly メソッドを呼び出します。。

q := datastore.NewQuery("Person").KeysOnly()

クエリに上限を設定する

クエリに対して上限を設定することで、1 つのバッチで返される結果の最大数を制御できます。次の例では、最も背の高い 5 名を Datastore から取得します。

q := datastore.NewQuery("Person").Order("-Height").Limit(5)
var people []Person
_, err := q.GetAll(ctx, &people)
// check err

for _, p := range people {
	log.Infof(ctx, "%s %s, %d inches tall", p.FirstName, p.LastName, p.Height)
}

次のステップ