Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Wiederherstellung zu einem bestimmten Zeitpunkt ausführen

MySQL | PostgreSQL | SQL Server

Mit der Wiederherstellung zu einem bestimmten Zeitpunkt (Point-In-Time-Recovery, PITR) können Sie Ihre primären Cloud SQL-Instanzen wiederherstellen, unabhängig davon, ob die Instanz aktiv oder gelöscht ist. Mit der Wiederherstellung zu einem bestimmten Zeitpunkt können Sie die Instanz auf einen bestimmten Stand zurücksetzen. Bei einer Wiederherstellung zu einem bestimmten Zeitpunkt wird immer eine neue Instanz erstellt. Eine solche Wiederherstellung kann nicht in einer vorhandenen Instanz durchgeführt werden.

Cloud SQL bietet die folgenden Optionen zum Wiederherstellen Ihrer Instanz mithilfe der Wiederherstellung zu einem bestimmten Zeitpunkt:

PITR für eine Live-Instanz ausführen
PITR mit dem Backup Vault ausführen

PITR für eine gelöschte Instanz ausführen

Wenn Sie eine PITR für eine nicht verfügbare oder gelöschte Instanz durchführen möchten, müssen Sie die neueste und früheste Wiederherstellungszeit ermitteln.

Wiederherstellung zu einem bestimmten Zeitpunkt durchführen

Console

Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Rufen Sie das Dreipunkt-Menü der Instanz auf, die Sie wiederherstellen möchten, und klicken Sie auf Klon erstellen.
Optional können Sie auf der Seite Klon erstellen die ID des neuen Klon aktualisieren.
Wählen Sie Von einem früheren Zeitpunkt klonen aus.
Geben Sie die Uhrzeit für die Wiederherstellung auf einen bestimmten Zeitpunkt ein.
Wählen Sie Alle Datenbanken aus oder geben Sie einen Datenbanknamen an.
Wenn Sie einen Datenbanknamen angeben, darf nur einer ausgewählt werden. Standardmäßig gilt die PITR für alle Datenbanken.
Klicken Sie auf Klon erstellen.

gcloud

Erstellen Sie einen Klon mithilfe von PITR.

Ersetzen Sie Folgendes:

SOURCE_INSTANCE_NAME: der Name der Instanz, von der aus Sie wiederherstellen möchten.
NEW_INSTANCE_NAME: der Name für den Klon.
TIMESTAMP: die UTC-Zeitzone für die Quellinstanz im Format RFC 3339. Beispiel: 2012-11-15T16:19:00.094Z.

gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time 'TIMESTAMP'

Hinweis: Standardmäßig gilt die Wiederherstellung zu einem bestimmten Zeitpunkt für alle Datenbanken. Optional können Sie bis zu einen bestimmten Datenbanknamen angeben: --database_names 'DATABASE'

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
target-instance-id: die ID der Zielinstanz
source-instance-id: die ID der Quellinstanz
restore-timestamp der Zeitpunkt, zu dem wiederhergestellt werden soll

In der JSON-Anfrage können Sie optional bis zu einem bestimmten Datenbanknamen so angeben: "databaseNames": "my-database"

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

JSON-Text anfordern:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
target-instance-id: die ID der Zielinstanz
source-instance-id: die ID der Quellinstanz
restore-timestamp der Zeitpunkt, zu dem wiederhergestellt werden soll

In der JSON-Anfrage können Sie optional bis zu einem bestimmten Datenbanknamen so angeben: "databaseNames": "my-database"

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

JSON-Text anfordern:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

PITR mit dem Backup Vault ausführen

Wenn Ihre Cloud SQL-Instanz für die Verwendung von erweiterten Sicherungen aktiviert ist, können Sie für Ihre Instanz eine Wiederherstellung zu einem bestimmten Zeitpunkt mithilfe des Backup Vaults durchführen.

Console

Rufen Sie in der Google Cloud Console die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Rufen Sie das Aktionsmenü der Instanz auf, die Sie wiederherstellen möchten, und klicken Sie auf Klon erstellen.
Wählen Sie Von einem früheren Zeitpunkt klonen aus.
Geben Sie die Uhrzeit für die Wiederherstellung auf einen bestimmten Zeitpunkt ein.
Klicken Sie auf Klon erstellen.

