Daten im Bulk löschen

Mit dem verwalteten Bulk-Löschdienst können Sie Daten aus Ihrer Datenbank löschen. Diese Funktion unterstützt das Löschen aus einer oder mehreren Sammlungsgruppen.

Auf dieser Seite wird beschrieben, wie Sie Dokumente mit dem verwalteten Bulk-Löschdienst im Bulk löschen. Der Firebase verwaltete Bulk-Löschdienst ist über das gcloud Befehlszeilentool und die Cloud Firestore REST API verfügbar.

Hinweis

Bevor Sie den verwalteten Bulk-Löschdienst verwenden können, müssen Sie die folgenden Schritte ausführen:

  1. Abrechnung für Ihr Google Cloud Projekt aktivieren. Die Bulk-Löschfunktion kann nur für Google Cloud Projekte mit aktivierter Abrechnung verwendet werden.

  2. Achten Sie darauf, dass Ihr Konto die erforderlichen Berechtigungen für Firebase hat. Wenn Sie der Projektinhaber sind, enthält Ihr Konto bereits die notwendigen Berechtigungen. Andernfalls gewähren die folgenden Rollen die erforderlichen Berechtigungen für Bulk-Löschvorgänge:

    • Firebase Rollen: Owner, Cloud Datastore Owner oder Cloud Datastore Bulk Admin

gcloud für das Projekt einrichten

Sie können Bulk-Löschvorgänge über die Google Cloud Console oder das gcloud-Befehlszeilentool initiieren. Richten Sie das Befehlszeilentool ein, um gcloud zu verwenden, und stellen Sie mit einer der folgenden Methoden eine Verbindung zu Ihrem Projekt her:

Daten im Bulk löschen

Bei einem Bulk-Löschvorgang werden zuerst alle relevanten Dokumente in Ihrer Datenbank gesucht und dann in Batches gelöscht. Sie können diese Dokumente weiterhin abfragen oder lesen. Die Ergebnisse können jedoch je nach Fortschritt variieren. Beim Bulk-Löschen werden keine Dokumente gelöscht, die nach dem Start des Vorgangs hinzugefügt oder geändert wurden.

Bestimmte Sammlungsgruppen im Bulk löschen

gcloud

Verwenden Sie das --collection-ids Flag, um bestimmte Sammlungsgruppen im Bulk zu löschen. Bei dem Vorgang werden nur die Sammlungsgruppen mit den angegebenen IDs gelöscht. 

gcloud firestore bulk-delete \
--collection-ids=[COLLECTION_GROUP_ID_1_OR_KIND_1],[COLLECTION_GROUP_ID_2_OR_KIND_2],[SUBCOLLECTION_GROUP_ID_1_OR_KIND_3] \
--database=[DATABASE]

Bulk-Löschvorgänge verwalten

Nachdem Sie einen Bulk-Löschvorgang gestartet haben, weist Firebase dem Vorgang einen eindeutigen Namen zu. Sie können mit diesem Namen den Vorgang löschen, abbrechen oder seinen Status prüfen.

Vorgangsnamen haben das Präfix projects/[PROJECT_ID]/databases/[DATABASE_ID]/operations/, zum Beispiel:

projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

Wenn Sie für die Befehle describe, cancel und delete einen Vorgangsnamen angeben, können Sie das Präfix weglassen.

Alle Bulk-Löschvorgänge auflisten

gcloud

Verwenden Sie den operations list-Befehl, um alle laufenden und kürzlich abgeschlossenen Vorgänge einschließlich Bulk-Löschvorgänge aufzurufen:

gcloud firestore operations list

Vorgangsstatus prüfen

gcloud

Verwenden Sie den operations describe Befehl, um den Status eines Bulk-Löschvorgangs anzuzeigen.

gcloud firestore operations describe [OPERATION_NAME]

Fertigstellungszeit schätzen

Eine Anfrage für den Status eines Vorgangs mit langer Ausführungszeit liefert die Messwerte workEstimated und workCompleted. Beide Messwerte werden als Anzahl der Byte und als Anzahl der Dokumente zurückgegeben:

  • workEstimated weist die geschätzte Gesamtzahl der Byte und Dokumente aus, die ein Vorgang verarbeitet. Firebase lässt diesen Messwert möglicherweise weg, wenn keine Schätzung möglich ist.

  • workCompleted weist die Anzahl der bisher gelöschten Byte und Dokumente aus. Nachdem der Vorgang abgeschlossen ist, zeigt der Wert die Gesamtanzahl der tatsächlich verarbeiteten Byte und Dokumente an, die möglicherweise größer als der Wert von workEstimated ist.

Teilen Sie workCompleted durch workEstimated, um eine grobe Schätzung des Fortschritts zu erhalten. Diese Schätzung ist möglicherweise ungenau, da sie von der verzögerten Statistikerfassung abhängt.

Vorgang abbrechen

gcloud

Verwenden Sie den operations cancel Befehl, um einen laufenden Vorgang zu stoppen:

gcloud firestore operations cancel [OPERATION_NAME]

Durch das Abbrechen eines laufenden Vorgangs wird der Vorgang nicht rückgängig gemacht. Bei einem abgebrochenen Bulk-Löschvorgang werden die gelöschten Dokumente nicht wiederhergestellt.

Vorgang löschen

Verwenden Sie den gcloud firestore operations delete Befehl, um einen abgeschlossenen Vorgang aus der Liste der letzten Vorgänge zu entfernen. Verwenden Sie den oben beschriebenen Abbruchvorgang, um einen laufenden Vorgang abzubrechen.

gcloud firestore operations delete [OPERATION_NAME]

Abrechnung und Preise für Bulk-Löschvorgänge

Damit Sie den verwalteten Bulk-Löschdienst verwenden können, müssen Sie die Abrechnung für Ihr Google Cloud Projekt aktivieren, bevor Sie verwenden.

Beachten Sie, dass Firebase die tatsächlich geleistete Arbeit berechnet. Wenn der Vorgang abgebrochen wird oder aufgrund eines Nutzerfehlers fehlschlägt, werden Ihnen die Kosten für den bisherigen Fortschritt in Rechnung gestellt. Firebase berechnet keine Lese- oder Löschvorgänge für die Dokumente, die nicht endgültig gelöscht werden, z. B. Dokumente, die nach dem Start des Löschvorgangs geändert wurden. Die Kosten werden am Tag des Abschlusses des Vorgangs in Rechnung gestellt.

Bulk-Löschvorgänge werden erst nach Abschluss auf das Google Cloud Budget angerechnet. Die während eines Bulk-Löschvorgangs ausgeführten Lese- und Löschvorgänge werden nach Abschluss des Vorgangs auf Ihre Nutzung im Rahmen des kostenlosen Kontingents angerechnet. Bulk-Löschvorgänge wirken sich nicht auf die im Abschnitt „Nutzung“ der Konsole angezeigte Nutzung aus.

Kosten für Bulk-Löschvorgänge ansehen

Bei Bulk-Löschvorgängen wird das Label goog-firestoremanaged:bulkdelete auf in Rechnung gestellte Vorgänge angewendet. Auf der Seite der Cloud Billing-Berichte können Sie über dieses Label Kosten für Bulk-Löschvorgänge aufrufen.