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: Informationen zu den Kosten für die Verwendung von Cloud Spanner finden Sie unter Preise.

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.

   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

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:

   

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:

   

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:

   

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:

   

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:

    

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:

   

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:

   

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:

   

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:

   

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

• Weitere Informationen zu Instanzen
• Informationen zum Cloud Spanner-Schema und -Datenmodell
• Weitere Informationen zur Datendefinitionssprache (DDL)
• Weitere Informationen zu Abfrage-Ausführungsplänen
• Informationen zur Verwendung von Cloud Spanner mit C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST oder gcloud.