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
- 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.
-
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, sehen Sie die Spanner-Seite Instanzen anstelle der Produktseite. 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, zum Beispiel Test Instance.
Klicken Sie auf der Übersichtsseite der Instanz, die geöffnet wird, auf Datenbank erstellen.
Geben Sie als Datenbanknamen einen Namen ein, z. B. example-db.
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 Datenbank angezeigt. die Sie erstellt haben.
Schema für Datenbank erstellen
Klicken Sie im Navigationsmenü auf Spanner Studio.
Klicken Sie auf der Seite Spanner Studio auf
Neuer Tab oder leeres Feld Editor-Tab.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. Wenn die Aktualisierung abgeschlossen ist, sieht so aus:
GoogleSQL
PostgreSQL
Beachten Sie, dass PostgreSQL den Tabellennamen in Kleinbuchstaben umwandelt.
Daten einfügen und ändern
Die Google Cloud Console bietet eine Schnittstelle zum Einfügen, Bearbeiten und Daten löschen.
Daten einfügen
Klicken Sie auf der Seite Übersicht in der Liste der Tabellen auf die Tabelle "singer".
In der Google Cloud Console wird die Seite Schema der Tabelle "singer" angezeigt.
Klicken Sie im Navigationsmenü auf Daten, um die Seite Daten der Tabelle "singer" 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, erscheint wieder der Tab Ergebnisse. zeigt an, dass die erste Anweisung eine Zeile eingefügt hat.
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 wieder die Tabelle Spanner Studio an. Seite mit einem neuen Abfragetab, der die gleichen
INSERT
undSELECT
enthält Aussagen.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 der Tab Ergebnisse angezeigt. zeigt an, dass die erste Anweisung eine Zeile eingefügt hat.
Klicken Sie auf den Link Tabelle. Die Tabelle
Singers
hat jetzt drei Zeilen und die Zeile mit dem Primärschlüsselwert3
enthält einen leeren String in der SpalteLastName
:GoogleSQL
PostgreSQL
Daten bearbeiten
Klicken Sie auf der Seite Daten der Tabelle "Sprache" das Kästchen in der Zeile mit dem Primärschlüsselwert
3
an und klicken Sie dann auf Bearbeiten.Spanner zeigt die Seite Spanner Studio mit einem Neuer Tab mit den Vorlagen
UPDATE
undSET
für Anweisungen, die du bearbeiten kannst 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 Sänger enthält jetzt zwei Zeilen:
GoogleSQL
PostgreSQL
Abfrage ausführen
Klicken Sie auf der Seite Übersicht der Datenbank auf Spanner Studio im Navigationsmenü auswählen.
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 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. example-db.
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. Testinstanz.
Klicken Sie auf delete Instanz löschen.
Bestätigen Sie, dass die Instanz gelöscht werden soll. Geben Sie dazu den Instanznamen ein und klicken Sie auf Löschen.
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
- Hier erfahren Sie, wie Sie Spanner mit C++, C#, Go und Java verwenden. Node.js, PHP, Python, Ruby, REST oder gcloud.