Daten in Firestore im Datastore-Modus speichern und abfragen

Daten in Firestore im Datastore-Modus speichern und abfragen

Auf dieser Seite wird beschrieben, wie Sie Daten in Firestore im Datastore-Modus über die Google Cloud Console speichern und abfragen.

Hinweise

• Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

• Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

  Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

  Zur Projektauswahl

• Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

  Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

  Zur Projektauswahl

• Wenn Sie nicht der Projektinhaber sind, benötigt Ihr Konto für diese Kurzanleitung die folgenden Berechtigungen:

  • Ihr Konto benötigt die Rolle Datastore-Inhaber. Sie enthält die Berechtigung datastore.databases.create, die zum Erstellen einer Instanz im Datastore-Modus benötigt wird.
  • Der Datastore-Modus erfordert eine aktive App Engine-Anwendung. Wenn im Projekt keine Anwendung vorhanden ist, wird im Rahmen dieses Schnellstarts eine für Sie erstellt. In diesem Fall benötigen Sie die Berechtigung appengine.applications.create. Der Projektinhaber kann diese Berechtigung mit einer benutzerdefinierten IAM-Rolle zuweisen.

Datenbank erstellen

1. Öffnen Sie zum Erstellen einer neuen Datenbankinstanz den Abschnitt Datastore in der Google Cloud Console:
   Zur Seite „Datastore“

2. Wählen Sie einen Datenbankmodus aus.

   Wenn Sie eine neue Firestore-Datenbank erstellen, können Sie Firestore entweder im nativen Modus oder im Datastore-Modus verwenden. Sie können nicht beide Modi im selben Projekt verwenden.

   Wählen Sie eine der folgenden Datenbankoptionen aus:

   • Firestore im nativen Modus

     Empfohlen für mobile Apps und Web-Apps. Arbeiten Sie zum Einsteig in die Arbeit mit Firestore die Firestore-Kurzanleitung durch.

   • Firestore im Datastore-Modus

     Empfohlen für Anwendungsarchitekturen mit Back-End-Servern.

   Weitere Informationen zur Auswahl eines Datenbankmodus und einen Funktionsvergleich finden Sie unter Zwischen nativem Modus und Datastore-Modus wechseln.

3. Wählen Sie einen Datenbankspeicherort aus. Der Datastore-Modus unterstützt multiregionale und regionale Standorte.

   Ein multiregionaler Standort maximiert Verfügbarkeit und Langlebigkeit. Regionale Standorte bieten eine geringere Schreiblatenz. Weitere Informationen zu Standorttypen finden Sie unter Standorte im Datastore-Modus. Der Standort gilt sowohl für Datenbanken im Datastore-Modus als auch für App Engine-Anwendungen für Ihr Google Cloud-Projekt.

   Warnung: Nachdem Sie die Datenbank erstellt haben, können Sie den Standort nicht mehr ändern.

   Klicken Sie auf Create database (Datenbank erstellen). Nachdem die Datenbank initialisiert wurde, werden Sie von der Google Cloud Console zur Seite „Datastore-Entitäten“ weitergeleitet.

Daten speichern

1. Rufen Sie in der Google Cloud Console die Seite „Datastore-Entitäten“ auf.

   Zur Seite „Entitäten“

   Auf dieser Seite können Sie Daten speichern, abfragen, aktualisieren und löschen.

2. Klicken Sie auf Entität erstellen.

3. Verwenden Sie auf der Seite Entität erstellen [default] als Namespace.

4. Geben Sie Task in das Feld Art ein. Belassen Sie den Wert für Schlüsselkennung auf dem Standardwert Numeric ID (auto-generated).

5. Verwenden Sie unter Eigenschaften die Schaltfläche Eigenschaft hinzufügen, um diese Eigenschaften hinzuzufügen:

   Name	Typ	Wert	Indexiert
   description	String	Informationen zu Datastore.
   erstellt	Datum und Uhrzeit	(heutiges Datum)	✓
   Fertig	Boolescher Wert	false	✓

   Ihre Erstellungsseite sollte nun so aussehen:

   

