Datenbank mit der Google Cloud Console erstellen und abfragen

In dieser Kurzanleitung erfahren Sie, wie Sie grundlegende Vorgänge in Spanner mithilfe der Google Cloud Console Dabei führen Sie die folgenden Vorgänge aus:

• Erstellen Sie eine Spanner-Instanz.
• Datenbank erstellen
• Schema erstellen
• Daten einfügen und ändern
• Abfrage ausführen

Informationen zu den Kosten für die Verwendung von Spanner finden Sie unter Preise.

Hinweis: Wenn Sie Spanner mit einer 90-tägigen kostenlosen Testinstanz ausprobieren möchten, Weitere Informationen finden Sie unter Kostenlose Spanner-Testinstanz erstellen.

Hinweise

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Optional: Die Spanner API sollte automatisch aktiviert werden. Falls nicht, aktivieren Sie sie manuell:
   Spanner API aktivieren

7. Um die Berechtigungen zu erhalten, die Sie zum Erstellen von Instanzen und Datenbanken benötigen, bitten Sie Ihren Administrator, Ihnen Cloud Spanner-Administrator (roles/spanner.admin) IAM-Rolle für Ihr Projekt

Instanz erstellen

Wenn Sie Spanner zum ersten Mal verwenden, müssen Sie eine Instanz erstellen. Dies ist eine die von Spanner-Datenbanken verwendet werden, Instanz.

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

   Spanner aufrufen

2. Wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

3. Klicken Sie auf der Seite Spanner auf Bereitgestellte Instanz erstellen.

   Wenn Sie Spanner bereits verwendet haben, wird anstelle der Produktseite die Seite Spanner-Instanzen angezeigt. Klicken Sie auf Instanz erstellen.

4. Geben Sie auf der Seite Instanz benennen einen Instanznamen ein, z. B. Testinstanz.

5. Die Instanz-ID wird automatisch basierend auf dem Instanznamen eingegeben, z. B. test-instance. Ändern Sie ihn bei Bedarf. Klicken Sie auf Weiter.

6. Behalten Sie auf der Seite Instanz konfigurieren die Standardoption Regional bei und wählen Sie eine Konfiguration aus dem Drop-down-Menü aus.

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

7. Klicken Sie auf Weiter.

8. Wählen Sie auf der Seite Rechenkapazität zuweisen die Option Verarbeitungseinheiten aus. und den Standardwert von 1.000 Verarbeitungseinheiten beibehalten.

9. Klicken Sie auf Erstellen.

   In der Google Cloud Console wird die Seite Übersicht für die Instanz angezeigt. die Sie erstellt haben.

Datenbank erstellen

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

   Spanner-Instanzen aufrufen

2. Klicken Sie auf die von Ihnen erstellte Instanz, z. B. Test Instance.

3. Klicken Sie auf der Übersichtsseite der Instanz, die geöffnet wird, auf Datenbank erstellen.

4. Geben Sie für den Datenbanknamen einen Namen wie beispieldatenbank ein.

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. Wenn Sie GoogleSQL ausgewählt haben, definieren Sie das Schema im Textfeld Define your schema (Schema definieren) im nächsten Abschnitt dieser Kurzanleitung.

   Ihre Seite zur Datenbankerstellung sieht jetzt so aus:

   

6. Klicken Sie auf Erstellen.

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

Schema für Datenbank erstellen

Hinweis: Spanner Studio (in der Google Cloud Console früher als Query bezeichnet) unterstützt SQL-, DML- und DDL-Vorgänge in einem einzigen Editor. Weitere Informationen Weitere Informationen finden Sie unter Daten mit der Google Cloud Console verwalten.

1. Klicken Sie im Navigationsmenü auf Spanner Studio.

2. Klicken Sie auf der Seite Spanner Studio auf  Neuer Tab oder verwenden Sie den leeren Editortab.

3. Geben Sie Folgendes ein:

   GoogleSQL

   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 (
     BirthDate  TIMESTAMPTZ,
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA
   );
   

4. Klicken Sie auf Ausführen.

   Die Google Cloud Console kehrt zur Seite Übersicht der Datenbank zurück und zeigt an, dass Schemaaktualisierungen durchgeführt werden. Nach Abschluss des Updates sieht die Seite so aus:

   GoogleSQL

   

   PostgreSQL

   

   Beachten Sie, dass PostgreSQL den Tabellennamen in Kleinbuchstaben konvertiert.

Daten einfügen und ändern

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

Daten einfügen

1. Klicken Sie in der Tabellenliste auf der Seite Übersicht der Datenbank auf die Tabelle „Sänger“.

   In der Google Cloud Console wird die Seite Schema der Tabelle „sing“ angezeigt.

