Datenbank in der Google Cloud Console erstellen und abfragen

In dieser Kurzanleitung erfahren Sie, wie Sie mit der Google Cloud Console eine Datenbank in Spanner erstellen, Daten einfügen und eine SQL-Abfrage ausführen.

Dabei führen Sie die folgenden Vorgänge aus:

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

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

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach 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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Optional: Die Spanner API sollte automatisch aktiviert werden. Ist dies nicht der Fall, aktivieren Sie ihn manuell:
   Spanner API aktivieren

2. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Cloud Spanner-Administrator“ (roles/spanner.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Instanzen und Datenbanken benötigen.

Instanz mit der Google Cloud Console erstellen

Bei der ersten Verwendung von Cloud Spanner müssen Sie eine Instanz erstellen. Dies ist eine Zuordnung von Ressourcen, die von Cloud Spanner-Datenbanken in der Instanz verwendet werden.

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, falls noch nicht geschehen.

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

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

4. Wählen Sie im Abschnitt Version auswählen die Option Standard aus und klicken Sie dann auf Weiter.

5. Geben Sie im Abschnitt Instanz benennen einen Instanznamen ein, z. B. Test Instance.

   Die Instanz-ID wird automatisch anhand des Instanznamens ausgefüllt, z. B. test-instance. Ändern Sie ihn bei Bedarf und klicken Sie dann auf Weiter.

6. Behalten Sie im Abschnitt Instanz konfigurieren unter Konfiguration auswählen die Standardoption Regional bei und wählen Sie im Drop-down-Menü einen Konfigurationsstandort aus.

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

7. Klicken Sie auf Weiter.

8. Wählen Sie im Abschnitt Rechenkapazität konfigurieren für Einheit auswählen die Option Verarbeitungseinheiten (VAs) aus. Behalten Sie unter Skalierungsmodus auswählen die Option Manuelle Zuordnung und die Standard-Menge von 1000 Verarbeitungseinheiten bei.

9. Optional: Deaktivieren Sie im Abschnitt Sicherungen das Kästchen Standard-Sicherungszeitpläne aktivieren, wenn Sie keine Standard-Sicherungszeitpläne für diese Testinstanz erstellen möchten.

10. Klicken Sie auf Erstellen.

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

Datenbank erstellen

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

   Zu Spanner-Instanzen

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

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

4. Geben Sie einen Datenbanknamen ein, z. B. example-db.

5. Wählen Sie einen Datenbankdialekt aus.

   Informationen zur Unterstützung von PostgreSQL und zur Auswahl eines Dialekts finden Sie unter PostgreSQL-Schnittstelle. Lassen Sie den Abschnitt Schema definieren (optional) leer. Sie definieren das Schema im nächsten Abschnitt dieser Kurzanleitung in Spanner Studio.

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

1. Klicken Sie im Navigationsmenü auf Spanner Studio.

2. Klicken Sie auf der Seite Spanner Studio auf add Neuer Tab oder verwenden Sie den Tab Unbenannte Abfrage und geben Sie dann eine der folgenden Abfragen ein,
   je nach Dialekt Ihrer Datenbank:

   GoogleSQL

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

   PostgreSQL

   CREATE TABLE Singers (
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     BirthDate  TIMESTAMPTZ
   );
   

3. Klicken Sie auf play_circleAusführen.

   Spanner führt die Anweisung aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse die Meldung Aktualisierung abgeschlossen angezeigt.

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 im Bereich Explorer auf more_vert Aktionen ansehen für die Tabelle Singers und dann auf Daten einfügen.

   Spanner öffnet in Spanner Studio einen neuen Abfragetab, der eine INSERT-Anweisungsvorlage enthält.

2. Bearbeiten Sie die VALUES-Klausel der INSERT-Anweisung der Vorlage, um eine Zeile in die Tabelle Singers einzufügen und das Ergebnis dieses Einfügevorgangs aufzurufen:

   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,
       FirstName,
       LastName,
       BirthDate)
   VALUES
     (1, -- type: INT64
       'Marc', -- type: STRING(1024)
       'Richards', -- type: STRING(1024)
       NULL -- type: DATE
       )
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   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,
       firstname,
       lastname,
       birthdate)
   VALUES
     (1, -- type: bigint
       'Marc', -- type: character varying
       'Richards', -- type: character varying
       NULL -- type: timestamp with time zone
       )
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

   Beachten Sie, dass PostgreSQL die Spaltennamen in Kleinbuchstaben umwandelt.

3. Klicken Sie auf play_circleAusführen.

   Spanner führt die Anweisung aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse die Meldung 1 Zeile eingefügt und die Daten der eingefügten Zeile angezeigt.

4. Klicken Sie im Bereich Explorer auf more_vert Aktionen ansehen für die Tabelle Singers und dann auf Daten einfügen.

5. Bearbeiten Sie die VALUES-Klausel der INSERT-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,
       FirstName,
       LastName,
       BirthDate)
   VALUES
     (2, -- type: INT64
       'Catalina', -- type: STRING(1024)
       'Smith', -- type: STRING(1024)
       NULL -- type: DATE
       )
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   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,
       firstname,
       lastname,
       birthdate)
   VALUES
     (2, -- type: bigint
       'Catalina', -- type: character varying
       'Smith', -- type: character varying
       NULL -- type: timestamp with time zone
       )
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

