Wiederherstellung zu einem bestimmten Zeitpunkt (PITR) verwenden

Auf dieser Seite wird gezeigt, wie Sie mit der Wiederherstellung zu einem bestimmten Zeitpunkt (PITR) Ihre primäre Cloud SQL-Instanz wiederherstellen.

Weitere Informationen zur PITR finden Sie unter Wiederherstellung zu einem bestimmten Zeitpunkt (PITR).

Logspeicher für PITR

Am 31. Mai 2024 haben wir die Speicherung von Transaktionslogs für PITR in Cloud Storage eingeführt. Seit der Einführung gelten die folgenden Bedingungen:

  • Alle Cloud SQL-Instanzen, die Sie vor diesem Datum mit aktivierter PITR erstellen, speichern die Transaktionslogs, die für die PITR verwendet werden, auf dem Laufwerk.

  • Alle Cloud SQL-Instanzen, die ab diesem Datum mit aktivierter PITR erstellt werden, speichern diese Logs in Cloud Storage.

Diese Logs werden regelmäßig aktualisiert und belegen Speicherplatz. Cloud SQL löscht Transaktionsprotokolle mit den zugehörigen automatischen Sicherungen automatisch. Dies geschieht, wenn der für den Parameter transactionLogRetentionDays festgelegte Wert erreicht ist. Weitere Informationen zu diesem Parameter finden Sie unter Protokolle und Laufwerknutzung.

Bei Instanzen, die Transaktionslogs nur auf dem Laufwerk speichern, können Sie Cloud SQL so konfigurieren, dass die Logs in Cloud Storage gespeichert werden. Deaktivieren Sie dazu zuerst die Wiederherstellung zu einem bestimmten Zeitpunkt und aktivieren Sie sie dann wieder. Sie können Logs nicht von Cloud Storage zurück auf das Laufwerk verschieben.

So sorgen Sie dafür, dass Logs für Ihre Instanz in Cloud Storage statt auf dem Laufwerk gespeichert werden:

Protokolle und Laufwerksnutzung

Bei Instanzen mit Transaktionslogs in Cloud Storage werden die Logs in derselben Region wie die primäre Instanz gespeichert. Für diesen Logspeicher (bis zu 35 Tage für Cloud SQL Enterprise Plus und sieben Tage für Cloud SQL Enterprise, die maximale Länge für die Wiederherstellung zu einem bestimmten Zeitpunkt) fallen keine zusätzlichen Kosten pro Instanz an.

Cloud SQL generiert regelmäßig Transaktionsprotokolle, die Speicherplatz belegen. Cloud SQL löscht die Transaktionsprotokolle automatisch zusammen mit den zugehörigen automatischen Sicherungen. Dies geschieht, wenn der für den Parameter transactionLogRetentionDays festgelegte Wert erreicht ist. Mit diesem Parameter wird die Anzahl der Tage angegeben, für die Transaktionslogs in Cloud SQL aufbewahrt werden. Bei Cloud SQL Enterprise Plus können Sie die Anzahl der Tage für aufbewahrte Transaktionslogs zwischen 1 und 35 festlegen. Bei Cloud SQL Enterprise kann der Wert zwischen 1 und 7 festgelegt werden.

Um herauszufinden, wie viel Speicherplatz die Transaktionsprotokolle belegen, sehen Sie sich den Messwert bytes_used_by_data_type für die Instanz an. Der Wert für den Datentyp gibt die Größe der Transaktionsprotokolle auf dem Laufwerk zurück. Bei Instanzen, die Transaktionslogs speichern, die für PITR auf dem Laufwerk verwendet werden, löscht Cloud SQL Daten täglich dauerhaft vom Laufwerk, um die PITR-Einstellung transactionLogRetentionDays zu erfüllen, wie unter Automatische Sicherungsaufbewahrung beschrieben.

