Cloud Firestore mit der Firebase Console verwalten

Sie können die folgenden Aktionen für Cloud Firestore ausführen, wenn Sie die Firebase Console verwenden:

• Daten aufrufen, hinzufügen, bearbeiten und löschen
• Cloud Firestore Security Rules erstellen und aktualisieren.
• Indexe verwalten
• Nutzung überwachen

Daten aufrufen

Sie können alle Ihre Cloud Firestore-Daten in der Firebase Console aufrufen. Klicken Sie auf dem Tab Datenbanken und Speicher > Firestore > Daten auf ein Dokument oder eine Sammlung, um die darin verschachtelten Daten zu öffnen.

Bestimmten Pfad öffnen

Verwenden Sie zum Öffnen eines Dokuments oder einer Sammlung in einem bestimmten Pfad die Schaltfläche Pfad bearbeiten :

Dokumente in einer Sammlung filtern

Wenn Sie die in einer Sammlung aufgeführten Dokumente filtern möchten, verwenden Sie die Schaltfläche Liste filtern .

Nicht vorhandene übergeordnete Dokumente

Ein Dokument kann auch dann vorhanden sein, wenn eines oder mehrere seiner übergeordneten Elemente nicht vorhanden sind. Beispielsweise kann das Dokument im Pfad /mycoll/mydoc/mysubcoll/mysubdoc auch dann vorhanden sein, wenn das übergeordnete Dokument /mycoll/mydoc nicht vorhanden ist.

Der Cloud Firestore-Daten-Viewer zeigt nicht vorhandene übergeordnete Dokumente so an:

• In der Dokumentliste einer Sammlung werden die Dokument-IDs nicht vorhandener übergeordneter Dokumente kursiv dargestellt.
• Im Informationsbereich eines nicht vorhandenen übergeordneten Dokuments wird in der Datenansicht darauf hingewiesen, dass das Dokument nicht vorhanden ist.

Warnung: Nicht vorhandene übergeordnete Dokumente werden zwar in der Console angezeigt, aber nicht in Abfragen und Snapshots. Um das Dokument in die Abfrageergebnisse aufzunehmen, müssen Sie es erstellen.

Daten abfragen

Sie können auf dem Tab Query Builder der Seite Cloud Firestore-Daten nach Dokumenten suchen.

1. Zur Seite „Cloud Firestore-Daten“

2. Klicken Sie auf den Tab Query Builder.

3. Wählen Sie einen Abfragebereich aus.

   Wählen Sie Sammlung aus, um eine einzelne Sammlung abzufragen. Geben Sie im Textfeld einen Pfad zu einer Sammlung ein.

   Wählen Sie Sammlungsgruppe aus, um alle Sammlungen mit derselben ID abzufragen. Geben Sie im Feld Sammlungsgruppe eine Sammlungsgruppen-ID ein.

   In der Tabelle werden automatisch Dokumente aus der angegebenen Sammlung oder Sammlungsgruppe angezeigt.

4. Klicken Sie auf Zur Abfrage hinzufügen, um die zurückgegebenen Dokumente zu filtern. Standardmäßig fügt der Query Builder eine WHERE-Klausel hinzu. Sie können diese Klausel mithilfe der Drop-down-Menüs und Textfelder ändern oder zu einer der anderen verfügbaren Klauseln wechseln. Klicken Sie auf Zur Abfrage hinzufügen, um komplexere Abfragen zu erstellen.

   Wenn Sie eine Abfrageklausel entfernen möchten, klicken Sie auf die entsprechende Schaltfläche zum Entfernen . Wenn Sie alle Abfrageklauseln entfernen möchten, klicken Sie auf Löschen.

   Hinweis: Abfragen müssen die Anforderungen und Einschränkungen von Cloud Firestore für Abfragen erfüllen. Andernfalls schlägt die Abfrage fehl und auf der Seite wird ein Fehler zurückgegeben, der beschreibt, warum die Abfrage fehlgeschlagen ist.

5. Klicken Sie auf Ausführen, um Ergebnisse aus Ihrer Datenbank abzurufen.

Anforderungen und Einschränkungen für Abfragen

Beachten Sie bei der Verwendung des Query Builders die folgenden Anforderungen und Einschränkungen für Abfragen.

• Alle Abfragen müssen von mindestens einem Index unterstützt werden. Wenn die Datenbank keinen Index zur Unterstützung der Abfrage findet, wird ein Fehler mit einem Link zum Erstellen des erforderlichen Index zurückgegeben.