6. Klicken Sie auf play_circleAusführen.

   Spanner führt die Anweisung aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse die Meldung 1 Zeile eingefügt und die Daten der eingefügten Zeile angezeigt.

7. Klicken Sie im Bereich Explorer für die Tabelle Singers auf more_vert Aktionen ansehen und dann auf Datenvorschau.

8. Klicken Sie auf play_circleAusführen. Auf dem Tab Ergebnisse werden die beiden Zeilen in der Tabelle Singers angezeigt.

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

1. Klicken Sie im Bereich Explorer auf more_vert Aktionen ansehen für die Tabelle Singers und dann auf Daten einfügen.

   Spanner öffnet in Spanner Studio einen neuen Abfragetab, der die Vorlagenanweisung INSERT enthält.

2. Bearbeiten Sie die VALUES-Klausel der INSERT-Anweisung der Vorlage:

   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,
       FirstName,
       LastName,
       BirthDate)
   VALUES
     (3, -- type: INT64
       'Kena', -- type: STRING(1024)
       '', -- type: STRING(1024)
       NULL -- type: DATE
       )
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   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,
       firstname,
       lastname,
       birthdate)
   VALUES
     (3, -- type: bigint
       'Kena', -- type: character varying
       '', -- type: character varying
       NULL -- type: timestamp with time zone
       )
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

3. Klicken Sie auf play_circleAusführen.

   Spanner führt die Anweisung aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse die Meldung 1 Zeile eingefügt und die Daten der eingefügten Zeile angezeigt.

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

4. Klicken Sie im Bereich Explorer für die Tabelle Singers auf more_vert Aktionen ansehen und dann auf Datenvorschau.

5. Klicken Sie auf play_circleAusführen. Auf dem Tab Ergebnisse werden die drei Zeilen in der Tabelle Singers angezeigt. Die Zeile mit dem Primärschlüsselwert 3 enthält einen leeren String in der Spalte LastName.

Daten bearbeiten

1. Klicken Sie auf add Neuer Tab, um einen neuen Abfragetab zu erstellen, und geben Sie dann die folgende UPDATE-Anweisung ein, um das Geburtsdatum für die Zeile mit dem Primärschlüsselwert 3 zu aktualisieren:

   GoogleSQL

   UPDATE
     Singers
   SET
     BirthDate='1961-04-01'
   WHERE
     SingerId=3
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   PostgreSQL

   UPDATE
     singers
   SET
     birthdate='1961-04-01 00:00:00 -8:00'
   WHERE
     singerid=3
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

2. Klicken Sie auf play_circle Ausführen.

   Spanner führt die Anweisung aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse die Meldung 1 Zeile aktualisiert und die Daten der aktualisierten Zeile angezeigt.

3. Klicken Sie im Bereich Explorer für die Tabelle Singers auf more_vert Aktionen ansehen und dann auf Datenvorschau.

4. Klicken Sie auf play_circleAusführen. Auf dem Tab Ergebnisse werden die Zeilen in der Tabelle Singers angezeigt. Die aktualisierte Zeile enthält jetzt einen Wert für das Geburtsdatum.

Daten löschen

1. Klicken Sie auf add Neuer Tab, um einen neuen Abfragetab zu erstellen, und geben Sie dann die folgende DELETE-Anweisung ein, um die Zeile mit dem Primärschlüsselwert 2 zu löschen:

   GoogleSQL

   DELETE FROM Singers
   WHERE SingerId = 2;
   

   PostgreSQL

   DELETE FROM singers
   WHERE singerid = 2;
   

2. Klicken Sie auf play_circle Ausführen.

   Spanner führt die Anweisung aus. Wenn der Vorgang abgeschlossen ist, wird auf dem Tab Ergebnisse die Meldung 1 Zeile gelöscht angezeigt. Die Tabelle Singers enthält jetzt zwei Zeilen.

Abfrage in der Google Cloud Console ausführen

1. Klicken Sie auf add Neuer Tab, um einen neuen Abfragetab zu erstellen. Geben Sie dann die folgende Abfrage in den Abfrageeditor ein:

   GoogleSQL

   SELECT * FROM Singers;
   

   PostgreSQL

   SELECT * FROM singers;
   

2. Klicken Sie auf play_circleAusführen.

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

Glückwunsch! Sie haben eine Spanner-Datenbank erstellt und mithilfe des Abfrageeditors eine SQL-Anweisung ausgeführt.

Bereinigen

Löschen Sie die Datenbank und die Instanz, um zu vermeiden, dass Ihrem Google Cloud -Konto zusätzliche Gebühren in Rechnung gestellt werden. Durch das Deaktivieren der Cloud Billing API werden die Gebühren nicht gestoppt. Wenn Sie eine Instanz löschen, werden alle Datenbanken in der Instanz gelöscht.

Datenbank löschen

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

   Zu Spanner-Instanzen

2. Klicken Sie auf den Namen der Instanz, die die Datenbank enthält, 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. example-db.

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

5. Bestätigen Sie, dass Sie die Datenbank löschen möchten, indem Sie den Datenbanknamen eingeben und auf Löschen klicken.

Instanz löschen

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

   Zu Spanner-Instanzen

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

3. Klicken Sie auf delete 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
• Informationen zum Spanner-Schema und -Datenmodell
• 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.