Kurzanleitung: Console verwenden

In dieser Kurzanleitung wird Ihnen gezeigt, wie Sie in Cloud Spanner grundlegende Vorgänge mit der Google Cloud Console ausführen. Dabei führen Sie die folgenden Vorgänge aus:

  • Cloud Spanner-Instanz, -Datenbank und -Tabelle erstellen
  • Schema hinzufügen
  • Daten schreiben und ändern
  • Abfrage ausführen

Hinweis

  1. Melden Sie sich bei Ihrem Google-Konto an.

    Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

  2. Wählen Sie in der Cloud Console auf der Seite für die Projektauswahl ein Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Aktivieren Sie die Cloud Spanner API für das Projekt.

    Cloud Spanner API aktivieren

Instanz erstellen

Bei der ersten Verwendung von Cloud Spanner müssen Sie eine Instanz erstellen. Dabei handelt es sich um eine Zuordnung von Ressourcen, die von Cloud Spanner-Datenbanken in dieser Instanz verwendet werden.

  1. Rufen Sie in der Cloud Console die Seite Cloud Spanner-Instanzen auf.

    Zur Seite "Instanzen"

  2. Klicken Sie auf Instanz erstellen.

  3. Geben Sie für den Instanznamen Test Instance ein.

  4. Geben Sie für die Instanz-ID test-instance ein.

  5. Verwenden Sie eine regionale Konfiguration.

  6. Wählen Sie eine beliebige regionale Konfiguration aus dem Drop-down-Menü aus.

    Die Instanzkonfiguration legt fest, an welchem geografischen Standort Instanzen gespeichert und repliziert werden.

  7. Verwenden Sie für die Knotenzahl den Wert 1.

    Ihre Instanzerstellungsseite sieht jetzt so aus:

    Screenshot des Fensters für die Instanzerstellung

  8. Klicken Sie auf Erstellen.

    Die Instanz wird in der Instanzliste angezeigt.

Datenbank erstellen

  1. Rufen Sie in der Cloud Console die Seite Cloud Spanner-Instanzen auf.

    Zur Seite "Instanzen"

  2. Klicken Sie auf die Instanz Test Instance.

  3. Klicken Sie auf Datenbank erstellen.

  4. Geben Sie für den Datenbanknamen example-db ein.

    Ihre Seite zur Datenbankerstellung sieht jetzt so aus:

    Screenshot des Fensters für Datenbankerstellung

  5. Klicken Sie auf Weiter.

  6. Überspringen Sie den Schritt Datenbankschema definieren. Sie definieren Ihr Schema im nächsten Abschnitt dieser Schnellstartanleitung.

  7. Klicken Sie auf Erstellen.

    Nachdem die Datenbank erstellt ist, wird in der Cloud Console die Seite Datenbankdetails angezeigt.

Schema für Datenbank erstellen

Die Cloud Console bietet zwei Möglichkeiten zum Erstellen, Ändern und Löschen von Tabellen und Indexen in einer Datenbank:

  • Mit dem Standarddatenbankeditor alle Teile der Tabellen, Spalten und Indexe angeben
  • Im Editor den Modus Als Text bearbeiten aktivieren und SQL-Anweisungen in der Cloud Spanner-Datendefinitionssprache (Data Definition Language, DDL) eingeben

In dieser Kurzanleitung verwenden Sie DDL.

  1. Klicken Sie im linken Bereich der Cloud Console auf die Datenbank example-db.
  2. Klicken Sie auf Tabelle erstellen.
  3. Klicken Sie auf die Schaltfläche Als Text bearbeiten.
  4. Geben Sie in das Feld DDL-Anweisung Folgendes ein:

    CREATE TABLE Singers (
      SingerId   INT64 NOT NULL,
      FirstName  STRING(1024),
      LastName   STRING(1024),
      SingerInfo BYTES(MAX),
      BirthDate  DATE,
    ) PRIMARY KEY(SingerId);
    

  5. Klicken Sie auf Erstellen.

    Der Vorgang kann einige Minuten dauern. Wenn der Vorgang abgeschlossen ist, werden in der Cloud Console die Details der von Ihnen erstellten Tabelle angezeigt:

    Screenshot der Tabelle

Daten einfügen und ändern

Die Cloud Console bietet eine Schnittstelle zum Einfügen, Bearbeiten und Löschen von Daten.

