コンソールで Firestore を管理する

コンソールで Firestore を管理する

Firestore を管理するには、Google Cloud Console で次の操作を行います。

• データの表示、クエリ、追加、編集、削除
• インデックスの管理

注: セキュリティ ルールを管理するには、Firebase コンソールを使用します。

データを表示する

Google Cloud Console ですべての Firestore データを表示できます。Firestore のデータビューアで、ドキュメントまたはコレクションをクリックして、そのアイテム内にネストされているデータを開きます。

1. Google Cloud コンソールで [Database] ページに移動します。

   [データベース] に移動

2. データベースのリストから、必要なデータベースを選択します。

3. ナビゲーション メニューで [Firestore Studio] をクリックします。

特定のパスを開く

特定のパスにあるドキュメントまたはコレクションを開くには、パスの編集ボタン を使用します。

祖先ドキュメントが存在しない場合

祖先が存在しない場合であっても、ドキュメントは存在できます。たとえば、パス /mycoll/mydoc/mysubcoll/mysubdoc にあるドキュメントは、祖先ドキュメント /mycoll/mydoc が存在しなくても存在できます。Firestore データビューアでは、存在しない祖先ドキュメントは次のように表示されます。

• コレクション内のドキュメントのリストでは、存在しない祖先ドキュメントのドキュメント ID は斜体になっています。
• 存在しない祖先ドキュメントの情報パネルで、そのドキュメントが存在しないことが通知されます。

警告: 存在しない祖先ドキュメントは、Console に表示されている場合でも、クエリとスナップショットには表示されません。クエリ結果に含めるには、ドキュメントを作成する必要があります。

データをフィルタリングする

コレクション内のドキュメントは、フィールド値と ==、!-、>、>=、<、<=、in、not-in、array-contains、array-contains-any の条件に基づいてフィルタリングできます。たとえば、フィールド firstname の値が Sam のドキュメントだけを表示できます。コレクション フィルタを適用するには:

1. コレクション ID の横にあるフィルタボタン をクリックします。

   

2. [フィルタの追加] メニューから、ドキュメント フィールド、フィルタ条件、並べ替え順序を選択します。

   

3. [適用] をクリックします。

コレクション フィルタを削除するには、同じメニューを開いて [フィルタをクリア] をクリックします。

データのクエリ

Firestore Studio ページの [クエリビルダー] タブでドキュメントをクエリできます。

1. Google Cloud コンソールで [データベース] ページに移動します。

   [データベース] に移動

2. データベースのリストから、必要なデータベースを選択します。

3. ナビゲーション メニューで [Firestore Studio] をクリックします。

4. [クエリビルダー] タブをクリックします。

5. クエリの範囲を選択します。

   [コレクション] を選択して、1 つのコレクションをクエリします。テキスト フィールドに、コレクションのパスを入力します。

   [コレクション グループ] を選択して、同じ ID を持つすべてのコレクションをクエリします。[コレクション グループ] フィールドに、コレクション グループ ID を入力します。

   指定したコレクションまたはコレクション グループのドキュメントが表に自動的に表示されます。

6. [クエリに追加] をクリックして、返された一連のドキュメントをフィルタリングします。デフォルトでは、クエリビルダーは WHERE 句を追加します。この句は、プルダウンとテキスト フィールドを使用して変更できます。また、使用可能な他の句に変更することもできます。より複雑なクエリを続けて作成するには、[クエリに追加] をクリックします。

   クエリ句を削除するには、削除する句の削除ボタン をクリックします。すべてのクエリ句を削除するには、[クリア] をクリックします。

   注: クエリに関する Firestore の要件と制限事項をクエリが満たしている必要があります。満たしていない場合、クエリが失敗して、失敗した理由を説明するエラーがページに返されます。

7. [実行] をクリックしてデータベースから結果を取得します。

   

ヒント: 実行するクエリはブラウザ履歴に保存されます。セッション中、ブラウザ内で戻る、進むの操作を行うことで最近のクエリにアクセスできます。アクセス頻度が高いクエリや、他のユーザーと共有するクエリをブックマークできます。

クエリの要件と制限事項

クエリビルダーを使用する場合は、クエリに関する次の要件と制限事項に注意してください。

• すべてのクエリは、1 つ以上のインデックスでサポートされる必要があります。クエリをサポートするインデックスがデータベースで見つからない場合、必要なインデックスを作成するためのリンクを含むエラーが返されます。

  

