Kurzanleitung: Konsole verwenden

In dieser Kurzanleitung erfahren Sie, wie Sie mithilfe der Google Cloud Console grundlegende Vorgänge in Cloud Spanner 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 ein Projekt aktiviert ist.

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

    Zur Projektauswahl

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

  6. 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 Konsole die Seite Cloud Spanner-Instanzen auf.

    Zur Seite "Instanzen"

  2. Klicken Sie auf Instanz erstellen.

  3. Geben Sie als Instanznamen Test Instance ein.

  4. Geben Sie als 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 standardmäßige Rechenkapazitä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 Konsole 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 als Datenbanknamen example-db ein.

    Ihre Seite zur Datenbankerstellung sieht jetzt so aus:

    Screenshot des Fensters für Datenbankerstellung

  5. Wählen Sie einen Datenbankdialekt aus.

    Informationen zur Unterstützung von PostgreSQL und eine Anleitung zum Auswählen eines Dialekts finden Sie unter PostgreSQL-Oberfläche.

  6. Wenn Sie Google-Standard-SQL ausgewählt haben, lassen Sie das Textfeld Schema definieren vorerst leer. Sie definieren Ihr Schema im nächsten Abschnitt dieser Schnellstartanleitung.

  7. Klicken Sie auf Erstellen.

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

Schema für Datenbank erstellen

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

    In der Konsole wird die Seite „DDL-Anweisungen schreiben“ angezeigt.

  2. Geben Sie Folgendes ein:

    Google-Standard-SQL

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

    PostgreSQL

    CREATE TABLE Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      SingerInfo BYTEA,
      BirthDate  TIMESTAMPTZ
    );
    
  3. Klicken Sie auf Senden.

    Die Konsole kehrt zur Seite example-dbÜbersicht zurück und zeigt an, dass die Schemaaktualisierungen derzeit ausgeführt werden. Nach Abschluss der Aktualisierung sieht die Seite so aus:

    Google-Standard-SQL

    Screenshot der Tabelle

    PostgreSQL

    Screenshot der Tabelle

    Beachten Sie, dass PostgreSQL den Tabellennamen vollständig in Kleinbuchstaben konvertiert.

Daten einfügen und ändern

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

Daten einfügen

  1. Klicken Sie auf der Seite example-db Übersicht in der Liste der Tabellen auf die Tabelle Singers.

    In der Konsole wird die Tabelle Singers für das Schema angezeigt.

  2. Klicken Sie im Navigationsmenü auf Daten, um die Tabelle Singers Daten aufzurufen.

  3. Klicken Sie auf Insert (Einfügen).

    In der Konsole wird die Seite SingersAbfrage mit der neuen Abfrageabfrage mit den neuen INSERT- und SELECT-Anweisungen angezeigt, die Sie zum Einfügen einer Zeile in die Tabelle Singers verwenden. Außerdem wird das Ergebnis dieser Einfügung angezeigt:

    Google-Standard-SQL

      -- 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>;
    

    PostgreSQL

      -- 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: bigint
        <birthdate>, -- type: timestamp with time zone
        <firstname>, -- type: character varying
        <lastname>, -- type: character varying
        <singerinfo> -- type: bytea
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      singers
    WHERE
      singerid=<singerid>;
    

    Beachten Sie, dass PostgreSQL die Spaltennamen vollständig in Kleinbuchstaben konvertiert.

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

    Google-Standard-SQL

      -- 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;
    

    PostgreSQL

      -- 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: bigint
        NULL, -- type: timestamp with time zone
        'Marc', -- type: character varying
        'Richards', -- type: character varying
        NULL -- type: bytea
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      singers
    WHERE
      singerid=1;
    
  5. Klicken Sie auf Ausführen.

    Spanner führt die Anweisungen aus. Wenn der Vorgang abgeschlossen ist, wird im Tab Ergebnisse angezeigt, dass mit der ersten Anweisung eine Zeile eingefügt wurde, und es wird ein Link zum Anzeigen der Tabellendaten bereitgestellt.

  6. Klicken Sie im Tab Ergebnisse auf den Link Tabelle. Die Tabelle Singers hat jetzt eine Zeile:

    Google-Standard-SQL

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

    PostgreSQL

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

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

    In der Konsole wird wieder die Tabelle Abfrage der Tabelle Singers mit einem neuen Abfragetab angezeigt, der dieselben Vorlagen INSERT und SELECT enthält.

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

    Google-Standard-SQL

      -- 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;
    

    PostgreSQL

      -- 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: bigint
        NULL, -- type: timestamp with time zone
        'Catalina', -- type: character varying
        'Smith', -- type: character varying
        NULL -- type: bytea
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      singers
    WHERE
      singerid=2;
    
  9. Klicken Sie auf Ausführen.

    Nachdem Spanner die Anweisungen ausgeführt hat, zeigt der Tab Ergebnisse noch einmal an, dass die erste Anweisung eine Zeile eingefügt hat.

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

    Google-Standard-SQL

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

    PostgreSQL

    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 Konsole wird wieder die Tabelle Abfrage der Tabelle Singers mit einem neuen Abfragetab angezeigt, der dieselben Vorlagen INSERT und SELECT enthält.

  2. Bearbeiten Sie die Vorlage mit der VALUES-Klausel der INSERT-Anweisung und der WHERE-Klausel der SELECT-Anweisung:

    Google-Standard-SQL

      -- 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;
    

    PostgreSQL

      -- 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: bigint
        NULL, -- type: timestamp with time zone
        'Kena', -- type: character varying
        '', -- type: character varying
        NULL -- type: bytea
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      singers
    WHERE
      singerid=3;
    

    Beachten Sie, dass der für die Nachname-Spalte angegebene Wert ein leerer String ('') ist, kein NULL-Wert.

  3. Klicken Sie auf Ausführen.

    Nachdem Spanner die Anweisungen ausgeführt hat, zeigt der Tab Ergebnisse noch einmal an, dass die erste Anweisung eine Zeile eingefügt hat.

  4. Klicken Sie auf den Link Tabelle. Die Tabelle Singers besitzt nun drei Zeilen, und die Zeile mit dem Primärschlüsselwert 3 hat eine Spalte mit dem Nachnamen, die ein leerer String ist:

    Google-Standard-SQL

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

    PostgreSQL

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