Wenn für Ihre Instanz die Wiederherstellung zu einem bestimmten Zeitpunkt aktiviert ist und die Größe Ihrer Transaktionslogs auf dem Laufwerk ein Problem für die Instanz verursacht:

  • Sie können die Wiederherstellung zu einem bestimmten Zeitpunkt deaktivieren und wieder aktivieren, damit Logs in Cloud Storage in derselben Region wie die Instanz gespeichert werden. Vorhandene Logs werden jedoch gelöscht, sodass Sie eine Wiederherstellung zu einem bestimmten Zeitpunkt erst wieder ab dem Zeitpunkt ausführen können, zu dem Sie die Wiederherstellung zu einem bestimmten Zeitpunkt wieder aktiviert haben.
  • Sie können die Speichergröße der Instanz erhöhen, die erhöhte Speichernutzung der Größe des Transaktionslogs könnte jedoch nur temporär sein.
  • Wir empfehlen die Aktivierung der automatischen Speichererweiterung, um unerwartete Speicherplatzprobleme zu vermeiden. Diese Empfehlung gilt nur, wenn für Ihre Instanz PITR aktiviert ist und Ihre Logs auf dem Laufwerk gespeichert sind.
  • Wenn Sie Logs löschen und Speicherplatz zurückgewinnen möchten, können Sie PITR deaktivieren, ohne es wieder zu aktivieren. Durch Reduzierung des verwendeten Speicherplatzes wird die Größe des für die Instanz bereitgestellte Laufwerks jedoch nicht verringert.

  • Die Logs werden einmal täglich, nicht kontinuierlich gelöscht. Das Festlegen der Logaufbewahrung auf zwei Tage bedeutet, dass mindestens zwei Tage an Logs und höchstens Logs von drei Tagen aufbewahrt werden. Wir empfehlen, die Anzahl der Sicherungen auf eine mehr als die Anzahl von Tagen für die Logaufbewahrung festzulegen.

    Wenn Sie beispielsweise 7 als Wert für den Parameter transactionLogRetentionDays angeben, legen Sie für den Parameter backupRetentionSettings die Anzahl der retainedBackups auf 8 fest.

Weitere Informationen zu PITR finden Sie unter Wiederherstellung zu einem bestimmten Zeitpunkt.

Datenbankwiederherstellungsmodell für die PITR

Wenn Sie die Wiederherstellung zu einem bestimmten Zeitpunkt für eine Instanz aktivieren, legt Cloud SQL das Wiederherstellungsmodell der vorhandenen und nachfolgenden Datenbanken automatisch auf das vollständige Wiederherstellungsmodell fest.

Weitere Informationen zu SQL Server-Wiederherstellungsmodellen finden Sie in der Microsoft-Dokumentation.

PITR aktivieren

Wenn Sie eine neue Instanz in der Google Cloud Console erstellen, wird die Einstellung automatisierte Back-ups automatisch aktiviert.

Mit dem folgenden Verfahren wird PITR auf einer vorhandenen primären Instanz aktiviert.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Rufen Sie das Dreipunkt-Menü Dreipunkt-Symbol der Instanz auf, für die Sie die Wiederherstellung zu einem bestimmten Zeitpunkt aktivieren möchten, und klicken Sie auf Bearbeiten.
  3. Maximieren Sie unter Instanz anpassen den Abschnitt Datenschutz.
  4. Klicken Sie auf das Kästchen Wiederherstellung zu einem bestimmten Zeitpunkt aktivieren.
  5. Geben Sie im Feld Tage für Protokolle die Anzahl der Tage ein, für die Protokolle aufbewahrt werden sollen. Geben Sie dazu eine Zahl zwischen 1 und 35 für die Cloud SQL Enterprise Plus-Version oder zwischen 1 und 7 für die Cloud SQL Enterprise-Version ein.
  6. Klicken Sie auf Speichern.

gcloud

  1. Rufen Sie die Instanzübersicht auf: 
    gcloud sql instances describe INSTANCE_NAME
  2. Wenn im Abschnitt backupConfiguration enabled: false angezeigt wird, aktivieren Sie geplante Sicherungen:
    gcloud sql instances patch INSTANCE_NAME \
