Daten in Firestore im Datastore-Modus speichern und abfragen

Auf dieser Seite erfahren Sie, wie Sie Daten in Firestore im Datastore-Modus mit der Google Cloud Console speichern und abfragen.

Hinweise

  • Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  • In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  • In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

    •

  • 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. Zum Erstellen einer neuen Datenbankinstanz öffnen Sie 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 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 Mobil- und Webanwendungen. Arbeiten Sie zum Einsteig in die Arbeit mit Firestore die Firestore-Kurzanleitung durch.

      • Firestore im Datastore-Modus

        Empfohlen für App-Architekturen mit Backend-Servern.

      Weitere Informationen zum Auswählen des passenden Datenbankmodus sowie einen Funktionsvergleich finden Sie unter Zwischen nativem Modus und Datastore-Modus wechseln.

    3. Wählen Sie einen Datenbankstandort aus. Im Datastore-Modus werden Standorte mit mehreren Regionen und regionale Standorte unterstützt.

      Ein multiregionaler Standort maximiert die 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-Apps für Ihr Google Cloud -Projekt.

      Klicken Sie auf Datenbank erstellen. Nachdem die Initialisierung der Datenbank abgeschlossen ist, werden Sie in derGoogle Cloud -Konsole 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 im Feld Art Task ein. Belassen Sie Schlüssel-ID 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) ✓
      done Boolescher Wert false ✓
      Ihre Erstellungsseite sollte nun so aussehen:

      Das Fenster zum Erstellen von Entitäten mit verschiedenen Attributen

    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 mit der Google Query Language (GQL). In der Anleitung unten wird beschrieben, wie Sie beide verwenden, um Ihre Datenbank abzufragen.

    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 (boolescher Wert) und false (falsch) aus.
    3. Klicken Sie auf Ausführen. In den Ergebnissen sehen Sie die von Ihnen erstellte Entität Task, da ihr Wert done false ist. Eine Artabfrage mit einem Filter
    4. Ändern Sie die Abfrageklausel nun in WHERE, done, ==, boolean und true. Klicken Sie auf Ausführen. In den Ergebnissen ist die von Ihnen erstellte Entität Task nicht enthalten, denn deren Wert für done lautet nicht true.

    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.

    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. Eine GQL-Abfrage mit einem Filter
    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 Löschen möglicherweise im Menü  Weitere Aktionen. Durch das Löschen wird die Entität dauerhaft aus der Datenbank entfernt.

    Das war alles. Sie haben diesen Schnellstart abgeschlossen!

    Weitere Informationen