Auf dieser Seite wird beschrieben, wie Sie Spanner-Datenbanken verwalten, z. B. wie Sie eine Datenbank erstellen, Datenbankoptionen ändern und eine Datenbank löschen. Diese Seite enthält Informationen zu Datenbanken mit GoogleSQL- und PostgreSQL-Dialekt. Weitere Informationen zum Aktualisieren eines Datenbankschemas finden Sie unter Schemaaktualisierungen vornehmen.
Im Codelab zur Spanner-Datenbank können Sie üben, eine Datenbank zu erstellen und mit Beispieldaten zu laden.
Datenbank erstellen
In den folgenden Beispielen wird gezeigt, wie Sie eine Datenbank in einer vorhandenen Instanz erstellen.
Bei Datenbanken mit GoogleSQL-Dialekt können Sie das Datenbankschema entweder beim Erstellen der Datenbank oder danach definieren. Bei Datenbanken mit PostgreSQL-Dialekt müssen Sie das Schema nach der Erstellung definieren.
Schemas werden mit der Datenbankdefinitionssprache definiert, die für GoogleSQL und PostgreSQL dokumentiert ist. Weitere Informationen zum Erstellen und Aktualisieren von Schemas finden Sie unter den folgenden Links:
Nachdem Sie die Datenbank erstellt haben, können Sie Datenbanken, die für Ihre Anwendungen und Dienste wichtig sind, schützen, indem Sie den Löschschutz für Datenbanken aktivieren. Weitere Informationen finden Sie unter Versehentliches Löschen von Datenbanken verhindern.
Google Cloud Console
Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.
Wählen Sie die Instanz aus, in der die Datenbank erstellt werden soll.
Klicken Sie auf Datenbank erstellen.
Geben Sie die folgenden Werte ein:
- Einen Datenbanknamen, der in der Google Cloud Console angezeigt werden soll.
- Der Dialekt, der für diese Datenbank verwendet werden soll.
- Geben Sie für Datenbanken mit GoogleSQL-Dialekt optional eine Reihe von DDL-Anweisungen an, die Ihr Schema definieren. Verwenden Sie die DDL-Vorlagen, um häufig verwendete Elemente vorab auszufüllen. Wenn Ihre DDL-Anweisungen Fehler enthalten, gibt die Google Cloud Console beim Versuch, die Datenbank zu erstellen, einen Fehler zurück.
- Optional können Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel für diese Datenbank auswählen.
Klicken Sie auf Erstellen, um die Datenbank zu erstellen.
gcloud
Führen Sie den Befehl gcloud spanner databases create
aus.
```sh
gcloud spanner databases create DATABASE \
--instance=INSTANCE \
[--async] \
[--database-dialect=DATABASE_DIALECT] \
[--ddl=DDL] \
[--ddl-file=DDL_FILE] \
[--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \
[GCLOUD_WIDE_FLAG …]
```
Folgende Optionen sind erforderlich:
DATABASE
- ID der Datenbank oder voll qualifizierte Kennzeichnung für die Datenbank. Wenn Sie die vollständig qualifizierte Kennung angeben, kann das Flag
--instance
weggelassen werden. --instance=INSTANCE
- Die Spanner-Instanz für die Datenbank.
Folgende Optionen sind optional:
--async
- wird sofort zurückgegeben, ohne auf den Abschluss des Vorgangs zu warten.
--database-dialect=DATABASE_DIALECT
- Der SQL-Dialekt der Spanner-Datenbank. Muss
POSTGRESQL
oderGOOGLE_STANDARD_SQL
sein. --ddl=DDL
- Durch Semikolon getrennte DDL-Anweisungen (Data Definition Language), die in der neu erstellten Datenbank ausgeführt werden sollen. Wenn in einer Anweisung ein Fehler auftritt, wird die Datenbank nicht erstellt. Dieses Flag wird ignoriert, wenn
--ddl_file
festgelegt ist. Wird von PostgreSQL-Datenbanken nicht unterstützt. --ddl-file=DDL_FILE
- Pfad zu einer Datei, die durch Semikolons getrennte DDL-Anweisungen (Data Definition Language) enthält, die in der neu erstellten Datenbank ausgeführt werden sollen. Wenn eine Anweisung einen Fehler enthält, wird die Datenbank nicht erstellt. Wenn
--ddl_file
festgelegt ist, wird--ddl
ignoriert. Wird von PostgreSQL-Datenbanken nicht unterstützt.
Wenn Sie einen Cloud Key Management Service-Schlüssel angeben, der beim Erstellen der Datenbank verwendet werden soll, geben Sie die folgenden Optionen an:
--kms-key=KMS_KEY
- ID des Schlüssels oder die voll qualifizierte Kennzeichnung für den Schlüssel.
Dieses Flag muss angegeben werden, wenn eines der anderen Argumente in dieser Gruppe angegeben wird. Die anderen Argumente können weggelassen werden, wenn die voll qualifizierte Kennzeichnung angegeben ist.
--kms-keyring=KMS_KEYRING
- Cloud KMS-Schlüsselbund-ID des Schlüssels.
--kms-location=KMS_LOCATION
- Google Cloud Speicherort für den Schlüssel.
--kms-project=KMS_PROJECT
- Google Cloud-Projekt-ID für den Schlüssel.
Client (GoogleSQL)
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Spanner Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Datenbankschema oder ‑optionen aktualisieren
Sie können das Datenbankschema und die Datenbankoptionen mit DDL-Anweisungen aktualisieren.
Wenn Sie beispielsweise einer Tabelle eine Spalte hinzufügen möchten, verwenden Sie die folgende DDL-Anweisung:
GoogleSQL
ALTER TABLE Songwriters ADD COLUMN Publisher STRING(10);
PostgreSQL
ALTER TABLE Songwriters ADD COLUMN Publisher VARCHAR(10);
Verwenden Sie die folgende DDL-Anweisung, um die Version des Abfrageoptimierungstools zu aktualisieren:
GoogleSQL
ALTER DATABASE Music SET OPTIONS(optimizer_version=null);
PostgreSQL
ALTER DATABASE DB-NAME SET spanner.optimizer_version TO DEFAULT;
Weitere Informationen zu den unterstützten Optionen finden Sie in der ALTER DATABASE
-DDL-Referenz für GoogleSQL oder PostgreSQL.
Informationen zu Schemaaktualisierungen finden Sie unter Schemaaktualisierungen vornehmen.
Google Cloud Console
Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.
Wählen Sie die Instanz aus, die die zu ändernde Datenbank enthält.
Wählen Sie die Datenbank aus.
Klicken Sie auf Spanner Studio.
Klicken Sie auf
Neuer Tab oder verwenden Sie den leeren Editor-Tab. Geben Sie dann die anzuwendenden DDL-Anweisungen ein.Klicken Sie auf Ausführen, um die Änderungen zu übernehmen. Wenn Ihre DDL Fehler enthält, gibt die Google Cloud Console einen Fehler zurück und die Datenbank wird nicht geändert.
gcloud
Verwenden Sie gcloud spanner databases ddl update
, um eine Datenbank mit dem gcloud
-Befehlszeilentool zu ändern.
gcloud spanner databases ddl update \ (DATABASE : --instance=INSTANCE) \ [--async] \ [--ddl=DDL] \ [--ddl-file=DDL_FILE] \
Weitere Informationen zu den verfügbaren Optionen finden Sie in der Referenz zu gcloud
.
Übergeben Sie die Datenbankupdates mit dem Flag --ddl
oder --ddl-file
an den Befehl. Wenn eine DDL-Datei angegeben wird, wird das Flag --ddl
ignoriert.
Informationen zu den einzufügenden DDL-Anweisungen finden Sie in der ALTER DATABASE
DDL-Referenz für GoogleSQL oder PostgreSQL.
DDL
Weitere Informationen finden Sie in der ALTER DATABASE
-DDL-Referenz für GoogleSQL oder PostgreSQL.
Fortschritt der Schemaaktualisierungsvorgänge prüfen
Google Cloud Console
Wählen Sie im Navigationsmenü von Spanner den Tab Vorgänge aus. Auf der Seite Vorgänge wird eine Liste der aktiven Vorgänge angezeigt.
Suchen Sie in der Liste nach dem Schemavorgang. Wenn der Vorgang noch läuft, zeigt die Fortschrittsanzeige in der Spalte Endzeit den Prozentsatz des abgeschlossenen Vorgangs an, wie in der folgenden Abbildung dargestellt:
gcloud
Verwenden Sie gcloud spanner operations describe
, um den Fortschritt eines Vorgangs zu prüfen.
Rufen Sie die Vorgangs-ID ab:
gcloud spanner operations list --instance=INSTANCE-NAME \ --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
Ersetzen Sie Folgendes:
- INSTANCE-NAME durch den Namen der Spanner-Instanz.
- DATABASE-NAME durch den Namen der Datenbank.
Führen Sie
gcloud spanner operations describe
aus.gcloud spanner operations describe OPERATION_ID\ --instance=INSTANCE-NAME \ --database=DATABASE-NAME
Ersetzen Sie Folgendes:
- OPERATION-ID: Die Vorgangs-ID des Vorgangs, den Sie prüfen möchten.
- INSTANCE-NAME: Der Name der Spanner-Instanz.
- DATABASE-NAME: Der Name der Spanner-Datenbank.
Im Abschnitt
progress
wird in der Ausgabe der Prozentsatz des abgeschlossenen Vorgangs angezeigt. Die Ausgabe sieht dann ungefähr so aus:done: true metadata: ... progress: - endTime: '2022-03-01T00:28:06.691403Z' progressPercent: 100 startTime: '2022-03-01T00:28:04.221401Z' - endTime: '2022-03-01T00:28:17.624588Z' startTime: '2022-03-01T00:28:06.691403Z' progressPercent: 100 ...
REST Version 1
Rufen Sie die Vorgangs-ID ab:
gcloud spanner operations list --instance=INSTANCE-NAME \ --database=DATABASE-NAME --type=DATABASE_UPDATE_DDL
Ersetzen Sie Folgendes:
- INSTANCE-NAME durch den Namen der Spanner-Instanz.
- DATABASE-NAME durch den Datenbanknamen.
Prüfen Sie den Fortschritt des Vorgangs.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT-ID: Projekt-ID.
- INSTANCE-ID: Instanz-ID.
- DATABASE-ID: die Datenbank-ID.
- OPERATION-ID: die Vorgangs-ID.
HTTP-Methode und URL:
GET https://spanner.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID/databases/DATABASE-ID/operations/OPERATION-ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ ... "progress": [ { "progressPercent": 100, "startTime": "2023-05-27T00:52:27.366688Z", "endTime": "2023-05-27T00:52:30.184845Z" }, { "progressPercent": 100, "startTime": "2023-05-27T00:52:30.184845Z", "endTime": "2023-05-27T00:52:40.750959Z" } ], ... "done": true, "response": { "@type": "type.googleapis.com/google.protobuf.Empty" } }
Wenn der Vorgang zu lange dauert, können Sie ihn abbrechen. Weitere Informationen finden Sie unter Lang andauernde Datenbankvorgänge abbrechen.
Datenbank löschen
Durch das Löschen einer Datenbank werden die Datenbank und alle zugehörigen Daten endgültig entfernt. Das Löschen einer Datenbank kann nicht rückgängig gemacht werden. Wenn der Löschschutz für Datenbanken für eine Datenbank aktiviert ist, können Sie diese erst löschen, wenn Sie den Löschschutz deaktivieren.
Vorhandene Sicherungen werden nicht gelöscht, wenn eine Datenbank gelöscht wird. Weitere Informationen finden Sie unter Sichern und Wiederherstellen.
Google Cloud Console
Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.
Wählen Sie die Instanz aus, die die zu löschende Datenbank enthält.
Wählen Sie die Datenbank aus.
Klicken Sie auf Datenbank löschen. Eine Bestätigung wird angezeigt.
Geben Sie den Namen der Datenbank ein und klicken Sie auf Löschen.
gcloud
Verwenden Sie gcloud spanner databases delete
, um mit dem gcloud
-Befehlszeilentool eine Datenbank zu löschen.
gcloud spanner databases delete \ (DATABASE : --instance=INSTANCE)
Folgende Optionen sind erforderlich:
DATABASE
- ID der Datenbank oder die voll qualifizierte Kennzeichnung für die Datenbank. Wenn die voll qualifizierte Kennung angegeben ist, sollte das Flag
--instance
weggelassen werden. --instance=INSTANCE
- Die Spanner-Instanz für die Datenbank.
Weitere Informationen finden Sie in der Referenz zu gcloud
.
DDL
DDL unterstützt keine Syntax zum Löschen von Datenbanken.
Nächste Schritte
- Erstellen Sie eine Datenbank und laden Sie sie mit Beispieldaten.
- Weitere Informationen zur GoogleSQL-DDL-Referenz
- Weitere Informationen zur PostgreSQL-DDL-Referenz
- Informationen zum Sichern und Wiederherstellen einer Datenbank
- Informationen zum Verhindern des versehentlichen Löschens von Datenbanken
- Weitere Informationen zum Aktualisieren von Schemas