Wiederherstellung zu einem bestimmten Zeitpunkt (PITR) verwenden

Auf dieser Seite wird beschrieben, wie Sie mit der Wiederherstellung zu einem bestimmten Zeitpunkt (Point-in-Time Recovery, PITR) Daten in Cloud Firestore aufbewahren und wiederherstellen.

Weitere Informationen zu den Konzepten der Wiederherstellung zu einem bestimmten Zeitpunkt finden Sie unter Wiederherstellung zu einem bestimmten Zeitpunkt.

Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, in dem Sie die Wiederherstellung zu einem bestimmten Zeitpunkt aktivieren möchten, um die Berechtigungen zu erhalten, die Sie zum Verwalten der Einstellungen für die Wiederherstellung zu einem bestimmten Zeitpunkt benötigen:

• Cloud Datastore-Inhaber (roles/datastore.owner)

Bei benutzerdefinierten Rollen müssen die folgenden Berechtigungen gewährt werden:

• Zum Aktivieren der Wiederherstellung zu einem bestimmten Zeitpunkt beim Erstellen einer Datenbank: datastore.databases.create
• Zum Aktualisieren der Einstellungen für die Wiederherstellung zu einem bestimmten Zeitpunkt in einer vorhandenen Datenbank: datastore.databases.update,datastore.databases.list
• Zum Ausführen von Lesevorgängen aus Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden: datastore.databases.get,datastore.entities.get,datastore.entities.list
• Zum Exportieren von Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden: datastore.databases.export
• Zum Importieren von Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden: datastore.databases.import
• Zum Klonen einer Datenbank: datastore.databases.clone

Hinweis

Beachten Sie die folgenden Punkte, bevor Sie die Wiederherstellung zu einem bestimmten Zeitpunkt verwenden:

• Sie können nicht sofort nach dem Aktivieren der Wiederherstellung zu einem bestimmten Zeitpunkt mit dem Lesen von Daten beginnen, die sieben Tage zurückliegen.
• Wenn Sie die Wiederherstellung zu einem bestimmten Zeitpunkt beim Erstellen einer Datenbank aktivieren möchten, müssen Sie den Befehl gcloud firestore databases create verwenden. Das Aktivieren der Wiederherstellung zu einem bestimmten Zeitpunkt beim Erstellen einer Datenbank über die Google Cloud Console wird nicht unterstützt.
• Cloud Firestore behält Versionen ab dem Zeitpunkt bei, an dem die Wiederherstellung zu einem bestimmten Zeitpunkt aktiviert wurde.
• Nach dem Deaktivieren der Wiederherstellung zu einem bestimmten Zeitpunkt können Sie keine Daten lesen, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden.
• Wenn Sie die Wiederherstellung zu einem bestimmten Zeitpunkt sofort nach dem Deaktivieren wieder aktivieren, sind die vorherigen Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden, nicht mehr verfügbar. Alle Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden und vor dem Deaktivieren der Wiederherstellung zu einem bestimmten Zeitpunkt erstellt wurden, werden nach dem Ablaufdatum der Wiederherstellung zu einem bestimmten Zeitpunkt gelöscht.
• Wenn Sie versehentlich Daten in der letzten Stunde gelöscht haben und die Wiederherstellung zu einem bestimmten Zeitpunkt deaktiviert ist, können Sie Ihre Daten wiederherstellen, indem Sie die Wiederherstellung zu einem bestimmten Zeitpunkt innerhalb einer Stunde nach dem Löschen aktivieren.
• Alle Lesevorgänge für abgelaufene Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden, schlagen fehl.

Wiederherstellung zu einem bestimmten Zeitpunkt aktivieren

Bevor Sie die Wiederherstellung zu einem bestimmten Zeitpunkt verwenden, müssen Sie die Abrechnung für Ihr Google Cloud Projekt aktivieren. Nur Google Cloud-Projekte mit aktivierter Abrechnung können die Funktion zur Wiederherstellung zu einem bestimmten Zeitpunkt verwenden.

gcloud firestore databases create\
  --location=LOCATION\
  --database=DATABASE_ID\
  --type=firestore-native\
  --enable-pitr

