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 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.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das 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 die Standardrechenkapazität von 1.000 Verarbeitungseinheiten.

    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. Überspringen Sie den Schritt Schema definieren. Sie definieren Ihr Schema im nächsten Abschnitt dieser Schnellstartanleitung.

  6. Klicken Sie auf Erstellen.

    In der Cloud Console wird die Seite Übersicht für die von Ihnen erstellte Datenbank angezeigt.

Schema für Datenbank erstellen

  1. Klicken Sie auf der Seite Übersicht von example-db am Anfang der Tabellenliste auf Tabelle erstellen.

    In der Cloud Console wird die Seite DDL-Anweisungen schreiben angezeigt.

  2. Geben Sie Folgendes ein:

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

  3. Klicken Sie auf Senden.

    Die Cloud Console kehrt zur Seite Übersicht von example-db zurück und zeigt, dass Schemaaktualisierungen im Gange sind. Wenn die Aktualisierung abgeschlossen ist, sieht die Seite so aus:

    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 auf der Seite Übersicht von example-db in der Tabellenliste auf Tabelle.

    Die Cloud Console zeigt die Seite Schema der Tabelle an.

  2. Klicken Sie im seitlichen Menü auf Daten, um die Seite Daten der Tabelle zu öffnen.

  3. Klicken Sie auf Einfügen.

    In der Cloud Console wird die Seite Abfrage der Tabelle mit der neuen Abfrage angezeigt. Sie enthält einen neuen Tab "Abfrage" mit den Vorlagen INSERT und SELECT, die Sie zum Einfügen einer Zeile in die Tabelle "Sänger" bearbeiten. Sehen Sie sich das Ergebnis dieser Einfügung an:

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (<SingerId>, -- type: INT64
        <BirthDate>, -- type: DATE
        <FirstName>, -- type: STRING(1024)
        <LastName>, -- type: STRING(1024)
        <SingerInfo> -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=<SingerId>;
    
  4. Bearbeiten Sie die VALUES-Klausel der INSERT-Anweisung und die WHERE-Klausel der SELECT-Anweisung:

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (1, -- type: INT64
        NULL, -- type: DATE
        'Marc', -- type: STRING(1024)
        'Richards', -- type: STRING(1024)
        NULL -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=1;
    
  5. Klicken Sie auf Ausführen.

    Cloud Spanner führt die Anweisungen aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse angezeigt, dass mit der ersten Anweisung eine Zeile eingefügt wurde, sowie ein Link zum Aufrufen der Daten der Tabelle.

  6. Klicken Sie auf dem Tab Ergebnisse auf den Link Tabelle. Die Tabelle vielfache enthält jetzt eine Zeile:

    Screenshot der Tabelle &quot;Singers&quot; mit einer Datenzeile

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

    In der Cloud Console werden wieder dieAbfrage Seite mit einem neuen Abfragetab mit derselben VorlageINSERT undSELECT Anweisungen.

  8. Bearbeiten Sie die VALUES-Klausel der INSERT-Anweisung und die WHERE-Klausel der SELECT-Anweisung:

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (2, -- type: INT64
        NULL, -- type: DATE
        'Catalina', -- type: STRING(1024)
        'Smith', -- type: STRING(1024)
        NULL -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=2;
    
  9. Klicken Sie auf Ausführen.

    Nachdem Cloud Spanner die Anweisungen ausgeführt hat, zeigt der Tab Results wieder an, dass mit der ersten Anweisung eine Zeile eingefügt wurde.

  10. Klicken Sie auf den Link Tabelle. Die Tabelle Singers enthält jetzt zwei Zeilen:

    Screenshot der Tabelle &quot;Singers&quot; mit zwei Datenzeilen

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

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

    In der Cloud Console werden wieder dieAbfrage Seite mit einem neuen Abfragetab mit derselben VorlageINSERT undSELECT Anweisungen.

  2. Vorlage bearbeitenINSERT dieser AussageVALUES -Klausel undSELECT AnweisungWHERE Klausel:

        -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (3, -- type: INT64
        NULL, -- type: DATE
        'Kena', -- type: STRING(1024)
        '', -- type: STRING(1024)
        NULL -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=3;
    

    Der für LastName angegebene Wert ist ein leerer String, '' und kein NULL-Wert.

  3. Klicken Sie auf Ausführen.

    Nachdem Cloud Spanner die Anweisungen ausgeführt hat, zeigt der Tab Results wieder an, dass mit der ersten Anweisung eine Zeile eingefügt wurde.

  4. Klicken Sie auf den Link Tabelle. Die Tabelle Interpreten hat jetzt drei Zeilen und die Zeile für SingerID 3 hat einen LastName, der ein leerer String ist:

    Screenshot der Tabelle &quot;Singers&quot; mit drei Datenzeilen

Daten bearbeiten

  1. Klicken Sie auf der Seite Daten der Tabelle "Sänger" auf das Kästchen neben der Zeile für SingerId 3 und dann auf Bearbeiten.

    In der Cloud Console wird die Seite Abfrage der Tabelle mit der neuen Abfrage angezeigt. Sie enthält einen neuen Tab "Abfrage" mit den Vorlagen UPDATE und SELECT, die Sie bearbeiten, um die Zeile in der Tabelle "Sänger" zu aktualisieren. das Ergebnis des Updates aufrufen. Die WHERE-Klauseln beider Anweisungen geben an, dass die zu aktualisierende Zeile die Zeile für SingerId 3 ist.

      -- Change values in the SET clause to update the row where the WHERE condition is true.
    UPDATE
      Singers
    SET
      BirthDate='',
      FirstName='Kena',
      LastName='',
      SingerInfo=''
    WHERE
      SingerId=3;
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=3;
    
  2. Bearbeiten Sie die SET-Klausel der UPDATE-Anweisung, um nur die Spalte BirthDate zu aktualisieren:

      -- Change values in the SET clause to update the row where the WHERE condition is true.
    UPDATE
      Singers
    SET
      BirthDate='1961-04-01'
    WHERE
      SingerId=3;
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=3;
    
  3. Klicken Sie auf Ausführen.

    Cloud Spanner führt die Anweisungen aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse angezeigt, dass mit der ersten Anweisung eine Zeile aktualisiert wurde, und ein Link zum Aufrufen der Daten der Tabelle bereitgestellt.

  4. Klicken Sie auf dem Tab Ergebnisse auf den Link Tabelle. Die Zeile für SingerId 3 in der Tabelle Verwendet enthält jetzt einen Wert für Geburtsdatum:

    Screenshot der Tabelle &quot;Singers&quot; mit drei Datenzeilen; die dritte Zeile enthält jetzt einen Wert für &quot;BirthDate&quot;

Daten löschen

  1. Klicken Sie auf der Seite Daten der Tabelle "Sänger" auf das Kästchen neben der Zeile für SingerId 2 und dann auf Löschen.
  2. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.

    Die Tabelle Singers enthält jetzt zwei Zeilen:

    Screenshot der Tabelle &quot;Singers&quot; mit zwei Datenzeilen; die Zeile für &quot;SingerId 2&quot; fehlt

Abfrage ausführen

  1. Klicken Sie auf der Seite Übersicht von example-db auf Abfrage im seitlichen Menü, um die Seite Abfrage von example-db anzuzeigen.

  2. Klicken Sie auf Neuer Tab, um einen neuen Abfrage-Tab zu erstellen. Geben Sie dann die folgende Abfrage ein:

    SELECT * FROM Singers;
    
  3. Klicken Sie auf Ausführen.

    Cloud Spanner führt die Abfrage aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse 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.

Clean-up

Löschen Sie die Datenbank und die von Ihnen erstellte Instanz, um zusätzliche Kosten für Ihr Cloud-Rechnungskonto 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.

Nächste Schritte