クエリ結果の取得

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

単一のエンティティを取得する

クエリと一致する単一のエンティティを取得するには、PreparedQuery.asSingleEntity() メソッドを使用します。

Query q =
    new Query("Person")
        .setFilter(new FilterPredicate("lastName", FilterOperator.EQUAL, targetLastName));

PreparedQuery pq = datastore.prepare(q);
Entity result = pq.asSingleEntity();

このメソッドは、インデックスで最初に見つかった、クエリと一致する結果を返します（一致する結果が複数ある場合は、TooManyResultsException がスローされます）。

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

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

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

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

同様に、キーのみのクエリではエンティティ全体ではなく一致するエンティティのキーのみが返されるので、時間とリソースを節約できます。このタイプのクエリを作成するには、Query.setKeysOnly() メソッドを使用します。

Query q = new Query("Person").setKeysOnly();

クエリに上限を設定する

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

private List<Entity> getTallestPeople() {
  DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();

  Query q = new Query("Person").addSort("height", SortDirection.DESCENDING);

  PreparedQuery pq = datastore.prepare(q);
  return pq.asList(FetchOptions.Builder.withLimit(5));
}

次のステップ