gcloud firestore databases update\
  --database=DATABASE_ID\
  --no-enable-pitr

Aufbewahrungsdauer und Zeitstempel der ältesten Version abrufen

gcloud firestore databases describe --database=DATABASE_ID

    appEngineIntegrationMode: ENABLED
    concurrencyMode: PESSIMISTIC
    createTime: '2021-03-24T17:02:35.234Z'
    deleteProtectionState: DELETE_PROTECTION_DISABLED
    earliestVersionTime: '2023-06-12T16:17:25.222474Z'
    etag: IIDayqOevv8CMNTvyNK4uv8C
    keyPrefix: s
    locationId: nam5
    name: projects/PROJECT_ID/databases/DATABASE_ID
    pointInTimeRecoveryEnablement: POINT_IN_TIME_RECOVERY_DISABLED
    type: FIRESTORE_NATIVE
    uid: 5230c382-dcd2-468f-8cb3-2a1acfde2b32
    updateTime: '2021-11-17T17:48:22.171180Z'
    versionRetentionPeriod: 3600s

Daten lesen, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden

  Firestore firestore = …

  TransactionOptions options =
          TransactionOptions.createReadOnlyOptionsBuilder()
              .setReadTime(
                  com.google.protobuf.Timestamp.newBuilder()
                      .setSeconds(1684098540L)
                      .setNanos(0))
              .build();

  ApiFuture<Void> futureTransaction = firestore.runTransaction(
              transaction -> {
                // Does a snapshot read document lookup
                final DocumentSnapshot documentResult =
                    transaction.get(documentReference).get();

                // Executes a snapshot read query
                final QuerySnapshot queryResult =
                  transaction.get(query).get();
              },
              options);

  // Blocks on transaction to complete
  futureTransaction.get();

const documentSnapshot = await firestore.runTransaction(
    updateFunction => updateFunction.get(documentRef),
    {readOnly: true, readTime: new Firestore.Timestamp(1684098540, 0)}
);

const querySnapshot = await firestore.runTransaction(
    updateFunction => updateFunction.get(query),
    {readOnly: true, readTime: new Firestore.Timestamp(1684098540, 0)}
);

  Instant readTime = Instant.ofEpochSecond(1684098540L);

  PCollection<Document> documents =
      pipeline
          .apply(Create.of(collectionId))
          .apply(
              new FilterDocumentsQuery(
                  firestoreOptions.getProjectId(), firestoreOptions.getDatabaseId()))
          .apply(FirestoreIO.v1().read().runQuery().withReadTime(readTime).withRpcQosOptions(rpcQosOptions).build())
  ...

Aus einer Datenbank klonen

Sie können eine vorhandene Datenbank zu einem ausgewählten Zeitstempel in eine neue Datenbank klonen:

• Die geklonte Datenbank ist eine neue Datenbank, die am selben Standort wie die Quelldatenbank erstellt wird.

  Zum Erstellen eines Klons verwendet Cloud Firestore Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden, aus der Quelldatenbank. Die geklonte Datenbank enthält alle Daten und Indexe.

• Standardmäßig wird die geklonte Datenbank auf dieselbe Weise wie die Quelldatenbank verschlüsselt, entweder mit der Standardverschlüsselung von Google oder mit der CMEK-Verschlüsselung. Sie können einen anderen Verschlüsselungstyp angeben oder einen anderen Schlüssel für die CMEK-Verschlüsselung verwenden.

• Der Zeitstempel hat eine Genauigkeit von einer Minute und gibt einen Zeitpunkt in der Vergangenheit an, im Zeitraum, der durch das Fenster für die Wiederherstellung zu einem bestimmten Zeitpunktdefiniert wird:

  • Wenn die Wiederherstellung zu einem bestimmten Zeitpunkt für Ihre Datenbank aktiviert ist, können Sie eine beliebige Minute in den letzten sieben Tagen auswählen (oder weniger, wenn die Wiederherstellung zu einem bestimmten Zeitpunkt vor weniger als sieben Tagen aktiviert wurde).
  • Wenn die Wiederherstellung zu einem bestimmten Zeitpunkt nicht aktiviert ist, können Sie eine beliebige Minute in der letzten Stunde auswählen.
  • Sie können den frühesten Zeitstempel, den Sie auswählen können in der Beschreibung Ihrer Datenbank prüfen.

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--tags=key1=value1,key2=value2

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

