Firestore Studio für die Standard Edition verwenden

Firestore Studio für die Standard Edition verwenden

Sie können die Firestore Standard Edition mithilfe der folgenden Aktionen in der Google Cloud Console verwalten:

• Daten aufrufen, abfragen, hinzufügen, bearbeiten und löschen
• Indexe verwalten
• Sicherheitsregeln verwalten

Daten aufrufen

Sie können alle Daten der Firestore Standard Edition in der Google Cloud Console aufrufen. Klicken Sie dazu in der Datenansicht der Firestore Standard Edition auf ein Dokument oder eine Sammlung. Damit werden die darin enthaltenen Daten geöffnet.

1. Rufen Sie in der Google Cloud Console die Datenbanken Seite auf.

   Zur Seite „Datenbanken“

2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

3. Klicken Sie im Navigationsmenü auf Firestore Studio.

Bestimmten Pfad öffnen

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

Bereichseinstellungen konfigurieren

Sie können Einstellungen für die Datenansicht in Firestore Studio konfigurieren. Diese Einstellungen wirken sich nur auf die Konsolenansicht aus, Datenbankmetadaten werden nicht geändert.

So konfigurieren Sie Bereichseinstellungen:

1. Klicken Sie in der Symbolleiste der Datenansicht auf Bereichseinstellungen .

2. Konfigurieren Sie im Bereich Bereichseinstellungen für das Projekt die folgenden Optionen:

   • Nicht vorhandene übergeordnete Elemente anzeigen: Legen Sie fest, ob nicht vorhandene übergeordnete Dokumente in der Dokumentliste angezeigt werden sollen. Diese Einstellung ist standardmäßig aktiviert.
   • Echtzeitaktualisierungen aktiviert: Legen Sie fest, ob Sie Live-Aktualisierungen erhalten möchten, wenn sich Dokumente ändern. Diese Einstellung ist standardmäßig aktiviert. Wenn Sie Echtzeitaktualisierungen deaktivieren, können Sie Kosten senken, indem Sie Lesevorgänge reduzieren.

3. Klicken Sie auf Speichern.

Hinweis: Bereichseinstellungen gelten für alle Datenbanken in Ihrem Projekt. Das Filtern von Daten in der Datenansicht wird nur unterstützt, wenn Echtzeitaktualisierungen aktiviert sind.

Nicht vorhandene übergeordnete Dokumente

Ein Dokument kann auch dann vorhanden sein, wenn ein oder mehrere übergeordnete Elemente nicht vorhanden sind. Beispielsweise kann das Dokument unter dem Pfad /mycoll/mydoc/mysubcoll/mysubdoc vorhanden sein, auch wenn das übergeordnete Dokument /mycoll/mydoc nicht vorhanden ist.

Standardmäßig werden nicht vorhandene übergeordnete Dokumente in der Datenansicht der Firestore Standard Edition so angezeigt:

• In der Liste von Dokumenten einer Sammlung sind die Dokument-IDs nicht vorhandener übergeordneter Dokumente kursiv dargestellt.
• In der Datenansicht wird in einem Informationsfenster für ein nicht vorhandenes übergeordnetes Dokument darauf hingewiesen, dass das Dokument nicht vorhanden ist.

Wenn Sie nicht vorhandene übergeordnete Dokumente in der Liste der Sammlungsdokumente ausblenden möchten, deaktivieren Sie Nicht vorhandene übergeordnete Elemente anzeigen in den Bereichseinstellungen.

Warnung: Auch wenn nicht vorhandene übergeordnete Dokumente in der Console angezeigt werden, sind sie in Abfragen und Snapshots nicht enthalten. Um das Dokument in die Abfrageergebnisse aufzunehmen, müssen Sie es erstellen.

Daten filtern

Sie können Dokumente in einer Sammlung anhand des Feldwerts und mit den ==, !-, >, >=, <, <=, in, not-in, array-contains, array-contains-any Bedingungen filtern. Beispielsweise lässt sich die Anzeige auf Dokumente beschränken, bei denen der Wert des Felds firstname gleich Sam ist.

Hinweis: Das Filtern von Daten in der Datenansicht wird nur unterstützt, wenn in den Bereichseinstellungen die Option Echtzeitaktualisierungen aktiviert ausgewählt ist.

