Kurzanleitung: Konsole 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. 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 Ihr 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 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 Standard-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 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. 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 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 der example-db am Anfang der Liste der Tabellen auf Tabelle erstellen.

    In der Cloud Console 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 Cloud Console kehrt zur Seite Übersicht von example-db zurück und zeigt, dass Schema-Updates durchgeführt werden. Wenn die Aktualisierung abgeschlossen ist, sieht die Seite so aus:

    Google-Standard-SQL

    Screenshot der Tabelle

    PostgreSQL

    Screenshot der Tabelle

    PostgreSQL wandelt den Tabellennamen in Kleinbuchstaben um.

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 in example-db in der Tabellenliste auf die Tabelle Singers.

    Die Cloud Console zeigt die Seite Schema der Tabelle "Sänger" an.

  2. Klicken Sie im seitlichen Menü auf Daten, um die Seite Daten der Tabelle "Sänger" aufzurufen.

  3. Klicken Sie auf Einfügen.

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

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

    PostgreSQL wandelt die Spaltennamen in Kleinbuchstaben um.

  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.

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

  6. Klicken Sie im Tab Ergebnisse auf den Link Tabelle. Die Tabelle Singers enthält 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.

    Die Cloud Console zeigt noch einmal die Seite Abfrage der Tabelle "Singers" mit einem neuen Abfragetab an, der die gleichen INSERT- und SELECT-Anweisungen der Vorlage 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 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 versprochen 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.

    Die Cloud Console zeigt noch einmal die Seite Abfrage der Tabelle "Singers" mit einem neuen Abfragetab an, der die gleichen INSERT- und SELECT-Anweisungen der Vorlage enthält.

  2. Vorlage bearbeitenINSERT dieserVALUES -Klausel undSELECT dieserWHERE Klausel:

    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 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 versprochen enthält jetzt drei Zeilen. Die Zeile mit dem Primärschlüsselwert 3 hat eine Spalte für einen 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 Seite Daten der Tabelle "Sänger" auf das Kästchen neben der Zeile mit dem Primärschlüsselwert 3 und dann auf Bearbeiten.

    Die Cloud Console zeigt die Seite Abfrage mit einem neuen Tab an, der die von Ihnen bearbeiteten UPDATE- und SELECT-Anweisungen der Vorlage 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 der UPDATE-Anweisung, 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.

    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 im Tab Ergebnisse auf den Link Tabelle.

    Die aktualisierte Zeile enthält jetzt einen Wert für das Geburtsdatum.

    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 Seite Daten der Tabelle "Sänger" 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 Übersicht der example-db auf Abfrage im seitlichen Menü, um die Seite Abfrage der example-db aufzurufen.

  2. Klicken Sie auf Neuer Tab, um einen neuen Abfrage-Tab 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.

    Cloud Spanner führt die Abfrage aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse das Ergebnis der Abfrage angezeigt:

    Google-Standard-SQL

    Screenshot der Abfrageergebnisse

    PostgreSQL

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