firebase firestore:databases:clone \
'projects/example-project/databases/(default)' \
'projects/example-project/databases/example-dest-db' \
--snapshot-time 'PITR_TIMESTAMP' \
--encryption-type CUSTOMER_MANAGED_ENCRYPTION

Beschränkungen

Bei einem Klonvorgang werden keine App Engine Suchdaten oder Blob-Entitäten aus einer (default) Datenbank geklont. Diese Daten sind nur für die (default)-Datenbank gültig und sind nicht nützlich, wenn Sie von (default) in eine Datenbank klonen, die solche Daten nicht unterstützt. Daher werden sie aus Klonen ausgeschlossen.

Aus Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden, exportieren und importieren

Sie können Ihre Datenbank aus Daten, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden, nach Cloud Storage exportieren mit dem Befehl gcloud firestore export. Sie können Daten exportieren, die mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurden, wobei der Zeitstempel ein Zeitstempel mit Minutengenauigkeit innerhalb der letzten sieben Tage sein muss, aber nicht früher als earliestVersionTime. Wenn zum angegebenen Zeitstempel keine Daten mehr vorhanden sind, schlägt der Exportvorgang fehl.

Der Exportvorgang für die Wiederherstellung zu einem bestimmten Zeitpunkt unterstützt alle Filter, einschließlich des Exports aller Dokumente und des Exports bestimmter Sammlungen.

1. Exportieren Sie die Datenbank und geben Sie für den Parameter snapshot-time den ausgewählten Wiederherstellungszeitstempel an.

   gcloud

   Führen Sie den folgenden Befehl aus, um die Datenbank in Ihren Bucket zu exportieren.

   gcloud firestore export gs://BUCKET_NAME_PATH \
       --snapshot-time=PITR_TIMESTAMP \
       --collection-ids=COLLECTION_IDS \
       --namespace-ids=NAMESPACE_IDS
   

   Dabei gilt:

   • BUCKET_NAME_PATH - ein gültiger Cloud Storage Bucket mit einem optionalen Pfadpräfix, in dem Exportdateien gespeichert werden.
   • PITR_TIMESTAMP – ein Zeitstempel für die Wiederherstellung zu einem bestimmten Zeitpunkt mit einer Genauigkeit von einer Minute, z. B. 2023-05-26T10:20:00.00Z oder 2023-10-19T10:30:00.00-07:00.
   • COLLECTION_IDS - eine Liste von Sammlungs-IDs oder Sammlungsgruppen-IDs, z. B. 'specific-collection-group1','specific-collection-group2'.
   • NAMESPACE_IDS - eine Liste von Namespace-IDs, z. B. 'customer','orders'.

   Beachten Sie die folgenden Punkte, bevor Sie PITR-Daten exportieren:

   • Geben Sie den Zeitstempel im RFC 3339 Format an. Beispiel: 2023-05-26T10:20:00.00Z oder 2023-10-19T10:30:00.00-07:00.
   • Achten Sie darauf, dass der von Ihnen angegebene Zeitstempel ein Zeitstempel mit Minutengenauigkeit innerhalb der letzten sieben Tage ist, aber nicht früher als earliestVersionTime. Wenn zum angegebenen Zeitstempel keine Daten mehr vorhanden sind, wird ein Fehler generiert. Der Zeitstempel muss eine ganze Minute sein, auch wenn die angegebene Zeit innerhalb der letzten Stunde liegt.
   • Für einen fehlgeschlagenen Export, der mit der Wiederherstellung zu einem bestimmten Zeitpunkt wiederhergestellt wurde, werden keine Gebühren erhoben.

2. In eine Datenbank importieren.

   Folgen Sie der Anleitung unter Alle Dokumente importieren, um Ihre exportierte Datenbank zu importieren. Wenn in Ihrer Datenbank bereits Dokumente vorhanden sind, werden sie überschrieben.