gcloud

Wenn Sie eine PITR für eine Instanz aus dem Backup Vault ausführen möchten, müssen Sie die data-source für die Sicherung finden, die dem Zeitpunkt am nächsten ist, zu dem Sie die PITR ausführen möchten. Informationen zum Suchen der Sicherung finden Sie unter Alle Sicherungen im Backup Vault für eine Instanz auflisten. Führen Sie den folgenden Befehl aus, um die PITR durchzuführen, nachdem Sie die Sicherung identifiziert haben:

gcloud sql instances point-in-time-restore DATA_SOURCE \
    TARGET_INSTANCE_NAME \
    'PITR_TIMESTAMP' \
    --project=TARGET_PROJECT \
    --region=REGION

Ersetzen Sie Folgendes:

DATA_SOURCE: der Pfad des data-source für die Quellinstanz, der dem Zeitstempel für die Wiederherstellung zu einem bestimmten Zeitpunkt am nächsten ist, zu dem Sie die Wiederherstellung durchführen möchten.
TARGET_INSTANCE_NAME: der Name der neuen Instanz, die durch den PITR-Vorgang erstellt wird.
PITR_TIMESTAMP: der UTC-Zeitstempel für das PITR-Log der Quellinstanz, auf das Sie Ihre Instanz wiederherstellen möchten, im Format RFC 3339. Beispiel: 2025-11-15T16:19:00.094Z.
TARGET_PROJECT: die Projekt-ID für die neue Instanz.
REGION: die Region der Zielinstanz. Dieses Feld ist erforderlich, wenn sich die Datenquelle der Quellinstanz in einer Multiregion oder in einer anderen Region als die Quellinstanz befindet. Die Region der Zielinstanz muss mit der Region der Quellinstanz übereinstimmen.

REST Version 1

Wenn Sie eine Wiederherstellung zu einem bestimmten Zeitpunkt mit einer Datenquelle aus dem Backup Vault durchführen möchten, verwenden Sie die Methode instances.pointInTimeRestore mit einer POST-Anfrage.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die ID des Projekts, in dem Sie die neue Instanz erstellen möchten.
DATASOURCE: die Backup- und DR-Datenquelle, die der Dienst für die Wiederherstellung zu einem bestimmten Zeitpunkt verwenden soll.
PITR_TIMESTAMP: der UTC-Zeitstempel für das PITR-Log der Quellinstanz, auf das Sie Ihre Instanz wiederherstellen möchten, im RFC 3339-Format. Beispiel: 2012-11-15T16:19:00.094Z.
TARGET_INSTANCE_NAME: der Name der Instanz, die durch den PITR-Vorgang erstellt wurde.
REGION: die Region der Zielinstanz. Dieses Feld ist erforderlich, wenn sich die Datenquelle der Quellinstanz in einer Multiregion befindet. Die Region der Zielinstanz muss mit der Region der Quellinstanz übereinstimmen.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore

JSON-Text anfordern:

