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.
Hinweise
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
- Optional: Die Spanner API sollte automatisch aktiviert werden. Falls nicht, aktivieren Sie sie manuell: Spanner API aktivieren
-
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.
Rufen Sie in der Google Cloud Console die Seite Spanner auf.
Wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.
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.
Geben Sie auf der Seite Instanz benennen einen Instanznamen ein, z. B. Testinstanz.
Die Instanz-ID wird automatisch basierend auf dem Instanznamen eingegeben, z. B. test-instance. Ändern Sie ihn bei Bedarf. Klicken Sie auf Weiter.
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.
Klicken Sie auf Weiter.
Wählen Sie auf der Seite Rechenkapazität zuweisen die Option Verarbeitungseinheiten aus. und den Standardwert von 1.000 Verarbeitungseinheiten beibehalten.
Klicken Sie auf Erstellen.
In der Google Cloud Console wird die Seite Übersicht für die Instanz angezeigt. die Sie erstellt haben.
Datenbank erstellen
Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.
Klicken Sie auf die von Ihnen erstellte Instanz, z. B. Test Instance.
Klicken Sie auf der Übersichtsseite der Instanz, die geöffnet wird, auf Datenbank erstellen.
Geben Sie für den Datenbanknamen einen Namen wie beispieldatenbank ein.
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:
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
Klicken Sie im Navigationsmenü auf Spanner Studio.
Klicken Sie auf der Seite Spanner Studio auf
Neuer Tab oder verwenden Sie den leeren Editortab.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 );
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
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.
Klicken Sie im Navigationsmenü auf Daten, um die Seite Daten der Tabelle „Sänger“ aufzurufen.
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
undSELECT
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.
Bearbeiten Sie die
VALUES
-Klausel derINSERT
-Anweisung und dieWHERE
-Klausel derSELECT
-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;
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.
Klicken Sie im Tab Ergebnisse auf den Link Tabelle. Die Tabelle "Mirrors" enthält jetzt eine Zeile:
GoogleSQL
PostgreSQL
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
undSELECT
enthält Aussagen.Bearbeiten Sie die
VALUES
-Klausel derINSERT
-Anweisung und dieWHERE
-Klausel derSELECT
-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;
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.
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.
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
- undSELECT
-Anweisungen enthält.Bearbeiten Sie die Vorlage mit der
VALUES
-Klausel derINSERT
-Anweisung und derWHERE
-Klausel derSELECT
-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, keinNULL
-Wert.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.
Klicken Sie auf den Link Tabelle. Die Tabelle
Singers
enthält jetzt drei Zeilen und die Zeile mit dem Primärschlüsselwert3
hat in der SpalteLastName
einen leeren String:GoogleSQL
PostgreSQL
Daten bearbeiten
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
- undSET
-Anweisungen der Vorlage enthält. DieWHERE
-Klauseln beider Anweisungen geben an, dass die zu aktualisierende Zeile die Zeile mit dem Primärschlüsselwert3
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';
Bearbeiten Sie die
SET
-Klausel derUPDATE
-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';
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.
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
- 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. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.
Die Tabelle „Singers“ enthält jetzt zwei Zeilen:
GoogleSQL
PostgreSQL
Abfrage ausführen
Klicken Sie auf der Seite Übersicht der Datenbank im Navigationsmenü auf Spanner Studio.
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;
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
Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.
Klicken Sie auf den Namen der Instanz mit der Datenbank, die Sie löschen möchten, z. B. Testinstanz.
Klicken Sie auf den Namen der Datenbank, die Sie löschen möchten, z. B. beispieldatenbank.
Klicken Sie auf der Seite Datenbankdetails auf delete Datenbank löschen.
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
Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.
Klicken Sie auf den Namen der Instanz, die Sie löschen möchten, z. B. Test Instanz.
Klicken Sie auf delete Instanz löschen.
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.