Daten einfügen

  1. Klicken Sie im linken Bereich der Cloud Console auf Singers.
  2. Klicken Sie auf Daten.
  3. Klicken Sie auf Einfügen.
  4. Geben Sie die folgenden Werte ein:

    Feld Wert
    SingerID:INT64 1
    BirthDate:DATE [keine Eingabe]
    FirstName:STRING Marc
    LastName:STRING Richards
    SingerInfo:BYTES [keine Eingabe]
  5. Klicken Sie auf Speichern.

    Die Tabelle Singers enthält jetzt eine Zeile:

    Screenshot der Tabelle

  6. Klicken Sie auf Einfügen, um eine weitere Zeile hinzuzufügen.

  7. Geben Sie die folgenden Werte ein:

    Feld Wert
    SingerID:INT64 2
    BirthDate:DATE [keine Eingabe]
    FirstName:STRING Catalina
    LastName:STRING Smith
    SingerInfo:BYTES [keine Eingabe]
  8. Klicken Sie auf Speichern.

    Die Tabelle Singers enthält jetzt zwei Zeilen:

    Screenshot der Tabelle

Sie können bei der Dateneingabe auch leere Zeichenfolgewerte eingeben.

  1. Klicken Sie im linken Bereich auf Singers.
  2. Klicken Sie auf Daten.
  3. Klicken Sie auf Einfügen.
  4. Geben Sie die folgenden Werte ein:

    Feld Wert
    SingerID:INT64 3
    BirthDate:DATE [keine Eingabe]
    FirstName:STRING Kena
    LastName:STRING [Aktivieren Sie Leerer String]
    SingerInfo:BYTES [keine Eingabe]
  5. Klicken Sie auf Speichern.

    Die Tabelle Singers enthält jetzt drei Zeilen und die Zeile für SingerID 3 hat als LastName einen leeren String:

    Screenshot der Tabelle

Daten bearbeiten

  1. Klicken Sie im linken Bereich der Cloud Console auf Singers.
  2. Klicken Sie auf Daten.
  3. Klicken Sie auf das Kästchen neben der Zeile für SingerId 3 und dann auf Bearbeiten.
  4. Geben Sie den folgenden Wert ein:

    Feld Wert
    BirthDate:DATE 1961-04-01
    [alle anderen Felder] [unverändert beibehalten]
  5. Klicken Sie auf Speichern.

    Die Zeile für SingerId 3 in der Tabelle Singers enthält jetzt einen Wert für BirthDate:

    Screenshot der Tabelle

Daten löschen

  1. Klicken Sie im linken Bereich der Cloud Console auf Singers.
  2. Klicken Sie auf Daten.
  3. Klicken Sie auf das Kästchen neben der Zeile für SingerId 2 und dann auf Löschen.
  4. Klicken Sie im angezeigten Dialogfeld auf OK.

    Die Tabelle Singers enthält jetzt zwei Zeilen:

    Screenshot der Tabelle

Abfrage ausführen

Sie können jetzt auf der Abfrageseite eine SQL-Anweisung ausführen.

  1. Klicken Sie im linken Bereich der Cloud Console auf example-db, um die Seite Datenbankdetails aufzurufen.
  2. Klicken Sie auf der Seite Datenbankdetails auf Abfrage.
  3. Geben Sie für die Abfrage Folgendes ein:

    SELECT * FROM Singers
    
  4. Klicken Sie auf Abfrage ausführen.

    In der Cloud Console wird das Ergebnis der Abfrage angezeigt:

    Screenshot der Abfrageergebnisse

Das wars! Sie haben erfolgreich eine Cloud Spanner-Datenbank erstellt und eine SQL-Anweisung mit dem Abfrageeditor ausgeführt.

Bereinigen

Löschen Sie die Datenbank und die Instanz, die Sie erstellt haben, um zusätzliche Kosten für Ihr Google Cloud-Konto zu vermeiden.

Datenbank löschen

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Spanner-Instanzen auf.

    Zur Seite "Instanzen"

  2. Klicken Sie auf Test Instance.

  3. Klicken Sie auf example-db.

  4. Klicken Sie auf der Seite Datenbankdetails auf DATENBANK LÖSCHEN.

  5. Bestätigen Sie, dass die Datenbank gelöscht werden soll, und klicken Sie auf Löschen.

Instanz löschen

Beim Löschen einer Instanz werden alle in dieser Instanz erstellten Datenbanken automatisch gelöscht.

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Spanner-Instanzen auf.

    Zur Seite "Instanzen"

  2. Klicken Sie auf Test Instance.

  3. Klicken Sie auf INSTANZ LÖSCHEN.

  4. Bestätigen Sie, dass die Instanz gelöscht werden soll, und klicken Sie auf Löschen.

Weitere Informationen