Auf dieser Seite wird beschrieben, wie Sie eine Spanner-Datenbank verwalten, einschließlich Erstellen einer Datenbank, Ändern von Datenbankoptionen und Löschen einer Datenbank. Informationen zum Aktualisieren eines Datenbankschemas finden Sie unter Schemaaktualisierungen.
Im Codelab Ihre erste Datenbank können Sie üben, eine Datenbank zu erstellen und sie mit Beispieldaten zu laden.
Datenbank erstellen
Die folgenden Beispiele zeigen, wie eine Datenbank in einer vorhandenen Instanz erstellt wird.
Für GoogleSQL-Dialekt-Datenbanken können Sie das Datenbankschema entweder beim Erstellen der Datenbank oder danach definieren. Bei PostgreSQL-Dialekt-Datenbanken müssen Sie das Schema nach der Erstellung definieren.
Schemas werden mithilfe der Database Definition Language 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 der Datenbank verhindern.
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Wählen Sie die Instanz aus, in der die Datenbank erstellt werden soll.
Klicken Sie auf Create database (Datenbank erstellen).
Geben Sie die folgenden Werte ein:
- Ein Datenbankname, der in der Google Cloud Console angezeigt wird.
- Der für diese Datenbank zu verwendende Dialekt.
- Für GoogleSQL-Dialekt-Datenbanken können Sie optional eine Reihe von DDL-Anweisungen angeben, die Ihr Schema definieren. Verwenden Sie die DDL-Vorlagen, um gängige Elemente vorab auszufüllen. Wenn die DDL-Anweisungen Fehler enthalten, gibt die Google Cloud Console beim Versuch, die Datenbank zu erstellen, einen Fehler zurück.
- Wählen Sie optional einen vom Kunden verwalteten Verschlüsselungsschlüssel für diese Datenbank aus.
Klicken Sie auf Erstellen, um die Datenbank anzulegen.
gcloud
Führen Sie den Befehl gcloud spanner databases create
aus.
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 Kennung für die Datenbank. Bei Angabe der voll qualifizierten Kennung kann das Flag
--instance
weggelassen werden. --instance=INSTANCE
- Die Spanner-Instanz für die Datenbank.
Folgende Optionen sind optional:
--async
- Sie können sofort zurückkehren, ohne auf den Abschluss des Vorgangs warten zu müssen.
--database-dialect=DATABASE_DIALECT
- Der SQL-Dialekt der Spanner-Datenbank. Hier muss entweder
POSTGRESQL
oderGOOGLE_STANDARD_SQL
angegeben werden. --ddl=DDL
- Durch Semikolon getrennte DDL-Anweisungen (Data Definition Language) zur Ausführung in der neu erstellten Datenbank. Wenn eine Anweisung einen Fehler enthält, wird die Datenbank nicht erstellt. Dieses Flag wird ignoriert, wenn
--ddl_file
festgelegt ist. Wird von PostgreSQL-Dialekt-Datenbanken nicht unterstützt. --ddl-file=DDL_FILE
- -Pfad 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-Dialekt-Datenbanken nicht unterstützt.
Wenn Sie beim Erstellen der Datenbank einen Cloud Key Management Service-Schlüssel angeben, schließen Sie die folgenden Optionen ein:
--kms-key=KMS_KEY
- ID des Schlüssels oder vollständig qualifizierte ID für den Schlüssel.
Dieses Flag muss angegeben werden, wenn eines der anderen Argumente in dieser Gruppe angegeben ist. Die anderen Argumente können weggelassen werden, wenn die voll qualifizierte Kennzeichnung angegeben wird.
--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 Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Einfach loslegen (Go)
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. 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 Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. 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 Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. 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 Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. 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 Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. 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 Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Datenbankschema oder Optionen aktualisieren
Sie können das Datenbankschema und die Optionen mithilfe von 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 der Abfrageoptimierung 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 unterstützten Optionen finden Sie in der ALTER DATABASE
-DDL-Referenz für GoogleSQL oder PostgreSQL.
Informationen zu Schemaaktualisierungen finden Sie unter Schemaaktualisierungen.
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Wählen Sie die Instanz mit der zu ändernden Datenbank aus.
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 Updates zu übernehmen. Wenn die 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 Datenbankaktualisierungen an den Befehl entweder mit dem Flag --ddl
oder dem Flag --ddl-file
. Wenn eine DDL-Datei angegeben ist, wird das Flag --ddl
ignoriert.
In der DDL-Referenz ALTER DATABASE
für GoogleSQL oder PostgreSQL finden Sie die entsprechenden DDL-Anweisungen.
DDL
Weitere Informationen finden Sie in der DDL-Referenz ALTER DATABASE
für GoogleSQL oder PostgreSQL.
Fortschritt von Schemaaktualisierungsvorgängen prüfen
Console
Wählen Sie im Spanner-Navigationsmenü den Tab Vorgänge aus. Auf der Seite Vorgänge wird eine Liste der derzeit ausgeführten Vorgänge angezeigt.
Suchen Sie in der Liste nach dem Schemavorgang. Wenn er noch ausgeführt wird, zeigt die Fortschrittsanzeige in der Spalte Ende den Prozentsatz des abgeschlossenen Vorgangs an, wie in der folgenden Abbildung dargestellt:
gcloud
Mit gcloud spanner operations describe
können Sie den Fortschritt eines Vorgangs 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.
Der Abschnitt
progress
in der Ausgabe zeigt den Prozentsatz des abgeschlossenen Vorgangs an. 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.
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- 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 in etwa folgende JSON-Antwort 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 Einen lange laufenden Datenbankvorgang abbrechen.
Datenbank löschen
Durch das Löschen einer Datenbank werden die Datenbank und alle zugehörigen Daten endgültig entfernt. Das Löschen der Datenbank kann nicht rückgängig gemacht werden. Wenn der Datenbanklöschungsschutz für eine Datenbank aktiviert ist, können Sie diese Datenbank erst löschen, wenn Sie ihren Löschschutz deaktivieren.
Vorhandene Sicherungen werden nicht gelöscht, wenn eine Datenbank gelöscht wird. Weitere Informationen finden Sie unter Sichern und wiederherstellen.
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Wählen Sie die Instanz mit der zu löschenden Datenbank aus.
Wählen Sie die Datenbank aus.
Klicken Sie auf Datenbank löschen. Eine Bestätigung wird angezeigt.
Geben Sie den Datenbanknamen ein und klicken Sie auf Löschen.
gcloud
Verwenden Sie gcloud spanner databases delete
, um eine Datenbank mit dem gcloud
-Befehlszeilentool zu löschen.
gcloud spanner databases delete \ (DATABASE : --instance=INSTANCE)
Folgende Optionen sind erforderlich:
DATABASE
- ID der Datenbank oder voll qualifizierte Kennung für die Datenbank. Wenn die vollständig qualifizierte Kennung angegeben wird, 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 für das Löschen von Datenbanken.
Nächste Schritte
- Datenbank erstellen und mit Beispieldaten laden
- Weitere Informationen zur GoogleSQL-DDL-Referenz
- Weitere Informationen zur PostgreSQL-DDL-Referenz
- Datenbank sichern und wiederherstellen
- Versehentliches Löschen von Datenbanken verhindern
- Schemaaktualisierungen