Datastore モードの Cloud Firestore をコンソールから管理する

ここでは、アプリケーションがデータベースに保存したデータのエンティティ、インデックス、統計情報を表示して管理する方法について説明します。Cloud Datastore の管理者アクセス権や書き込みを有効または無効にする方法についても説明します。これらの管理作業は、Google Cloud Platform Console の Cloud Datastore ページで行うことができます。

Cloud Datastore の統計情報を表示する

Cloud Datastore ダッシュボードに移動すると、アプリケーションのエンティティに関するデータだけでなく、組み込みインデックスや複合インデックスの統計情報が表示されます。

Cloud Datastore の [ダッシュボード] ページに移動

ダッシュボードは以下のように表示されます。

このページの統計情報について詳しくは、コンソールで統計情報を表示するをご覧ください。

インデックスを表示する

[インデックス] ページに移動すると、アプリケーションのインデックスの表が表示されます。

[インデックス] ページに移動

各インデックスについて、アプリケーションのサービスを提供する準備ができているかどうかなどのステータスを確認できます。使用されているストレージ容量やエントリ数などをインデックスごとに確認することもできます。

エンティティを表示する

アプリケーションがデータベースに保存したエンティティを表示するには、[エンティティ] ページに移動します。

[エンティティ] ページに移動

以下のように表示されます。

このページでエンティティの作成、更新、削除、クエリを行うこともできます。その方法については、クイックスタートをご覧ください。

注: 特定の名前空間のエンティティをすべて削除した後も、その名前空間が数日から 1 週間ほどコンソールに表示されることがあります。

Cloud Datastore の管理者アクセス権を有効または無効にする

一括コピー、一括削除、バックアップ、復元を行うには、Cloud Datastore の管理者アクセス権が必要です。

Cloud Datastore の管理者アクセス権を有効または無効にするには:

1. [管理] ページに移動します。
   [管理] ページに移動

2. アクセス権を有効にするには [データストア管理を有効にする] をクリックします。無効にするには [データストア管理を無効にする] をクリックします。ボタンのテキストは、プロジェクトの状態によって異なります。

注: 以前は App Engine の app.yaml ファイルを使用して Cloud Datastore の管理機能を有効にできましたが、この設定は非推奨となり、今後の SDK リリースから削除される予定です。

Cloud Datastore の管理機能を使用する際の注意事項

• コピー、削除、バックアップを実行した際に、最近の更新が反映されない場合があります。
• Cloud Datastore の管理オペレーションはすべてアプリケーション内で実行されるため、割り当ての計算対象になります。
• バックアップや復元時には書き込みを無効にすることを強くおすすめします。
• コピーや復元時には、同じキーを持つ既存のエンティティが上書きされます。コピーや復元を複数回実行しても、重複は作成されません。コピーや復元によって、対象外のデータが削除されることはありません。
• バックアップと復元にデフォルト以外のキューを使用する場合には、queue.yaml で対象として ah-builtin-python-bundle のみを指定できます。その他の対象は使用できません。

注: バックアップ、復元、コピー、削除の各オペレーションはアプリケーション内で実行されるため、割り当ての計算対象になります。

エンティティの削除

警告: Cloud Datastore の管理機能を使用した一括削除は非推奨となりました。代わりに、Cloud Dataflow を使用してエンティティを一括削除することをおすすめします。

すべての名前空間の、ある種類のエンティティやすべての種類のエンティティをすべて削除するには、[管理] ページに移動します。

1. プロジェクトの Cloud Datastore アクセス権を有効にしていない場合は有効にします。
2. [管理] ページに移動します。
   [管理] ページに移動
3. [データストア管理を開く] をクリックします。
4. エンティティの種類を 1 つ以上選択します。
5. [Delete Entities] をクリックします。

データベースへの書き込みを有効または無効にする

通常は、復元を行う前に書き込みを無効にすることをおすすめします。これにより、復元内容とデータベースに書き込まれる新しいデータ間の競合を回避できます。書き込みを無効にしていても、[管理] ページを使用してデータを復元したり、一括削除を行ったりできます。

書き込みを無効にすると、以下の場所からエンティティが変更されなくなります。

• Cloud Datastore ビューア
• Cloud Datastore API を使用するアプリケーション

注: Cloud Datastore API では、書き込みが無効にされている場合、強制書き込みはできません。ただし、App Engine クライアント ライブラリからは書き込みが無効でも強制書き込みが可能です。そのため、書き込みが無効にされていても、App Engine クライアント ライブラリで記述されたアプリケーションによってデータベース インスタンスを変更できます。

書き込みを有効または無効にするには:

1. [管理] ページに移動します。

   [管理] ページに移動

2. 書き込みを有効にするには [書き込みを有効にする] をクリックします。書き込みを無効にするには [書き込みを無効にする] をクリックします。ボタンのテキストは、プロジェクトの状態によって異なります。

データをバックアップまたは復元する

警告: Cloud Datastore の管理バックアップ機能は非推奨となっており、2019 年 2 月 28 日に停止されます。この機能は、マネージド エクスポートおよびインポート機能に置き換えられています。なるべく早い時期に、マネージド エクスポートおよびインポート機能に移行してください。

データをバックアップまたは復元するには [管理] ページに移動します。

[管理] ページに移動

バックアップと復元の方法については、バックアップと復元をご覧ください。

リソースの使用状況を確認する

Cloud Datastore の管理ジョブを実行すると、実際には基盤となる MapReduce ジョブを実行することになります。MapReduce ジョブによって、ストレージのオペレーションとストレージの使用率に加えて、フロントエンド インスタンス時間が増加します。

リソースの使用状況を確認するには:

1. GCP Console の [App Engine] ページにアクセスします。

   [App Engine] ページに移動

2. ページ上部のプルダウン メニューで default サービスを選択して、ah-builtin-python-bundle バージョンを選択します。

次のステップ

• Console で統計情報の詳細を確認します。
• バックアップと復元について学習します。