Cloud Firestore でのインデックス管理

Cloud Firestore では、すべてのクエリにインデックスを使用することで、クエリのパフォーマンスを維持しています。最も基本的なクエリに必要なインデックスは、自動的に作成されます。Cloud Firestore を使用すると、アプリを使用してテストする際に、アプリで必要な追加のインデックスを簡単に作成できます。このページでは、単一フィールドインデックスと複合インデックスの管理方法について説明します。

不足しているインデックスをエラーメッセージから作成する

一方、既存のインデックスに対応しない range 句で複合クエリを実行すると、エラーが発生します。このエラーメッセージに含まれている Firebase コンソールのリンクを使用すると、不足しているインデックスを作成できます。

Firebase コンソールへのリンクをクリックして、自動的に入力された情報を確認し、[作成] をクリックします。

ロールと権限

Cloud Firestore でインデックスを作成する前に、自身に次のいずれかのロールが割り当てられていることを確認してください。

roles/datastore.owner
roles/datastore.indexAdmin
roles/editor
roles/owner

カスタムロールを定義している場合、インデックスを作成するには次のすべての権限を割り当ててください。

datastore.indexes.create
datastore.indexes.delete
datastore.indexes.get
datastore.indexes.list
datastore.indexes.update

Firebase コンソールを使用する

Firebase コンソールから手動で新しいインデックスを作成するには:

Firebase コンソールでインデックスを作成するインターフェースの画像

Firebase コンソールの [Cloud Firestore] セクションに移動します。
[インデックス] タブに移動し、[インデックスを追加] をクリックします。
コレクション名を入力し、インデックスを並べ替えるフィールドを設定します。
[作成] をクリックします。

クエリのサイズによっては、インデックスの作成に数分かかることがあります。完了すると、[複合インデックス] セクションにインデックスとその状態が表示されます。作成中の場合、Firebase コンソールにステータスバーが表示されます。

インデックスを削除する

インデックスを削除するには:

Firebase コンソールの [Cloud Firestore] セクションに移動します。
[インデックス] タブをクリックします。
削除するインデックスにカーソルを合わせ、コンテキストメニューから [削除] を選択します。
アラートの [削除] をクリックして、削除を確定します。

Firebase CLI を使用する

Firebase CLI を使用してインデックスをデプロイすることもできます。まず、プロジェクトディレクトリで firebase init firestore を実行します。設定中に、デフォルトのインデックスが正しい形式で含まれている JSON ファイルが Firebase CLI により生成されます。ファイルを編集してインデックスを追加し、firebase deploy コマンドを使用してデプロイします。インデックスのみをデプロイする場合は、--only firestore:indexes フラグを追加します。Firebase コンソールでインデックスを編集する場合は、必ずローカルインデックスファイルも更新してください。JSON インデックス定義リファレンスをご覧ください。

インデックスの構築時間

インデックスの構築には、Cloud Firestore によるインデックスの設定と、既存データへのインデックスのバックフィルが必要です。インデックスの構築時間は、設定時間とバックフィル時間の合計です。

インデックスの設定には数分かかります。インデックスの最小構築時間は、空のデータベースであっても数分です。
バックフィル時間は、新しいインデックスに既存のデータがどの程度存在するかによって異なります。インデックス定義に一致するフィールド値が多いほど、インデックスのバックフィルにかかる時間が長くなります。

インデックスの構築は長時間実行オペレーションになります。

インデックスの構築を開始すると、Cloud Firestore によりオペレーションに一意の名前が割り当てられます。次のように、オペレーション名の先頭には projects/[PROJECT_ID]/databases/(default)/operations/ という文字列が付きます。

projects/project-id/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

ただし、describe コマンドのオペレーション名を指定するときは、接頭辞を省略できます。

すべての長時間実行オペレーションの一覧表示

長時間実行オペレーションを一覧表示するには、gcloud firestore operations list コマンドを使用します。このコマンドは、実行中のオペレーションと最近完了したオペレーションを一覧表示します。オペレーションは、完了後数日間一覧表示されます。

gcloud firestore operations list

オペレーションのステータスを確認する

すべての長時間実行オペレーションを一覧表示する代わりに、1 つのオペレーションの詳細を一覧表示できます。

gcloud firestore operations describe operation-name

完了時間の見積もり

オペレーションを実行すると、state フィールドの値で、オペレーション全体のステータスが確認できます。

長時間実行オペレーションのステータスをリクエストすると、workEstimated と workCompleted の指標も合わせて返されます。これらの指標はドキュメント数で返されます。workEstimated には、オペレーションで処理される推定の合計ドキュメント数が表示されます。workCompleted には、これまでに処理されたドキュメント数が表示されます。オペレーションが完了すると、workCompleted には実際に処理されたドキュメントの合計数が反映されます。これは workEstimated の値とは異なる場合があります。

進行した割合を大まかに得るには、workCompleted を workEstimated で割ります。この割合は、最新の統計情報コレクションとの間に遅延があるために正確ではない可能性があります。

例として、インデックス構築の進行状況を次に示します。

{
  "operations": [
    {
      "name": "projects/project-id/operations/AyAyMDBiM2U5NTgwZDAtZGIyYi0zYjc0LTIzYWEtZjg1ZGdWFmZWQHEjF0c2Flc3UtcmV4ZWRuaS1uaW1kYRUKSBI",
      "metadata": {
        "@type": "type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata",
        "common": {
          "operationType": "CREATE_INDEX",
          "startTime": "2020-06-23T16:52:25.697539Z",
          "state": "PROCESSING"
        },
        "progressDocuments": {
          "workCompleted": "219327",
          "workEstimated": "2198182"
        }
       },
    },
    ...

オペレーションが完了すると、オペレーションの説明に、"done": true が含まれます。オペレーションの結果をみるには、state フィールドの値を確認します。done フィールドがレスポンスに設定されていない場合、値は false になります。進行中のオペレーションに関しては、done の値の有無は参考になりません。

インデックス構築エラー

複合インデックスと単一フィールドインデックスの例外を管理するときに、インデックス構築エラーが発生することがあります。Cloud Firestore がインデックスを作成しているデータに問題を検出すると、インデックスの作成に失敗する可能性があります。多くの場合、インデックスの上限に達すると、この問題が発生します。たとえば、オペレーションでドキュメントあたりの最大インデックスエントリ数に達した可能性があります。

インデックスの作成に失敗すると、コンソールにエラーメッセージが表示されます。インデックスの上限に達していないことを確認した後、インデックスオペレーションを再試行します。