2. Klicken Sie im Navigationsmenü auf Daten, um die Seite Daten der Tabelle „Sänger“ aufzurufen.

3. Klicken Sie auf Einfügen.

   In der Google Cloud Console wird Spanner Studio der Tabelle „sing“ angezeigt Seite mit einem neuen Abfragetab, der die Anweisungen INSERT und SELECT enthält, die bearbeiten Sie, um eine Zeile in die Tabelle "Mirrors" einzufügen und das Ergebnis dieser Zeile anzuzeigen. Einfügen:

   GoogleSQL

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

   GoogleSQL

     -- 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 "Mirrors" enthält jetzt eine Zeile:

   GoogleSQL

   

   PostgreSQL

   

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

   In der Google Cloud Console wird wieder die Tabelle Spanner Studio angezeigt. Seite mit einem neuen Abfragetab, der die gleichen INSERT und SELECT enthält Aussagen.

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

   GoogleSQL

     -- 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, wird im Tab Ergebnisse noch einmal angezeigt, dass durch die erste Anweisung eine Zeile eingefügt wurde.

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

    GoogleSQL

    

    PostgreSQL

    

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

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

   Spanner zeigt noch einmal die Seite Spanner Studio der Tabelle „Sänger“ mit einem neuen Abfragetab an, der die gleichen INSERT- und SELECT-Anweisungen enthält.

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

   GoogleSQL

     -- 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, wird im Tab Ergebnisse angezeigt, dass durch die erste Anweisung eine Zeile eingefügt wurde.

4. Klicken Sie auf den Link Tabelle. Die Tabelle Singers enthält jetzt drei Zeilen und die Zeile mit dem Primärschlüsselwert 3 hat in der Spalte LastName einen leeren String:

   GoogleSQL

   

   PostgreSQL

   

Daten bearbeiten

1. Klicken Sie auf der Seite Daten der Tabelle „Singers“ auf das Kästchen in der Zeile mit dem Primärschlüsselwert 3 und dann auf Bearbeiten.

   In Spanner wird die Seite Spanner Studio mit einem neuen Tab angezeigt, der die von Ihnen bearbeitbaren UPDATE- und SET-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.

   GoogleSQL

     -- 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=NULL,
     firstname='Kena',
     lastname='',
     singerinfo=NULL
   WHERE
     singerid='3';
   SELECT
     *
   FROM
     singers
   WHERE
     singerid='3';
   

2. Bearbeiten Sie die SET-Klausel der UPDATE-Anweisung, um nur das Geburtsdatum zu aktualisieren:

   GoogleSQL

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

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

   GoogleSQL

   

   PostgreSQL

   

Daten löschen

1. Klicken Sie auf der Seite Daten der Tabelle "Sprache" das Kästchen für die Zeile mit 2 in der ersten Spalte an und klicken Sie dann auf Löschen.

2. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.

   Die Tabelle „Singers“ enthält jetzt zwei Zeilen:

   GoogleSQL

   

   PostgreSQL

   

Abfrage ausführen

1. Klicken Sie auf der Seite Übersicht der Datenbank im Navigationsmenü auf Spanner Studio.

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

   GoogleSQL

   SELECT * FROM Singers;
   

   PostgreSQL

   SELECT * FROM singers;
   

3. Klicken Sie auf Ausführen.

   Spanner führt die Abfrage aus. Wenn Sie fertig sind, erscheinen die Ergebnisse zeigt das Ergebnis Ihrer Abfrage an:

   GoogleSQL

   

   PostgreSQL

   

Glückwunsch! Sie haben erfolgreich eine 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. Beim Löschen einer Instanz wird allen in der Instanz erstellten Datenbanken.

Datenbank löschen

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

   Spanner-Instanzen aufrufen

2. Klicken Sie auf den Namen der Instanz mit der Datenbank, die Sie löschen möchten, z. B. Testinstanz.

3. Klicken Sie auf den Namen der Datenbank, die Sie löschen möchten, z. B. beispieldatenbank.

4. Klicken Sie auf der Seite Datenbankdetails auf Datenbank löschen.

5. Bestätigen Sie, dass die Datenbank gelöscht werden soll. Geben Sie dazu den Namen der Datenbank ein und klicken Sie auf Löschen.

Instanz löschen

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

   Spanner-Instanzen aufrufen

2. Klicken Sie auf den Namen der Instanz, die Sie löschen möchten, z. B. Test Instanz.

3. Klicken Sie auf  Instanz löschen.

4. Bestätigen Sie, dass Sie die Instanz löschen möchten, indem Sie den Instanznamen eingeben und auf Löschen klicken.

Nächste Schritte

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