So wenden Sie einen Sammlungsfilter an:

1. Klicken Sie neben einer Sammlungs-ID auf die Filterschaltfläche :

   

2. Wählen Sie im Menü Filter hinzufügen ein Dokumentfeld, eine Filterbedingung und eine Sortierreihenfolge aus.

   

3. Klicken Sie auf Übernehmen.

Zum Entfernen eines Sammlungsfilters öffnen Sie das Menü noch einmal und klicken Sie auf Filter löschen.

Daten abfragen

Sie können auf dem Tab Query Builder der Seite „Firestore Studio“ nach Dokumenten suchen.

1. Rufen Sie in der Google Cloud Console die Datenbanken Seite auf.

   Zur Seite „Datenbanken“

2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

3. Klicken Sie im Navigationsmenü auf Firestore Studio.

4. Klicken Sie auf den Tab Query Builder.

5. 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.

6. 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 über die Drop-down-Menüs und Textfelder ändern oder zu einer der anderen verfügbaren Klauseln wechseln. Wenn Sie komplexere Abfragen erstellen möchten, klicken Sie auf Zur Abfrage hinzufügen.

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

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

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

   

Tipp: Ausgeführte Abfragen werden im Browserverlauf gespeichert. Während der Sitzung können Sie im Browser vor- und zurückgehen, um auf aktuelle Abfragen zuzugreifen. Sie können Abfragen mit einem Lesezeichen versehen, auf die Sie häufig zugreifen möchten, oder sie für andere freigeben.

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 in der Datenbank kein Index gefunden wird, der die Abfrage unterstützt, 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 stehen. Standardmäßig werden die Ergebnisse nach Dokument-ID sortiert. Wenn Sie nach einem anderen Feld mit einer anderen Bedingung als Gleichheit (==) filtern, fügen Sie eine ORDER BY-Klausel für dieses Feld hinzu.

  

• Bereichs- (<, <=, >, >=) und Ungleich-Abfrageklauseln (!=, not-in) müssen alle im selben Feld filtern.

Weitere Einschränkungen finden Sie unter Einschränkungen für Abfragen.

Daten verwalten

In der Firestore Standard Edition speichern Sie Daten in Dokumenten und organisieren Ihre Dokumente in Sammlungen. Informieren Sie sich über das Datenmodell der Firestore Standard Edition, bevor Sie mit dem Hinzufügen von Daten beginnen.

Sie können Dokumente und Sammlungen in der Firebase Console hinzufügen und bearbeiten sowie daraus löschen. Zum Verwalten Ihrer Daten mit der GCP Console rufen Sie die Seite Firestore Studio auf:

1. Rufen Sie in der Google Cloud Console die Datenbanken Seite auf.

   Zur Seite „Datenbanken“

2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

3. Klicken Sie im Navigationsmenü auf Firestore Studio.

Hinweis: Lese-, Schreib- und Löschvorgänge in der Console werden auf Ihre Nutzung der Firestore Standard Edition angerechnet.

Daten hinzufügen

1. Klicken Sie auf Start Collection (Sammlung starten).
2. Geben Sie eine Sammlungs-ID ein. Geben Sie eine Dokument-ID ein. Die Firestore Standard Edition generiert eine Dokument-ID . Diese ID kann aber mit einer anderen Dokument-ID überschrieben werden. Fügen Sie Felder für die Daten in Ihrem Dokument hinzu.
3. Klicken Sie auf Save (Speichern). Ihre neue Sammlung und das neue Dokument werden in der Datenansicht angezeigt.
4. Klicken Sie auf Add Document (Dokument hinzufügen), um weitere Dokumente zur Sammlung hinzuzufü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. Klicken Sie auf Add Field (Feld hinzufügen) oder Start Collection (Sammlung starten), um dem ausgewählten Dokument Felder oder Untersammlungen hinzuzufügen.

Daten löschen

Sie können Dokumente oder Sammlungen in der Datenansicht löschen.