{
  "datasource": "DATASOURCE",
  "pointInTime": "PITR_TIMESTAMP",
  "targetInstanceName": "TARGET_INSTANCE_NAME",
  "region": "REGION"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die ID des Projekts, in dem Sie die neue Instanz erstellen möchten.
DATASOURCE: die Backup- und DR-Datenquelle, die der Dienst für die Wiederherstellung zu einem bestimmten Zeitpunkt verwenden soll.
PITR_TIMESTAMP: der UTC-Zeitstempel für das PITR-Log der Quellinstanz, auf das Sie Ihre Instanz wiederherstellen möchten, im RFC 3339-Format. Beispiel: 2012-11-15T16:19:00.094Z.
TARGET_INSTANCE_NAME: der Name der Instanz, die durch den PITR-Vorgang erstellt wurde.
REGION: die Region der Zielinstanz. Dieses Feld ist erforderlich, wenn sich die Datenquelle der Quellinstanz in einer Multiregion befindet. Die Region der Zielinstanz muss mit der Region der Quellinstanz übereinstimmen.

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore

JSON-Text anfordern:

{
  "datasource": "DATASOURCE",
  "pointInTime": "PITR_TIMESTAMP",
  "targetInstanceName": "TARGET_INSTANCE_NAME",
  "region": "REGION"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Projektübergreifende Wiederherstellung zu einem bestimmten Zeitpunkt durchführen

Mit erweiterten Sicherungen können Sie eine Cloud SQL-Instanz in einem anderen Projekt als dem wiederherstellen, in dem sich die Quellinstanz oder der Backup Vault befindet.

Die projektübergreifende PITR wird nur über die gcloud CLI und REST APIs unterstützt.

Führen Sie einen der folgenden Schritte aus, um eine projektübergreifende Wiederherstellung zu einem bestimmten Zeitpunkt durchzuführen:

Wenn Sie die gcloud CLI verwenden, legen Sie das Flag --project auf das Projekt fest, in dem Sie die Zielinstanz erstellen möchten.
Wenn Sie REST APIs verwenden, legen Sie das Feld PROJECT_ID auf das Projekt fest, in dem Sie die Zielinstanz erstellen möchten.

PITR für eine gelöschte Instanz ausführen

Wenn Sie eine gelöschte Instanz mithilfe der Wiederherstellung zu einem bestimmten Zeitpunkt wiederherstellen möchten, benötigen Sie Folgendes:

den PITR-Zeitstempel (timestamp), auf den Sie Ihre Instanz wiederherstellen möchten
der Name der Zielinstanz
den Zeitpunkt, zu dem die Quellinstanz gelöscht wurde (source-instance-deletion-time)

Sie können die Wiederherstellung zu einem bestimmten Zeitpunkt für eine gelöschte Instanz nur mit der gcloud CLI oder der Cloud SQL API verwenden. Weitere Informationen finden Sie unter Gelöschte Instanz mithilfe einer PITR wiederherstellen.

gcloud

Standardsicherung

Zeitfenster für die Wiederherstellung zu einem bestimmten Zeitpunkt ermitteln

Wenn Sie das PITR-Fenster der gelöschten Instanz ermitteln möchten, rufen Sie die früheste und späteste Wiederherstellungszeit für die Instanz ab. Sie können in diesem Fenster einen beliebigen Zeitstempel auswählen, um eine PITR auszuführen.

Löschen der Quellinstanz finden

Die source-instance-deletion-time und log-retention-days für die gelöschte Instanz werden nach dem Löschen zusammen mit den aufbewahrten Sicherungen für Ihre Instanz gespeichert. Eine Liste aller verfügbaren Sicherungen für Ihre gelöschte Instanz finden Sie unter Aufbewahrte Sicherungen auflisten.

Wenn Sie die gewünschte Sicherung gefunden haben, rufen Sie mit dem Befehl gcloud sql backups describe die source-instance-deletion-time ab.

Mit PITR wiederherstellen

Führen Sie den folgenden Befehl aus, um die gelöschte Instanz mithilfe einer PITR wiederherzustellen:

gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time='PITR_TIMESTAMP' \
--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIMESTAMP

Ersetzen Sie Folgendes:

SOURCE_INSTANCE_NAME: der Name der Quellinstanz, die Sie wiederherstellen möchten.
NEW_INSTANCE_NAME: der Name der neuen Instanz.
PITR_TIMESTAMP: der UTC-Zeitstempel für das PITR-Log der Quellinstanz, auf das Sie Ihre Instanz wiederherstellen möchten, im Format RFC 3339. Beispiel: 2012-11-15T16:19:00.094Z.
SOURCE_INSTANCE_DELETION_TIMESTAMP: der UTC-Zeitstempel für den Zeitpunkt, zu dem die Quellinstanz gelöscht wurde, im RFC 3339-Format. Beispiel: 2012-11-15T16:19:00.094Z.

Erweiterte Sicherung

Zeitfenster für die Wiederherstellung zu einem bestimmten Zeitpunkt ermitteln

Datenquelle suchen

Die Datenquelle für die gelöschte Instanz wird nach dem Löschen zusammen mit den aufbewahrten Sicherungen für Ihre Instanz gespeichert. Informationen zum Ermitteln dieser Werte für Ihre gelöschte Instanz finden Sie unter Alle Sicherungen im Backup Vault für Ihre Instanz auflisten.

Mit PITR wiederherstellen

Führen Sie den folgenden Befehl aus, um die gelöschte Instanz mithilfe einer PITR wiederherzustellen:

gcloud sql instances point-in-time-restore DATA_SOURCE \
    TARGET_INSTANCE_NAME \
    'PITR_TIMESTAMP' \
    --project=TARGET_PROJECT \
    --region=REGION

Ersetzen Sie Folgendes:

DATA_SOURCE: der Pfad der data-source für die Sicherung, die dem PITR-Zeitstempel am nächsten ist, zu dem Sie die Wiederherstellung durchführen möchten.
TARGET_INSTANCE_NAME: der Name der neuen Instanz, die durch den PITR-Vorgang erstellt wird.
PITR_TIMESTAMP: der UTC-Zeitstempel für das PITR-Log der Quellinstanz, auf das Sie Ihre Instanz wiederherstellen möchten, im Format RFC 3339. Beispiel: 2025-11-15T16:19:00.094Z.
TARGET_PROJECT: die Projekt-ID für die neue Instanz.
REGION: die Region der Zielinstanz. Dieses Feld ist erforderlich, wenn sich die Datenquelle der Quellinstanz in einer Multiregion befindet. Die Region der Zielinstanz muss mit der Region der Quellinstanz übereinstimmen.

REST Version 1

Zeitfenster für die Wiederherstellung zu einem bestimmten Zeitpunkt ermitteln

Löschzeitpunkt der Quellinstanz und Logaufbewahrung in Tagen ermitteln

Die source-instance-deletion-time und log-retention-days für die gelöschte Instanz werden nach dem Löschen zusammen mit den aufbewahrten Sicherungen für Ihre Instanz gespeichert. Informationen zum Ermitteln dieser Werte für Ihre gelöschte Instanz finden Sie unter Aufbewahrte Sicherungen auflisten.

Mit PITR wiederherstellen

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
target-instance-id: die ID der Zielinstanz
source-instance-id: die ID der Quellinstanz
source-instance-deletion-time: der Löschzeitpunkt der Quellinstanz
restore-timestamp der Zeitpunkt, zu dem Sie die Instanz wiederherstellen möchten

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

JSON-Text anfordern:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "sourceInstanceDeletionTime: "source-instance-deletion-time",
    "pointInTime": "restore-timestamp"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Zeitfenster für die Wiederherstellung zu einem bestimmten Zeitpunkt ermitteln

Löschzeitpunkt der Quellinstanz und Logaufbewahrung in Tagen ermitteln

Die source-instance-deletion-time und log-retention-days für die gelöschte Instanz werden nach dem Löschen zusammen mit den aufbewahrten Sicherungen für Ihre Instanz gespeichert. Informationen zum Ermitteln dieser Werte für Ihre gelöschte Instanz finden Sie unter Aufbewahrte Sicherungen auflisten.

Mit PITR wiederherstellen

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
target-instance-id: die ID der Zielinstanz
source-instance-id: die ID der Quellinstanz
source-instance-deletion-time: der Löschzeitpunkt der Quellinstanz
restore-timestamp der Zeitpunkt, zu dem Sie die Instanz wiederherstellen möchten

In der JSON-Anfrage können Sie optional bis zu einem bestimmten Datenbanknamen so angeben: "databaseNames": "my-database"

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

JSON-Text anfordern:

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "sourceInstanceDeletionTime: "source-instance-deletion-time",
    "pointInTime": "restore-timestamp"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Frühesten und spätesten Wiederherstellungszeitpunkt abrufen

Für eine verfügbare Instanz können Sie eine PITR für einen beliebigen Zeitstempel im PITR-Fenster der Instanz durchführen. Das PITR-Fenster beginnt mit der frühesten Wiederherstellungszeit und endet mit der spätesten Wiederherstellungszeit. Wenn die Instanz nicht verfügbar ist und die Instanzlogs in Cloud Storage gespeichert sind oder die Instanz gelöscht wurde und die PITR-Aufbewahrung aktiviert war, können Sie die früheste und späteste Wiederherstellungszeit abrufen und die PITR für einen beliebigen Zeitstempel in diesem Fenster ausführen. In allen Fällen können Sie die Instanz in einer anderen primären oder sekundären Zone wiederherstellen. Dazu geben Sie Werte für die bevorzugten Zonen an.

gcloud

Nicht verfügbare Instanz

Führen Sie den folgenden Befehl aus, um den frühesten und spätesten Zeitpunkt abzurufen, zu dem Sie eine nicht verfügbare Cloud SQL-Instanz wiederherstellen können:

gcloud sql instances get-latest-recovery-time INSTANCE_NAME

Ersetzen Sie Folgendes:

INSTANCE_NAME: der Name der Instanz, für die Sie den neuesten Wiederherstellungszeitpunkt ermitteln möchten.

Gelöschte Instanz

Führen Sie den folgenden Befehl aus, um den frühesten und spätesten Zeitpunkt abzurufen, zu dem Sie eine gelöschte Cloud SQL-Instanz wiederherstellen können:

gcloud sql instances get-latest-recovery-time INSTANCE_NAME \
    --source-instance-deletion-time='SOURCE_INSTANCE_DELETION_TIMESTAMP'

Ersetzen Sie Folgendes:

INSTANCE_NAME: der Name der Instanz, für die Sie den neuesten Wiederherstellungszeitpunkt ermitteln möchten.
SOURCE_INSTANCE_DELETION_TIMESTAMP: der UTC-Zeitstempel für den Zeitpunkt, zu dem die Quellinstanz gelöscht wurde, im RFC 3339-Format. Beispiel: 2012-11-15T16:19:00.094Z.

REST Version 1

Nicht verfügbare Instanz

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die Projekt-ID
INSTANCE_NAME: der Name der Instanz, für die Sie den neuesten Wiederherstellungszeitpunkt abfragen

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

Gelöschte Instanz

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die Projekt-ID
INSTANCE_NAME: der Name der Quellinstanz, für die Sie den neuesten Wiederherstellungszeitpunkt abfragen
SOURCE_INSTANCE_DELETION_TIME: der Zeitpunkt, zu dem die Quellinstanz gelöscht wurde

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

REST v1beta4

Nicht verfügbare Instanz

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die Projekt-ID
INSTANCE_NAME: der Name der Instanz, für die Sie den neuesten Wiederherstellungszeitpunkt abfragen

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

Gelöschte Instanz

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die Projekt-ID
INSTANCE_NAME: der Name der Quellinstanz, für die Sie den neuesten Wiederherstellungszeitpunkt abfragen
SOURCE_INSTANCE_DELETION_TIME: der Zeitpunkt, zu dem die Quellinstanz gelöscht wurde

HTTP-Methode und URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#getLatestRecoveryTime",
  "earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

Fehlerbehebung

Problem Fehlerbehebung

Problem	Fehlerbehebung
`argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z` ODER `Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,`	Der von Ihnen angegebene Zeitstempel ist ungültig.
`HTTP Error 400: Successful backup required for carrying out the operation was not found.` ODER `Successful backup required for carrying out the operation was not found. or Time where no backups can be found.`	Der angegebene Zeitstempel gilt für einen Zeitpunkt, an dem keine Sicherungen oder binlog-Koordinaten gefunden wurden.

argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z

ODER

Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,

Der von Ihnen angegebene Zeitstempel ist ungültig.

HTTP Error 400: Successful backup required for carrying out the operation was not found.

ODER

Successful backup required for carrying out the operation was not found. or Time where no backups can be found.

Der angegebene Zeitstempel gilt für einen Zeitpunkt, an dem keine Sicherungen oder binlog-Koordinaten gefunden wurden.

Nächste Schritte

Flags für Ihren Klon konfigurieren

Wiederherstellung zu einem bestimmten Zeitpunkt ausführen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Wiederherstellung zu einem bestimmten Zeitpunkt durchführen

Console

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

PITR mit dem Backup Vault ausführen

Console

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

Projektübergreifende Wiederherstellung zu einem bestimmten Zeitpunkt durchführen

PITR für eine gelöschte Instanz ausführen

gcloud

Standardsicherung

Erweiterte Sicherung

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

Frühesten und spätesten Wiederherstellungszeitpunkt abrufen

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Fehlerbehebung

Nächste Schritte

Wiederherstellung zu einem bestimmten Zeitpunkt ausführen