• ORDER BY-Klauseln müssen mit den Feldern in den WHERE-Klauseln übereinstimmen und in derselben Reihenfolge angegeben werden. Standardmäßig werden die Ergebnisse nach Dokument-ID sortiert. Wenn Sie nach einem anderen Feld mit einem anderen Wert als einem Gleichheitszeichen (==) filtern, fügen Sie eine ORDER BY-Klausel für dieses Feld hinzu.

• Abfrageklauseln für Bereiche (<, <=, >, >=) und Ungleichheitsvergleiche (!=, not-in) müssen alle nach demselben Feld filtern.

Weitere Einschränkungen finden Sie unter Abfrageeinschränkungen.

Daten verwalten

In Cloud Firestore speichern Sie Daten in Dokumenten und organisieren Ihre Dokumente in Sammlungen. Bevor Sie Daten hinzufügen, sollten Sie sich mit dem Cloud Firestore-Datenmodell vertraut machen.

Sie können Dokumente und Sammlungen in der Firebase Console hinzufügen, bearbeiten und löschen. Wenn Sie Ihre Daten verwalten möchten, rufen Sie den Tab Datenbanken und Speicher > Firestore > Daten auf.

Hinweis: Lese-, Schreib- und Löschvorgänge, die in der Console ausgeführt werden, werden auf Ihre Cloud Firestore-Nutzung angerechnet. Einige Console-Aktivitäten, z. B. das Aufrufen eines Dokuments mit mehreren Feldern, können mehrere Vorgänge generieren.

Daten hinzufügen

1. Klicken Sie auf Sammlung hinzufügen, geben Sie den Namen der Sammlung ein und klicken Sie auf Weiter.
2. Geben Sie eine bestimmte Dokument-ID ein oder klicken Sie auf Automatisch generierte ID und fügen Sie dann Felder für die Daten in Ihrem Dokument hinzu.
3. Klicken Sie auf Speichern. Ihre neue Sammlung und das neue Dokument werden in der Datenansicht angezeigt.
4. Wenn Sie der Sammlung weitere Dokumente hinzufügen möchten, klicken Sie auf Dokument hinzufügen.

Daten bearbeiten

1. Klicken Sie auf eine Sammlung, um deren Dokumente anzeigen zu lassen. Wählen Sie dann ein Dokument aus, um dessen Felder und Untersammlungen zu sehen.
2. Klicken Sie auf ein Feld, um seinen Wert zu bearbeiten. Wenn Sie dem ausgewählten Dokument Felder oder Untersammlungen hinzufügen möchten, klicken Sie auf Feld hinzufügen oder Sammlung hinzufügen.

Daten löschen

So löschen Sie eine Sammlung:

1. Wählen Sie die Sammlung aus, die Sie löschen möchten.
2. Klicken Sie oben in der Dokumentspalte auf das Dreipunkt-Menü und dann auf Delete collection (Sammlung löschen).

So löschen Sie ein Dokument oder alle zugehörigen Felder:

1. Wählen Sie das Dokument aus, das Sie löschen möchten.
2. Klicken Sie oben in der Spalte mit den Dokumentdetails auf das Dreipunkt-Menü. Wählen Sie Delete document (Dokument löschen) oder Delete document fields (Dokumentfelder löschen) aus.

Wenn Sie ein Dokument löschen, werden alle darin enthaltenen Daten einschließlich aller Untersammlungen gelöscht. Wenn Sie jedoch die Felder eines Dokuments löschen, werden seine Untersammlungen nicht gelöscht.

So löschen Sie ein bestimmtes Feld in einem Dokument:

1. Wählen Sie das Dokument aus, dessen Felder angezeigt werden sollen.
2. Klicken Sie auf das Löschsymbol neben dem Feld, das Sie löschen möchten.

Cloud Firestore Security Rules verwalten

Wenn Sie Cloud Firestore Security Rules in der Firebase Console hinzufügen, bearbeiten und löschen möchten, rufen Sie den Tab Datenbanken und Speicher > Firestore > Regeln auf. Weitere Informationen zum Einrichten und Anpassen von Regeln

Indexe verwalten

Wenn Sie neue Indexe für Ihre Abfragen erstellen und vorhandene Indexe über die Firebase Console verwalten möchten, rufen Sie den Tab Datenbanken und Speicher > Firestore > Indexe auf. Weitere Informationen zum Verwalten von Indexen

Nutzung überwachen

Wenn Sie die Cloud Firestore-Nutzung in der Firebase Console im Blick behalten möchten, rufen Sie den Tab Datenbanken und Speicher > Firestore > Nutzung auf. Mit diesem Dashboard können Sie Ihre Nutzung über verschiedene Zeiträume hinweg messen.