6. Klicken Sie auf Erstellen. In der Konsole ist nun die Entität Task zu sehen, die Sie gerade erstellt haben.

Die Daten sind jetzt in Ihrer Datenbank gespeichert.

Abfrage ausführen

Datenbanken im Datastore-Modus unterstützen die Abfrage von Daten nach Art oder Google Query Language (GQL). In der folgenden Anleitung erfahren Sie, wie Sie mit beiden Methoden Ihre Datenbank abfragen.

Abfragen nach Art ausführen

1. Klicken Sie auf Abfrage nach Art.
2. Wählen Sie Task als Art aus.

In den Abfrageergebnissen sehen Sie die von Ihnen erstellte Entität Task.

Als Nächstes fügen Sie eine Abfrageklausel hinzu, um die Ergebnisse auf Entitäten zu beschränken, die bestimmte Kriterien erfüllen:

1. Klicken Sie auf Abfrageklausel hinzufügen.
2. Wählen Sie in den Drop-down-Listen WHERE, done, ==, boolean und false aus.
3. Klicken Sie auf Ausführen. In den Ergebnissen sehen Sie die von Ihnen erstellte Entität Task, da ihr done-Wert false ist.
4. Ändern Sie nun die Abfrageklausel in WHERE, done, ==, boolean und true. Klicken Sie auf Ausführen. In den Ergebnissen ist die von Ihnen erstellte Entität Task nicht enthalten, da ihr done-Wert nicht true ist.

GQL-Abfragen ausführen

1. Klicken Sie auf Abfrage über GQL.
2. Geben Sie SELECT * FROM Task als Abfrage ein. Beachten Sie, dass bei Task zwischen Groß- und Kleinschreibung unterschieden wird.
3. Klicken Sie auf Abfrage ausführen.

In den Abfrageergebnissen sehen Sie die von Ihnen erstellte Entität Task.

Tipp

Der GQL-Abfrage-Editor unterstützt Autovervollständigung für Arten: Wenn Sie einen Namen eingeben müssen, drücken Sie Strg + Leertaste, um eine Liste der verfügbaren Arten anzuzeigen. In der Liste können bis zu 300 alphabetisch sortierte Arten erscheinen. Wenn Sie bessere Treffer bei den Arten brauchen, tippen Sie ein oder mehrere Zeichen ein.

Fügen Sie einen Abfragefilter hinzu, um die Ergebnisse auf Entitäten zu beschränken, die bestimmte Kriterien erfüllen:

1. Führen Sie eine Abfrage wie SELECT * FROM Task WHERE done=false aus. Bei Task und done wird zwischen Groß- und Kleinschreibung unterschieden. In den Ergebnissen sehen Sie die von Ihnen erstellte Entität Task, da ihr Wert done false ist.
2. Führen Sie nun eine Abfrage wie SELECT * FROM Task WHERE done=true aus. In den Ergebnissen ist die von Ihnen erstellte Entität Task nicht enthalten, da ihr Wert done nicht true ist.

Bereinigen

1. Klicken Sie auf Abfrage nach Art und achten Sie darauf, dass Task die ausgewählte Art ist.
2. Klicken Sie auf Löschen, um alle Abfrageklauseln zu entfernen.
3. Wählen Sie die von Ihnen erstellte Entität Task aus.
4. Klicken Sie auf Löschen und bestätigen Sie, dass Sie die Entität Task löschen möchten. Je nach Größe des Browserfensters befindet sich die Option Löschen möglicherweise im -Menü Weitere Aktionen. Nach dem Löschen wird die Entität dauerhaft aus der Datenbank entfernt.

Das war alles. Sie haben diesen Schnellstart abgeschlossen!

Nächste Schritte

• Weitere Informationen zu Datastore-Abfragen
• Mehr zu Datenbanken im Datastore-Modus