クエリ結果の取得
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
クエリを作成した後、さまざまな取得オプションを指定して、クエリから返される結果をさらに制御できます。アプリに対するクエリの構成について詳しくは、データストア クエリをご覧ください。
クエリ結果を反復処理する
Query
値の Run
メソッドを使用してクエリ結果を反復処理する場合、Cloud Datastore は結果をバッチで取得します。デフォルトでは、各バッチに 20 件の結果が含まれています。すべての結果が返されるかリクエストがタイムアウトするまでクエリ結果の反復処理を繰り返すことができます。
クエリと一致する各エンティティを反復処理するには
Run
メソッドを使用して
Iterator
を取得し、その
Iterator
の
Next
メソッドを使用して各エンティティを処理できます。
クエリと一致するすべてのエンティティを一度に取得するには、GetAll
メソッドを使用します。
エンティティから選択したプロパティを取得する
エンティティ全体ではなくエンティティのプロパティの中から選択したもののみを取得するには、射影クエリを使用します。このタイプのクエリは、エンティティ全体を返すよりも迅速かつ低コストで実行できます。
同様に、キーのみのクエリではエンティティ全体ではなく一致するエンティティのキーのみが返されるので、時間とリソースを節約できます。この種類のクエリを作成するには、Query
を作成するときに KeysOnly
メソッドを呼び出します。
クエリに上限を設定する
クエリに対して上限を設定することで、1 つのバッチで返される結果の最大数を制御できます。次の例では、最も背の高い 5 名を Cloud Datastore から取得します。
次のステップ
- Cloud Datastore のクエリにおける一般的な制限について学習します。
- クエリの結果を一括して取得できるクエリカーソルについて学習します。
- データの整合性とそれが Cloud Datastore における異なるタイプのクエリでどのように動作するか理解します。
- Cloud Datastore のクエリの基本的な構文と構造について学習します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-03-13 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-03-13 UTC。"],[[["This API is designed for first-generation runtimes, with a migration guide available for upgrading to App Engine Go 1.12+ second-generation runtimes."],["Query results can be iterated through using the `Run` method, which retrieves results in batches, or retrieved all at once with the `GetAll` method."],["Projection queries allow for the retrieval of selected properties from an entity, which is faster and more cost-effective than retrieving full entities."],["Keys-only queries, created by calling the `KeysOnly` method, save resources by only returning the keys of matching entities."],["You can limit the number of results returned by a query in a single batch by specifying a limit using the `Limit` method."]]],[]]