• ORDER BY 句は WHERE 句のフィールドと一致し、同じ順序で指定する必要があります。デフォルトでは、結果はドキュメント ID で並べ替えられます。等式（==）以外のフィールドでフィルタリングする場合は、そのフィールドに ORDER BY 句を追加します。

  

• 範囲（<、<=、>、>=）と不等値（!=、not-in）のクエリ句は、すべて同一のフィールドに対するフィルタである必要があります。

その他の制限事項については、クエリの制限事項をご覧ください。

データ管理

Firestore では、データをドキュメントに格納し、ドキュメントをコレクションとして整理します。データの追加を開始する前に、Firestore のデータモデルに関する記事をお読みください。

ドキュメントとコレクションの追加、編集、削除は Firebase コンソールで行います。GCP コンソールからデータを管理するには、Firestore Studio ページに移動します。

1. Google Cloud コンソールで [データベース] ページに移動します。

   [データベース] に移動

2. データベースのリストから、必要なデータベースを選択します。

3. ナビゲーション メニューで [Firestore Studio] をクリックします。

注: コンソールで行われた読み取り、書き込み、削除の操作は、Firestore の使用量にカウントされます。

データを追加

1. [コレクションの開始] をクリックします。
2. コレクション ID を入力します。ドキュメント ID を入力します。Firestore によってドキュメント ID が生成されますが、特定のドキュメントの ID を上書きできます。ドキュメント内にデータのフィールドを追加します。
3. [保存] をクリックします。新しいコレクションとドキュメントがデータビューアに表示されます。
4. コレクションにドキュメントをさらに追加するには、[ドキュメントを追加] をクリックします。

データの編集

1. コレクションをクリックしてドキュメントを表示したら、ドキュメントをクリックしてそのフィールドとサブコレクションを表示します。
2. フィールドをクリックしてフィールド値を編集します。選択したドキュメントにフィールドまたはサブコレクションを追加するには、[フィールドを追加] または [コレクションを開始] をクリックします。

データを削除する

コレクションを削除するには:

1. 削除するコレクションを選択します。
2. ドキュメント列の上部にあるメニュー アイコンをクリックし、[コレクションを削除] をクリックします。

ドキュメントを削除するには:

1. 削除するドキュメントを選択します。
2. ドキュメントの詳細列の上部にあるメニュー アイコンをクリックします。[ドキュメントを削除] または [ドキュメント フィールドを削除] を選択します。

ドキュメントを削除すると、サブコレクションを含むそのドキュメント内のネストされたデータがすべて削除されます。

ドキュメントのフィールドを削除する場合、サブコレクションは削除されません。ドキュメントは空になっても存在し、クエリ結果に表示されます。

ドキュメント内の特定のフィールドを削除するには:

1. ドキュメントを選択してフィールドを表示します。
2. 削除するフィールドの横にある削除アイコンをクリックします。

Firestore セキュリティ ルールの管理

Firestore のセキュリティ ルールは、Google Cloud Console から確認できます。ルールセットを編集または削除するには、Firebase を有効にして、Firebase CLI または Firebase コンソールを使用します。

Firebase の有効化

Firestore セキュリティ ルールを編集するには、Google Cloud プロジェクトに対して Firebase を有効にする必要があります。Firebase が有効になっていない場合は、[セキュリティ ルール] ページから Firebase を有効にできます。

Firestore セキュリティ ルールの機能は、Firebase Auth および Firebase SDK（ウェブ、Android、Apple プラットフォーム）と緊密に統合されています。Firebase と Firestore の詳細については、Firebase スタートガイドをご覧ください。

セキュリティ ルールを表示する

Google Cloud コンソールで Firestore セキュリティ ルールを表示するには、[セキュリティ ルール] ページに移動します。

1. Google Cloud コンソールで [Database] ページに移動します。

   [データベース] に移動

2. データベースのリストから、必要なデータベースを選択します。

3. ナビゲーション メニューで [セキュリティ ルール] をクリックします。

セキュリティ ルールを編集する

Firestore セキュリティ ルールを編集または削除するには、Firebase CLI または Firebase コンソールを使用します。Firebase コンソールで、[Firestore] セクションの [ルール] タブに移動します。詳しくは、ルールの設定とカスタマイズの方法をご覧ください。

インデックスの管理

Firebase コンソールでクエリ用に新しいインデックスの作成や、既存のインデックスを管理するには、[Firestore] セクションで [Indexes] タブをクリックします。詳しくは、インデックスの管理方法をご覧ください。