3. Query検索

キー検索のほかに、App Engineでは、Queryを使用した条件検索が可能です。ただし、App Engineの条件検索はRDBに比べて制約が多く、この点が分散キー・バリュー・ストアの欠点として評価される場合が多いようです。例えば、JOIN検索ができない、集計関数が使用できない、などが挙げられます。

このように、条件検索についてはマイナスのイメージでとらえられることが多いApp Engineですが、実際どの程度の検索・参照が可能なのでしょうか。以下では具体例を挙げて説明します。

[App Engineで検索パターン]

Query(String kind)
Query(String kind, Key , ancestorKey)
Query(Key ancestorKey)
Query()

App EngineにおけるQuery検索は、上記の4種類のパターンで行われます。実際には、1.または2.のパターンが多いはずです。以下からは、この順番で、それぞれの検索例を解説します。

3.1. Query(String kind)

Queryの引数にkind名を指定するパターンは、条件検索で最も多く使われる一般的なパターンです。つまり、テーブル（kind）と検索条件を指定して参照するパターンです。

（1）全件検索（revAllOrdTran1）

【リスト3】: 「Query（String kind）」パターンでの全件検索

最初に全件検索ですが、この検索では、

（1）で、検索対象のテーブル（kind）を指定してQueryインスタンスを生成し、
（2）で、検索結果をエンティティ・リストで返しますが、込み入った書式なので、その内容を確認します。

ds.prepare(query)
DatastoreServiceのインスタンスであるdsに適用するメソッドprepare(query)は、実行するクエリーを準備します。
asListは、引数内で生成される配列をListに変換して返します。
FetchOptions.Builderはstaticクラスであり、Fetch（検索）用のstaticメソッドを指定して実行します。
withOffset(0)は、データ・ストア（kind）検索において、先頭エンティティから値を返します。

画面5: revAllOrdTran1での検索結果（クリックで拡大）

画面5は、revAllOrdTran1の検索結果です。例えば、withOffset(1)を指定した場合は、2番目のエンティティ項目から値が返されます。つまり、withOffsetの「引数値-1」番目のエンティティから検索データが返されます。

DWRのメソッド実行画面で確認した場合、withOffset(0)では画面6のように、withOffset(1)では画面7のように、先頭部分が表示されます。

画面6: withOffset(0)でのDWR実行表示（クリックで拡大）

画面7: withOffset(1)でのDWR実行表示

その後、for文で取得したList形式のotranから、表示データを作成します。getPropertyにおけるプロパティ値取得は、これまでと同じです。

（2）イコール条件（revOrdTran1）

【リスト4】: イコール条件追加でのエンティティ検索

App Engineの条件検索指定で「フィルタオペレータ」を使います。リスト4の（1）と（3）は、リスト3と同じですが、（2）でフィルタ指定（query.addFilter）を行っています。ここでは、プロパティkind^*1に対して「equality filter」が適用され、kind名が「desktop」のエンティティだけが選択されます。