Daten bearbeiten

  1. Klicken Sie auf der Singers-Tabelle Daten auf das Kästchen neben der Zeile mit dem Primärschlüssel von 3 und dann auf Bearbeiten.

    In der Konsole wird die Seite Abfrage mit einem neuen Tab angezeigt, der die von Ihnen bearbeiteten Vorlagen für UPDATE und SELECT enthält. Die WHERE-Klauseln beider Anweisungen geben an, dass die zu aktualisierende Zeile die Zeile mit dem Primärschlüsselwert 3 ist.

    Google-Standard-SQL

      -- 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;
    

    PostgreSQL

      -- 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 zur Anweisung UPDATE, um nur das Geburtsdatum zu aktualisieren:

    Google-Standard-SQL

      -- 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;
    

    PostgreSQL

      -- Change values in the SET clause to update the row where the WHERE condition is true.
    UPDATE
      singers
    SET
      birthdate='1961-04-01 00:00:00 -8:00'
    WHERE
      singerid='3';
    SELECT
      *
    FROM
      singers
    WHERE
      singerid='3';
    
  3. Klicken Sie auf Ausführen.

    Spanner führt die Anweisungen aus. Wenn der Vorgang abgeschlossen ist, wird im Tab Ergebnisse angezeigt, dass mit der ersten Anweisung eine Zeile aktualisiert wurde, und es wird ein Link zum Anzeigen der Tabellendaten bereitgestellt.

  4. Klicken Sie im Tab Ergebnisse auf den Link Tabelle.

    In der aktualisierten Zeile wird jetzt ein Wert für das Geburtsdatum angezeigt.

    Google-Standard-SQL

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

    PostgreSQL

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

Daten löschen

  1. Klicken Sie auf der SingersTabellenseite auf das Kästchen neben der Zeile mit 2 in der ersten Spalte und dann auf Löschen.
  2. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.

    Die Tabelle Singers enthält jetzt zwei Zeilen:

    Google-Standard-SQL

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

    PostgreSQL

    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 example-db Übersicht im Navigationsmenü auf Abfrage, um die Seite Abfrage für example-db aufzurufen.

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

    Google-Standard-SQL

    SELECT * FROM Singers;
    

    PostgreSQL

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

    Spanner führt die Abfrage aus. Wenn Sie fertig sind, wird auf dem Tab Results (Ergebnisse) das Ergebnis Ihrer Abfrage angezeigt:

    Google-Standard-SQL

    Screenshot der Abfrageergebnisse

    PostgreSQL

    Screenshot der Abfrageergebnisse

Glückwunsch! 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 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.

Weitere Informationen