index.yaml を使用したデータストア インデックスの構成

Cloud Datastore を使用すると、スタンダード環境で実行されるアプリケーションのデータを保存できます。Cloud Datastore はアプリケーションからのすべてのクエリにインデックスを使用します。インデックスはエンティティが変更されるたびに更新されるので、アプリからのクエリに対してすばやく結果を返すことができます。これを実現するには、アプリからどのようなクエリが実行されるかを、Cloud Datastore 側であらかじめ把握しておく必要があります。アプリに必要なインデックスは、index.yaml 構成ファイルで指定します。このファイルは、Cloud Datastore エミュレータを使用してアプリをテストする際に自動生成できます。また自分で記述することもできます。index.yaml ファイルは、アプリをデプロイする際にアップロードする必要があります。

index.yaml について

アプリケーションが実行するすべての Cloud Datastore クエリには、対応するインデックスが必要です。単純なクエリ用のインデックス(1 つのプロパティに関するクエリなど)は自動的に作成されます。複雑なクエリ用のインデックスは、index.yaml という構成ファイルで定義する必要があります。このファイルはアプリケーションとともにアップロードされ、Cloud Datastore にインデックスを作成します。

index.yaml ファイルの例を次に示します。

indexes:

- kind: Cat
  ancestor: no
  properties:
  - name: name
  - name: age
    direction: desc

- kind: Cat
  properties:
  - name: name
    direction: asc
  - name: whiskers
    direction: desc

- kind: Store
  ancestor: yes
  properties:
  - name: business
    direction: asc
  - name: owner
    direction: asc

index.yaml の構文は YAML 形式です。この構文について詳しくは、YAML のウェブサイトをご覧ください。

インデックスの定義

index.yaml には indexes というリスト要素を 1 つ指定します。このリストに含まれる各要素は、アプリケーションのインデックスを表します。

インデックス要素には、次のような要素があります。

kind
クエリに対応するエンティティの種類です。この要素は必須です。
properties

インデックスの列として並べ替える順で指定したプロパティのリストです。まず、等式フィルタで使用するプロパティ、次に不等式フィルタで使用するプロパティ、そして並べ替え順序とその方向を指定します。

このリスト内の各要素には、次の要素を指定します。

name
プロパティのデータストア名です。
direction
並べ替えの方向です。昇順の場合は asc、降順の場合は desc を指定します。この値は、クエリの並べ替え順序で使用するプロパティについてのみ必要です。また、クエリで使用する方向と同じである必要があります。デフォルトは asc です。
ancestor

クエリに祖先句(Query.setAncestor)がある場合は yes です。デフォルトは no です。

インデックス ファイルを作成する

インデックス ファイルは、テキスト エディタを使用して上述のファイル レイアウトに従うと手動で作成できます。また、アプリをローカルでテストする際に自動で生成すれば、インデックス ファイルの作成はより効率的になります。この 2 つの方法は組み合わせることができます。

ローカル環境でテストする際に gcloud エミュレータ コマンドを使用することにより、アプリを実行する前に Cloud Datastore をエミュレートするサービスを開始できます。

gcloud beta emulators datastore start --data-dir DATA-DIR

--data-dir フラグを使用して、index.yaml ファイルが自動生成されるディレクトリを指定します。

アプリのテスト中、エミュレータは、Cloud Datastore クエリが生成されるたびに、生成されたインデックス定義を index.yaml に追加します。自動生成されたすべてのインデックスがファイル内の次の行の下に表示されます。

# AUTOGENERATED

この行の上のインデックス定義は、すべて手動で管理されているものとみなされ、開発用ウェブサーバーによって更新されることはありません。アプリケーションが実行するクエリに対応するインデックスが、index.yaml ファイルのどこにも記載されていない場合に限り、ウェブサーバーはこの行の下にのみを変更を加えます。自動インデックス定義を手動で管理するには、定義をこの行の上に移動します。

アプリケーションがクエリを実行すると、エミュレータがこの行の下の既存の定義を更新する場合があります。アプリが行うすべてのクエリをテストで生成すると、index.yaml 内に完全なエントリが作成されます。本番環境で使用されないインデックスを削除したり、テストでは作成されなかったインデックスを定義したりするために、ファイルの手動編集が必要になることがあります。

インデックス ファイルをデプロイする

アプリケーションをデプロイする前に、gcloud コマンドを使用して index.yaml ファイルをデプロイする必要があります。

gcloud app deploy index.yaml
このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Java 8 の App Engine スタンダード環境