Auf dieser Seite wird beschrieben, wie Sie den Lebenszyklus eines Spanners verwalten
Vorgang mit langer Ausführungszeit mit gcloud spanner operations
-Befehlen und den
Operations REST API. Einige Verfahren können auch in der Google Cloud Console durchgeführt werden.
Lange laufende Vorgänge sind Methodenaufrufe, die viel Zeit in Anspruch nehmen können. Spanner erstellt Vorgänge mit langer Ausführungszeit für mehrere Instanz-, Datenbank- und Sicherungsaktionen. Ein Beispiel ist die Methode,
eine Datenbank wiederherzustellen,
projects.instances.databases.restore
Wenn Sie eine Datenbank wiederherstellen, erstellt der Spanner-Dienst einen Vorgang mit langer Ausführungszeit, um den Wiederherstellungsfortschritt zu verfolgen. Wenn der Vorgang
länger als erwartet ist, können Sie mit gcloud
den Fortschritt
. Wenn der Vorgang nicht reagiert, können Sie mit gcloud
den Vorgang abbrechen.
.
Spanner bietet Vorgangs-APIs, mit denen sich der Fortschritt von lange laufenden Vorgängen prüfen lässt. Sie können lange laufende Vorgänge auch auflisten und abbrechen sowie lange laufende Instanzvorgänge löschen.
Sie können lang andauernde Vorgänge so prüfen und verwalten:
- Spanner-Clientbibliotheken
gcloud
-Befehlszeilentool- Die Google Cloud Console
REST API-Befehle für die Betriebsverwaltung
Verwalten Sie lang andauernde Spanner-Vorgänge mit den folgenden REST-Methoden:
Aktion | Lange laufende Datenbankvorgänge | Lange laufende Instanzvorgänge |
---|---|---|
Lange laufenden Vorgang abbrechen | cancel |
cancel |
Lange laufenden Vorgang löschen | Nicht unterstützt | delete |
Fortschritt eines lang andauernden Vorgangs prüfen | get |
get |
Lange laufende Vorgänge auflisten | list |
list |
Informationen zur Verwendung von REST mit Spanner finden Sie unter Erste Schritte mit Spanner mit REST
Instanzvorgänge
Diese lang laufenden Instanzvorgänge gibt es:
Fortschritt eines lange laufenden Instanzvorgangs prüfen
projects.instances.operations.get
verwenden
um den Fortschritt eines lange laufenden Instanzvorgangs zu überprüfen.
Eine Antwort von projects.instances.create
kann beispielsweise so aussehen:
{
"name": "projects/test01/instances/test-instance/operations/_auto_1492721321097206",
"metadata": {
"@type": "type.googleapis.com/google.spanner.admin.instance.v1.CreateInstanceMetadata",
"instance": {
"name": "projects/<VAR>PROJECT-ID</VAR>/instances/test-instance",
"config": "projects/<VAR>PROJECT-ID</VAR>/instanceConfigs/regional-us-central1",
"displayName": "Test Instance",
"nodeCount": 1,
"state": "READY"
},
"startTime": "2017-04-24T22:45:41.130854Z"
}
}
Der Wert name
am Anfang der Antwort gibt an, dass der Spanner-Dienst einen lange laufenden Instanzvorgang namens projects/test01/instances/test-instance/operations/_auto_1492721321097206
erstellt hat.
So prüfen Sie den Fortschritt des lange laufenden Instanzvorgangs:
- Rufen Sie
projects.instances.operations.get
auf. Geben Sie unter Name den Namen des lange laufenden Instanzvorgangs ein, so wie er in der Antwort auf
projects.instances.create
oderprojects.instances.patch
zurückgegeben wurde. Beispiel:projects/PROJECT-ID/instances/INSTANCE-NAME/operations/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Instanzvorgangsnamen abrufen, indem Sie lange laufende Instanzvorgänge auflisten.
Klicken Sie auf Ausführen. Wenn ein Vorgang abgeschlossen ist, wird im Feld
done
der Werttrue
angezeigt.
Rufen Sie zum Abrufen kontinuierlicher Updates wiederholt die Methode
projects.instances.databases.operations.get
, bis der Vorgang
fertig. Verwenden Sie einen Backoff zwischen den einzelnen Anfragen. Stellen Sie beispielsweise alle 10 Sekunden eine Anfrage.
Lange laufende Instanzvorgänge auflisten
Mit projects.instances.operations.list
können Sie lange laufende Instanzvorgänge auflisten.
- Rufen Sie
projects.instances.operations.list
auf. Geben Sie unter Name Folgendes ein:
projects/PROJECT-ID/instances/INSTANCE-NAME/operationsOPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Klicken Sie auf Ausführen. Die Antwort enthält eine Liste lang andauernder Vorgänge.
Lange laufenden Instanzvorgang abbrechen
Mit projects.instances.operations.cancel
können Sie einen lange laufenden Instanzvorgang abbrechen.
- Rufen Sie
projects.instances.operations.cancel
auf. Geben Sie unter Name den Namen des lange laufenden Instanzvorgangs ein, der in der Antwort des lange laufenden Instanzvorgangs angezeigt wird.
projects/PROJECT-ID/instances/INSTANCE-NAME/operations/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Instanzvorgangsnamen auch abrufen, indem Sie lange laufende Instanzvorgänge auflisten.
Klicken Sie auf Ausführen.
Lange laufenden Instanzvorgang löschen
projects.instances.operations.delete
verwenden
um einen lange laufenden Instanzvorgang zu löschen.
- Klicken Sie auf
projects.instances.operations.delete
. Geben Sie unter Name den Namen des lange laufenden Instanzvorgangs ein, der in der Antwort des lange laufenden Instanzvorgangs angezeigt wird.
projects/<VAR>PROJECT-ID</VAR>/instances/<VAR>INSTANCE-NAME</VAR>/operations/<VAR>OPERATION-ID</VAR>
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Instanzvorgangsnamen auch über das Auflisten lange laufender Instanzvorgänge abrufen.
Gehen Sie zu Execute (Ausführen). Der Vorgang wird gelöscht.
Datenbankvorgänge
Diese lange laufenden Datenbankvorgänge gibt es:
projects.instances.databases.create
projects.instances.databases.restore
projects.instances.databases.updateDdl
projects.instances.databaseOperations.list
Fortschritt eines lang laufenden Datenbankvorgangs prüfen
projects.instances.databases.operations.get
verwenden
um den Fortschritt eines lange laufenden Datenbankvorgangs zu überprüfen.
Hier sehen Sie eine Antwort von
projects.instances.databases.create
:
{
"name": "projects/test01/instances/test-instance/databases/example-db/operations/_auto_1492721321097206",
"metadata": {
"@type": "type.googleapis.com/google.spanner.admin.database.v1.CreateDatabaseMetadata",
"database": "projects/test01/instances/test-instance/databases/example-db"
}
}
Der Wert name
am Anfang der Antwort zeigt an, dass der Spanner-
hat der Dienst einen lange laufenden Datenbankvorgang namens
projects/test01/instances/test-instance/databases/example-db/operations/_auto_1492721321097206
.
So prüfen Sie den Fortschritt eines lang andauernden Datenbankvorgangs:
Rufen Sie
projects.instances.databases.operations.get
auf.Geben Sie unter Name den Namen des lange laufenden Datenbankvorgangs ein, so wie er in der Antwort auf
projects.instances.databases.create
oderprojects.instances.databases.updateDdl
zurückgegeben wurde.projects/PROJECT-ID/instances/INSTANCE-NAME/databases/example-db/operations/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Namen des Datenbankvorgangs auch abrufen, indem Sie lange laufende Datenbankvorgänge auflisten.
Klicken Sie auf Ausführen. Wenn ein Vorgang abgeschlossen ist, wird im Feld
done
der Werttrue
angezeigt.
Wenn Sie kontinuierliche Updates erhalten möchten, rufen Sie die Methode projects.instances.databases.operations.get
so oft auf, bis der Vorgang abgeschlossen ist. Verwenden Sie einen Backoff zwischen den einzelnen Anfragen. Beispiel: Eine Anfrage alle zehn
Sekunden.
Lange laufende Datenbankvorgänge auflisten
Mit projects.instances.databases.operations.list
können Sie lange laufende Datenbankvorgänge auflisten.
- Gehen Sie zu
projects.instances.databases.operations.list
. Geben Sie unter Name Folgendes ein:
projects/PROJECT-ID/instances/INSTANCE-NAME/databases/example-db/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Klicken Sie auf Ausführen. Die Antwort enthält eine Liste der Vorgänge mit langer Ausführungszeit.
Lange laufenden Datenbankvorgang abbrechen
projects.instances.databases.operations.cancel
verwenden
einen lange laufenden Datenbankvorgang abbrechen.
- Gehen Sie zu
projects.instances.databases.operations.cancel
. Geben Sie unter Name den Namen des lange laufenden Datenbankvorgangs ein, der in der Antwort des lange laufenden Datenbankvorgangs angezeigt wird.
projects/PROJECT-ID/instances/INSTANCE-NAME/databases/example-db/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Namen des Datenbankvorgangs auch abrufen, indem Sie lange laufende Datenbankvorgänge auflisten.
Klicken Sie auf Ausführen.
Schemaaktualisierungsvorgänge
Im Folgenden finden Sie einige lang andauernde Schemaaktualisierungsvorgänge.
Fortschritt eines langwierigen Schemaaktualisierungsvorgangs prüfen
Console
Wählen Sie im Spanner-Navigationsmenü den Tab Vorgänge aus. Die Auf der Seite Vorgänge wird eine Liste der laufenden 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
gcloud spanner operations describe
verwenden
um den Fortschritt eines Vorgangs zu überprü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: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name der Instanz.
- DATABASE-NAME: der Name 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 gewünschten Vorgangs um dies zu überprüfen.
- INSTANCE-NAME: Der Name der Spanner-Instanz.
- DATABASE-NAME: den Namen 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: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name der Datenbank
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 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 Lang andauernden Schemaaktualisierungsvorgang abbrechen.
Lang andauernde Schemaaktualisierungsvorgänge auflisten
gcloud
gcloud spanner operations list \ --instance=INSTANCE-NAME \ --database=DATABASE-NAME \ --type=DATABASE_UPDATE_DDL
Ersetzen Sie Folgendes:
- INSTANCE-NAME: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name der Datenbank.
Die Ausgabe sieht dann ungefähr so aus:
OPERATION-ID STATEMENTS DONE @TYPE
_auto_op_123456 CREATE INDEX SingersByFirstLastName ON Singers(FirstName, LastName) False UpdateDatabaseDdlMetadata
_auto_op_234567 CREATE INDEX SongsBySingerAlbumSongName ON Songs(SingerId, AlbumId, SongName), INTERLEAVE IN Albums True CreateDatabaseMetadata
Lang andauernden Schemaaktualisierungsvorgang abbrechen
gcloud
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: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name der Datenbank
Mit
gcloud spanner operations cancel
können Sie einen lange laufenden Schemaaktualisierungsvorgang abbrechen.gcloud spanner operations cancel OPERATION-ID \ --instance=INSTANCE-NAME
Ersetzen Sie Folgendes:
- OPERATION-ID: die Vorgangs-ID des gewünschten Vorgangs um dies zu überprüfen.
- INSTANCE-NAME: Der Name der Spanner-Instanz.
REST Version 1
projects.instances.databases.operations.cancel
verwenden
um eine lange andauernde Schemaaktualisierung abzubrechen.
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: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name der Datenbank.
Rufen Sie
projects.instances.databases.operations.cancel
auf.Geben Sie unter Name den Namen des lange laufenden Schemaaktualisierungsvorgangs so ein: wie in der Antwort des lange laufenden Schemaaktualisierungsvorgangs dargestellt.
projects/PROJECT-ID/instances/INSTANCE-NAME/databases/example-db/operations/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Namen des Schemaaktualisierungsvorgangs auch über das Auflisten lange laufender Instanzvorgänge abrufen.
Klicken Sie auf Ausführen. Der Vorgang wird beendet.
Sicherungs- und Wiederherstellungsvorgänge
Die folgenden Sicherungsvorgänge haben eine lange Ausführungszeit.
Fortschritt eines lange laufenden Sicherungs- oder Wiederherstellungsvorgangs prüfen
Console
Sicherung
Wählen Sie im Spanner-Navigationsmenü den Tab Vorgänge aus. Die Auf der Seite Vorgänge wird eine Liste der derzeit ausgeführten 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:
Wiederherstellen
Den Fortschritt des Wiederherstellungsvorgangs können Sie anhand der Fortschrittsanzeige prüfen, die während der Wiederherstellung angezeigt wird (siehe Abbildung unten).
Wenn der Vorgang zu lange dauert, können Sie ihn abbrechen. Weitere Informationen finden Sie unter Lang andauernden Instanzvorgang abbrechen
gcloud
gcloud spanner operations describe
verwenden
um den Fortschritt eines Sicherungs- oder Wiederherstellungsvorgangs zu überprü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: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name 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: den Namen 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: der Name der Spanner-Instanz.
- DATABASE-NAME: der Name der Datenbank
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 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 Lang andauernden Sicherungsvorgang abbrechen
Lang andauernde Sicherungs- oder Wiederherstellungsvorgänge auflisten
projects.instances.backups.operations.list
verwenden
zum Auflisten der Vorgänge für eine einzelne Sicherung oder projects.instances.backupOperations.list
um alle Sicherungsvorgänge in der Instanz aufzulisten.
Gehen Sie zu
projects.instances.backups.operations.list
.Geben Sie unter Name Folgendes ein:
projects/PROJECT-ID/instances/INSTANCE-NAME/backups/BACKUP-NAME/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- BACKUP-NAME: der Name der Sicherung.
- OPERATION-ID: die Vorgangs-ID.
Klicken Sie auf Ausführen. Die Antwort enthält eine Liste lang andauernder Vorgänge.
Sicherungsvorgang mit langer Ausführungszeit abbrechen
Verwenden Sie projects.instances.backups.operations.cancel
, um einen Sicherungsvorgang mit langer Ausführungszeit abzubrechen.
Gehen Sie zu
projects.instances.backups.operations.cancel
.Geben Sie in name den Namen des Sicherungsvorgangs mit langer Ausführungszeit ein, wie er in der Antwort des Sicherungsvorgangs mit langer Ausführungszeit angezeigt wird.
projects/PROJECT-ID/instances/INSTANCE-NAME/backups/BACKUP-NAME/operations/OPERATION-ID
Ersetzen Sie Folgendes:
- PROJECT-ID: Projekt-ID.
- INSTANCE-NAME: der Name der Instanz.
- BACKUP-NAME: der Name der Sicherung.
- OPERATION-ID: die Vorgangs-ID.
Sie können den Namen des Sicherungsvorgangs auch abrufen, indem Sie Sicherungsvorgänge mit langer Ausführungszeit auflisten.
Klicken Sie auf Ausführen.