--backup-start-time=HH:MM

    Dabei geben Sie den Parameter backup-start-time im 24-Stunden-Zeitformat und in der Zeitzone UTC±00 an.

  3. PITR aktivieren: 
    gcloud sql instances patch INSTANCE_NAME \
--enable-point-in-time-recovery

    Wenn Sie die Wiederherstellung zu einem bestimmten Zeitpunkt auf einer primären Instanz aktivieren, können Sie auch die Anzahl der Tage konfigurieren, für die Sie Transaktionslogs aufbewahren möchten. Fügen Sie dazu den folgenden Parameter hinzu:

    --retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS
  4. Bestätigen Sie die Änderung: 
    gcloud sql instances describe INSTANCE_NAME

    Im Abschnitt backupConfiguration wird pointInTimeRecoveryEnabled: true angezeigt, ob die Änderung erfolgreich war.

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält
  • INSTANCE_NAME: der Name der primären Instanz oder der Lesereplikatinstanz, die Sie für Hochverfügbarkeit konfigurieren
  • START_TIME: die Uhrzeit (in Stunden und Minuten)

HTTP-Methode und URL:

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

JSON-Text anfordern:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält
  • INSTANCE_NAME: der Name der primären Instanz oder der Lesereplikatinstanz, die Sie für Hochverfügbarkeit konfigurieren
  • START_TIME: die Uhrzeit (in Stunden und Minuten)

HTTP-Methode und URL:

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

JSON-Text anfordern:

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

Perform PITR

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

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

gcloud

Erstellen Sie einen Klon mithilfe der 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'

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:

Sie sollten in etwa folgende JSON-Antwort erhalten:

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:

Sie sollten in etwa folgende JSON-Antwort erhalten:

PITR deaktivieren

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Rufen Sie das Dreipunkt-Menü Dreipunkt-Symbol der Instanz auf, die Sie deaktivieren möchten, und wählen Sie Bearbeiten aus.
  3. Maximieren Sie unter Instanz anpassen den Abschnitt Datenschutz.
  4. Entfernen Sie das Häkchen von der Option Wiederherstellung zu einem bestimmten Zeitpunkt aktivieren.
  5. Klicken Sie auf Speichern.

gcloud

  1. Wiederherstellung zu einem bestimmten Zeitpunkt deaktivieren: 
    gcloud sql instances patch INSTANCE_NAME \
--no-enable-point-in-time-recovery
  2. Bestätigen Sie die Änderung: 
    gcloud sql instances describe INSTANCE_NAME

    Im Abschnitt backupConfiguration wird pointInTimeRecoveryEnabled: false angezeigt, ob die Änderung erfolgreich war.

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

Speicherort der für PITR verwendeten Transaktionslogs prüfen

Sie können prüfen, wo Ihre Cloud SQL-Instanz die Transaktionslogs speichert, die für PITR verwendet werden.

gcloud

Mit dem folgenden Befehl können Sie feststellen, ob Ihre Instanz Protokolle für PITR auf dem Laufwerk oder in Cloud Storage speichert:

   gcloud sql instances describe INSTANCE_NAME

Ersetzen Sie INSTANCE_NAME durch den Namen der Instanz.

Sie können auch den Speicherort der Transaktionsprotokolle für mehrere Instanzen im selben Projekt prüfen. Verwenden Sie den folgenden Befehl, um den Speicherort für mehrere Instanzen zu ermitteln:

   gcloud sql instances list --show-transactional-log-storage-state

Beispielantwort:

NAME  DATABASE_VERSION         LOCATION       TRANSACTIONAL_LOG_STORAGE_STATE
my_01 SQLSERVER_2019_STANDARD  us-central-1   DISK
my_02 SQLSERVER_2019_STANDARD  us-central-1   CLOUD_STORAGE
...