Hinweis: In einigen Fällen kann das Löschen einer großen Anzahl von Dokumenten dazu führen, dass die Datenansicht langsam geladen wird oder ein Zeitüberschreitungsfehler zurückgegeben wird. Dies gilt für Löschvorgänge, die über die Datenansicht und an anderer Stelle ausgeführt werden.

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:

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 dagegen die Felder eines Dokuments löschen, werden seine Untersammlungen nicht entfernt. Auch wenn das Dokument dann leer ist, ist es weiterhin vorhanden und kann in Abfrageergebnissen enthalten sein.

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.

Firestore-Sicherheitsregeln verwalten

Sie können Firestore-Sicherheitsregeln direkt in der Google Cloud Console verwalten und bereitstellen. Der Regel-Editor ist für Firestore im nativen Modus sowohl in der Standard Edition als auch in der Enterprise Edition verfügbar.

Verwenden Sie die Google Cloud Console.

Hinweis: Die Google Cloud Console unterstützt die Bereitstellung von Firestore-Sicherheitsregeln für die Datenbank (default) nicht. Wenn Sie Regeln für die (default) Datenbank verwalten möchten, verwenden Sie die Firebase Console oder die Firebase CLI.

Erforderliche Berechtigungen

Zum Verwalten und Bereitstellen von Sicherheitsregeln in der Google Cloud Console benötigen Sie die folgenden IAM-Berechtigungen:

• firebaserules.releases.create
• firebaserules.releases.delete
• firebaserules.releases.update
• firebaserules.rulesets.create
• firebaserules.rulesets.delete
• firebaserules.rulesets.list
• firebaserules.rulesets.test (erforderlich für die Verwendung des Regelsimulators)

So stellen Sie Regeln in der Google Cloud Console bereit:

1. Rufen Sie in der Google Cloud Console die Datenbanken Seite auf.

   Zur Seite „Datenbanken“

2. Klicken Sie auf die ID der Datenbank, die Sie verwalten möchten.

3. Klicken Sie im Navigationsmenü auf Sicherheit.

4. Klicken Sie auf den Tab Firestore-Regeln.

5. Sehen Sie sich Ihre Regeln im Regel-Editor an. Wenn Sie sie bearbeiten möchten, klicken Sie auf Neuer Regelsatz oder Regelsatz klonen und ändern Sie dann Ihre Regeln.

6. Klicken Sie auf Veröffentlichen , um Ihre Änderungen bereitzustellen.

Sie können sich auch frühere Regelsätze in der Zeitachse ansehen und sie klonen oder wiederherstellen.

Regeln mit dem Regelsimulator testen

Sie können Entwürfe von Sicherheitsregeln anhand simulierter Anfragen testen, bevor Sie sie bereitstellen.

So testen Sie Regeln in der Google Cloud Console:

1. Rufen Sie in der Google Cloud Console die Datenbanken Seite auf.

   Zur Seite „Datenbanken“

2. Klicken Sie auf die ID der Datenbank, die Sie testen möchten.

3. Klicken Sie im Navigationsmenü auf Sicherheit.

4. Klicken Sie auf den Tab Firestore-Regeln und dann auf den Tab Simulator.

5. Wählen Sie den Simulationstyp aus (get, create, update oder delete).

6. Geben Sie den Speicherort des Zieldokuments ein.

7. Optional: Konfigurieren Sie Mock-Dokumentdaten oder Authentifizierungsparameter.

8. Klicken Sie auf Ausführen , um die Auswertungsergebnisse und Zeilenmarkierungen im Regel-Editor anzusehen.

Firebase aktivieren

Wenn Sie die Firestore-Sicherheitsregeln Ihrer Datenbank (default) mit der Firebase Console oder Firebase CLI bearbeiten möchten, müssen Sie Firebase für Ihr Google Cloud Projekt aktivieren. Ist Firebase nicht aktiviert, können Sie Firebase über die Sicherheit Seite in der Google Cloud Console aktivieren:

Das Feature der Firestore-Sicherheitsregeln ist stark in Firebase Auth und die Firebase SDKs (Web, Android, Apple-Plattformen) integriert. Weitere Informationen zu Firebase und Firestore finden sich unter Erste Schritte mit Firebase.

Indexe verwalten

Um neue Indexe für Ihre Abfragen zu erstellen und vorhandene Indexe über die Firebase Console zu verwalten, wechseln Sie zum Tab Datenbanken und Speicher > Firestore > Indexe. Weitere Informationen zum Verwalten von Indexen.