Daten sichern und wiederherstellen

Auf dieser Seite wird beschrieben, wie Sie die Funktion für geplante Sicherungen von Cloud Firestore verwenden. Mit Sicherungen schützen Sie Ihre Daten vor Datenbeschädigung auf Anwendungsebene oder vor versehentlichem Löschen von Daten.

Mit Sicherungen können Sie Zeitpläne für die tägliche oder wöchentliche Sicherung der angegebenen Datenbank konfigurieren. Sie können diese Sicherungen dann verwenden, um Daten in einer neuen Datenbank wiederherzustellen.

Informationen zu Sicherungen

Eine Sicherung ist eine konsistente Kopie der Datenbank zu einem bestimmten Zeitpunkt. Die Sicherung enthält alle Daten und Indexkonfigurationen zu diesem Zeitpunkt. Eine Sicherung enthält keine Datenbank-Gültigkeitsdauer-Richtlinien. Eine Sicherung befindet sich am selben Speicherort wie die Quelldatenbank.

Sicherungen haben eine konfigurierbare Aufbewahrungsdauer und werden gespeichert, bis diese abgelaufen ist oder Sie die Sicherung löschen. Wenn Sie die Quelldatenbank löschen, werden die zugehörigen Sicherungen nicht automatisch gelöscht.

Cloud Firestore speichert Metadaten zu Sicherungen und Sicherungsplänen, die sich auf eine Datenbank beziehen. Cloud Firestore behält diese Metadaten so lange bei, bis alle Sicherungen für die Datenbank ablaufen oder gelöscht werden.

Das Erstellen oder Aufbewahren von Sicherungen wirkt sich nicht auf die Leistung von Lese- oder Schreibvorgängen in Ihrer Live-Datenbank aus.

Kosten

Bei der Nutzung von Back-ups wird Ihnen Folgendes in Rechnung gestellt:

• Der von jeder Sicherung verwendete Speicherplatz.
• Für eine Wiederherstellung wird Ihnen der Speicherplatz in Rechnung gestellt, der durch die Sicherung belegt wird.

Weitere Einzelheiten und die genauen Preise finden Sie auf der Seite Preise.

Hinweis

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen eine oder mehrere der folgenden Rollen für die Identitäts- und Zugriffsverwaltung zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Sicherungen und Sicherungszeitplänen benötigen:

• roles/datastore.owner: Vollständiger Zugriff auf die Cloud Firestore-Datenbank

• Die folgenden Rollen sind ebenfalls verfügbar, aber nicht in der Google Cloud Console sichtbar. Verwenden Sie die Google Cloud CLI, um diese Rollen zuzuweisen:

  • roles/datastore.backupsAdmin: Lese- und Schreibzugriff auf Sicherungen
  • roles/datastore.backupsViewer: Lesezugriff auf Sicherungen
  • roles/datastore.backupSchedulesAdmin: Lese- und Schreibzugriff auf Sicherungszeitpläne
  • roles/datastore.backupSchedulesViewer: Lesezugriff auf Sicherungszeitpläne
  • roles/datastore.restoreAdmin: Berechtigungen zum Starten von Wiederherstellungsvorgängen

Sicherungszeitpläne erstellen und verwalten

In den folgenden Beispielen wird gezeigt, wie Sie einen Sicherungszeitplan einrichten. Für jede Datenbank können Sie einen täglichen und einen wöchentlichen Sicherungszeitplan konfigurieren. Sie können nicht mehrere Zeitpläne für wöchentliche Sicherungen für verschiedene Wochentage konfigurieren.

Sie können die genaue Uhrzeit der Sicherung nicht konfigurieren. Die Sicherungen werden jeden Tag zu unterschiedlichen Zeiten erstellt. Bei wöchentlichen Sicherungsplänen können Sie den Wochentag für die Erstellung einer Sicherung konfigurieren.

Sicherungszeitplan erstellen

Verwenden Sie den Befehl gcloud firestore backups schedules create oder firebase firestore:databases:backups:schedules, um einen Sicherungszeitplan für eine Datenbank zu erstellen.

Täglichen Sicherungszeitplan erstellen

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

Wochenplan für Sicherungen erstellen

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY

resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

Sicherungszeitpläne auflisten

Verwenden Sie eine der folgenden Methoden, um alle Sicherungszeitpläne für eine Datenbank aufzulisten:

gcloud firestore backups schedules list \
--database='DATABASE_ID'

firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'

Zeitplan für die Sicherung beschreiben

Sie haben folgende Möglichkeiten, Informationen zu einem Sicherungszeitplan abzurufen:

gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Zeitplan für die Sicherung aktualisieren

So aktualisieren Sie die Aufbewahrungsdauer eines Sicherungszeitplans:

gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD

firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD

Sie können die Aufbewahrungsdauer eines Sicherungszeitplans aktualisieren, aber nicht die Wiederholung. Wenn Sie einen Sicherungszeitplan mit einer anderen Wiederholung benötigen, löschen Sie den alten Sicherungszeitplan, wenn er nicht mehr erforderlich ist, und erstellen Sie einen neuen Sicherungszeitplan mit der gewünschten Wiederholung.

Sicherungszeitplan löschen

Sie haben folgende Möglichkeiten, einen Sicherungszeitplan zu löschen:

gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

Durch das Löschen eines Sicherungszeitplans werden keine Sicherungen gelöscht, die bereits durch diesen Zeitplan erstellt wurden. Sie können warten, bis sie nach Ablauf der Aufbewahrungsdauer ablaufen, oder eine Sicherung manuell löschen. Weitere Informationen finden Sie unter Sicherung löschen.

Sicherungen verwalten

Sicherungen auflisten

Sie haben folgende Möglichkeiten, verfügbare Sicherungen aufzulisten:

gcloud firestore backups list \
--format="table(name, database, state)"

gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"

firebase firestore:backups:list

firebase firestore:backups:list \
--location=LOCATION

Sicherung beschreiben

Sie haben folgende Möglichkeiten, Details zu einer Sicherung aufzurufen:

gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

firebase firestore:backups:get BACKUP

Sicherung löschen

gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

firebase firestore:backups:delete \
BACKUP

Daten aus einer Datenbanksicherung wiederherstellen

Bei einem Wiederherstellungsvorgang werden die Daten aus einer Sicherung in eine neue Cloud Firestore-Datenbank geschrieben.

Verwenden Sie eine der folgenden Methoden, um einen Wiederherstellungsvorgang zu starten:

gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'

metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...

gcloud firestore operations list --database=DATABASE_ID

gcloud firestore operations describe OPERATION_NAME

firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'