In der Befehlsausgabe enthält das Feld transactionalLogStorageState oder die Spalte TRANSACTIONAL_LOG_STORAGE_STATE Informationen dazu, wo die Transaktionsprotokolle für die PITR-Wiederherstellung für die Instanz gespeichert werden. Mögliche Speicherstatus für Transaktionsprotokolle:

  • DISK: Die Instanz speichert die für die PITR verwendeten Transaktionslogs auf dem Laufwerk.
  • CLOUD_STORAGE: Die Instanz speichert die für die PITR verwendeten Transaktionslogs in Cloud Storage.

Aufbewahrung von Transaktionslogs festlegen

So legen Sie die Anzahl der Tage fest, für die Transaktionslogs aufbewahrt werden sollen:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Rufen Sie das Dreipunkt-Menü Dreipunkt-Symbol der Instanz auf, für die Sie das Transaktionslog festlegen möchten, und wählen Sie Bearbeiten aus.
  3. Maximieren Sie unter Instanz anpassen den Abschnitt Datenschutz.
  4. Maximieren Sie im Abschnitt Wiederherstellung zu einem bestimmten Zeitpunkt aktivieren die Option Erweiterte Optionen.
  5. Geben Sie die Anzahl der Tage ein (von 1 bis 35 für die Cloud SQL Enterprise Plus-Version oder 1 bis 7 für die Cloud SQL Enterprise-Version).
  6. Klicken Sie auf Speichern.

gcloud

Legen Sie die Anzahl der Tage für die Aufbewahrung von Transaktionslogs für die Instanz fest.

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz, für die Sie das Transaktionslog festlegen möchten.

  • DAYS_TO_RETAIN: Die Anzahl der Tage, für die Transaktionslogs aufbewahrt werden sollen. Bei Cloud SQL Enterprise Plus liegt der gültige Bereich zwischen 1 und 35 Tagen, wobei der Standardwert 14 Tage beträgt. Bei Cloud SQL Enterprise liegt der gültige Bereich zwischen 1 und 7 Tagen, wobei der Standardwert 7 Tage beträgt.

    Wenn kein Wert angegeben ist, wird der Standardwert verwendet. Das ist nur gültig, wenn die PITR-Funktion aktiviert ist. Wenn Sie Transaktionslogs länger speichern möchten, ist mehr Speicherplatz erforderlich.

  gcloud sql instances patch INSTANCE_NAME \
    --retained-transaction-log-days=DAYS_TO_RETAIN

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Projekt-ID.
  • INSTANCE_ID: Instanz-ID.

  • DAYS_TO_RETAIN: die Anzahl der Tage, für die Transaktionslogs aufbewahrt werden sollen. Bei Cloud SQL Enterprise Plus liegt der gültige Bereich zwischen 1 und 35 Tagen, wobei der Standardwert 14 Tage beträgt. Bei Cloud SQL Enterprise liegt der gültige Bereich zwischen 1 und 7 Tagen, wobei der Standardwert 7 Tage beträgt.

    Wenn kein Wert angegeben ist, wird der Standardwert verwendet. Das ist nur gültig, wenn die PITR-Funktion aktiviert ist. Wenn Sie Transaktionslogs länger speichern möchten, ist mehr Speicherplatz erforderlich.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON-Text anfordern:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Projekt-ID.
  • INSTANCE_ID: Instanz-ID.

  • DAYS_TO_RETAIN: die Anzahl der Tage, für die Transaktionslogs aufbewahrt werden sollen. Bei Cloud SQL Enterprise Plus liegt der gültige Bereich zwischen 1 und 35 Tagen, wobei der Standardwert 14 Tage beträgt. Bei Cloud SQL Enterprise liegt der gültige Bereich zwischen 1 und 7 Tagen, wobei der Standardwert 7 Tage beträgt.

    Wenn kein Wert angegeben ist, wird der Standardwert verwendet. Das ist nur gültig, wenn die PITR-Funktion aktiviert ist. Wenn Sie Transaktionslogs länger speichern möchten, ist mehr Speicherplatz erforderlich.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON-Text anfordern:

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

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

Sie sollten in etwa folgende JSON-Antwort erhalten:

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.

Nächste Schritte