Datenaufbewahrung mit TTL-Richtlinien verwalten

Auf dieser Seite wird beschrieben, wie Sie mit der Google Cloud -Konsole und der Google Cloud CLI Richtlinien für die Gültigkeitsdauer (Time-to-Live, TTL) konfigurieren. Bevor Sie diese Seite lesen, sollten Sie das Datastore-Modus-Datenmodell kennen.

Time-to-Live – Übersicht

Mit TTL-Richtlinien werden veraltete Daten automatisch aus Ihren Datenbanken entfernt. In einer TTL-Richtlinie wird eine bestimmte Eigenschaft als Ablaufzeit für Entitäten eines bestimmten Typs festgelegt. Mit TTL können Sie die Speicherkosten senken, indem Sie veraltete Daten löschen. Daten werden in der Regel innerhalb von 24 Stunden nach ihrem Ablaufdatum gelöscht.

Preise

TTL-Löschvorgänge werden auf Ihre Kosten für das Löschen von Einheiten angerechnet. Informationen zu den Preisen für Löschvorgänge finden Sie unter Preise für Firestore im Datastore-Modus.

Limits und Einschränkungen

  • Sie können nur eine Property pro Art als TTL-Property kennzeichnen.
  • Sie können maximal 500 TTL-Richtlinien haben.

TTL-Löschvorgang

Beachten Sie die folgenden wichtigen Verhaltensweisen beim TTL-basierten Löschen:

  • Das Löschen über TTL erfolgt nicht sofort. Abgelaufene Entitäten werden weiterhin in Abfragen und Suchanfragen angezeigt, bis sie durch den TTL-Prozess tatsächlich gelöscht werden. Bei TTL wird die Aktualität des Löschens zugunsten geringerer Gesamtbetriebskosten für Löschvorgänge geopfert. Daten werden in der Regel innerhalb von 24 Stunden nach ihrem Ablaufdatum gelöscht.

  • Wenn Sie eine Entität über TTL löschen, werden die untergeordneten Entitäten dieser Entität nicht gelöscht.

  • Wenn Sie eine TTL-Richtlinie auf einen vorhandenen Typ anwenden, werden alle Daten, die gemäß der neuen TTL-Richtlinie abgelaufen sind, in einem Massenvorgang gelöscht. Auch das Löschen von Daten im Bulk erfolgt nicht sofort, sondern hängt von der Datenmenge ab.

  • Wenn für eine Entität ein Ablaufdatum in der Vergangenheit festgelegt ist und Sie dem Typ eine neue TTL-Richtlinie hinzufügen, wird die Entität innerhalb von 24 Stunden nach Abschluss der Einrichtung und Aktivierung der TTL-Richtlinie gelöscht.

  • Entitäten werden durch TTL nicht unbedingt in der Reihenfolge ihrer Ablaufzeitstempel gelöscht.

  • Löschvorgänge werden nicht transaktional ausgeführt. Entitäten mit derselben Ablaufzeit werden nicht unbedingt gleichzeitig gelöscht. Wenn Sie dieses Verhalten benötigen, führen Sie die Löschvorgänge mit einer Clientbibliothek aus.

  • Im Datastore-Modus wird immer das neueste TTL-Feld verwendet, um das Ablaufdatum zu bestimmen. Wenn beispielsweise das TTL-Feld einer abgelaufenen, aber noch nicht gelöschten Entität auf ein späteres Datum aktualisiert wird, läuft die Entität nicht ab und das neue Datum wird verwendet.

  • Im Datastore-Modus läuft ein Dokument nur ab, wenn das TTL-Feld auf den Typ Timestamp festgelegt ist. Wenn Sie das Feld nicht angeben oder auf einen Wert wie null setzen, können Abläufe für einzelne Dokumente deaktiviert werden.

  • TTL soll die Auswirkungen auf andere Datenbankaktivitäten minimieren. Löschungen, die durch die TTL ausgelöst werden, haben eine niedrigere Priorität. Es gibt auch andere Strategien, um Trafficspitzen durch TTL-basierte Löschvorgänge zu vermeiden.

TTL-Attribute und ‑Indizes

Eine TTL-Eigenschaft kann indexiert oder nicht indexiert sein. Da eine TTL-Property jedoch ein Zeitstempel ist, kann sich die Indexierung der Property bei höheren Traffic-Raten auf die Leistung auswirken. Das Indexieren eines Zeitstempelattributs entspricht nicht den Best Practices und kann Hotspots verursachen. Hotspots sind hohe Lese-, Schreib- und Löschraten für einen kleinen Schlüsselbereich.

Standardmäßig erstellt Datastore einen integrierten Index für alle Attribute. Sie können ein Attribut aus Indexen ausschließen, um Indexe für ein TTL-Attribut zu deaktivieren.

Berechtigungen

Das Hauptkonto, das eine TTL-Richtlinie konfiguriert, benötigt die folgende Berechtigung im Projekt:

  • Zum Ansehen von TTL-Richtlinien sind die Berechtigungen datastore.indexes.list und datastore.indexes.get erforderlich.
  • Zum Ändern von TTL-Richtlinien ist die Berechtigung datastore.indexes.update erforderlich.
  • Zum Prüfen des Status von TTL-Vorgängen sind datastore.operations.list und datastore.operations.get erforderlich.

Rollen, mit denen diese Berechtigungen zugewiesen werden, finden Sie unter IAM-Identity and Access Management Datenspeicher.

TTL-Richtlinie erstellen

Wenn Sie eine TTL-Richtlinie erstellen, legen Sie eine Entitätseigenschaft als Ablaufzeit für Entitäten eines Typs fest. Die TTL-Richtlinie gilt für die angegebene Art in allen Namespaces.

Bei TTL wird eine bestimmte Property verwendet, um Entitäten zu identifizieren, die gelöscht werden können. Diese TTL-Eigenschaft muss vom Typ Date and time sein. Sie können eine vorhandene Property auswählen oder eine Property angeben, die Sie später hinzufügen möchten.

Beachten Sie Folgendes, bevor Sie den TTL-Eigenschaftswert festlegen:

  • Der TTL-Attributwert kann eine Zeit in der Zukunft, die aktuelle Zeit oder eine Zeit in der Vergangenheit sein. Wenn der Wert eine Zeit in der Vergangenheit ist, kann die Entität sofort gelöscht werden. Sie können beispielsweise eine TTL-Richtlinie mit der Eigenschaft expireAt erstellen, die Sie dann vorhandenen Entitäten hinzufügen.

  • Wenn Sie einen anderen Datentyp verwenden oder den TTL-Attributwert nicht festlegen, wird die TTL für die einzelne Entität deaktiviert.

So erstellen Sie eine TTL-Richtlinie:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Time-to-Live.

  4. Klicken Sie auf Richtlinie erstellen.

  5. Geben Sie einen Namen für die Art und einen Namen für das Zeitstempelattribut ein.

  6. Klicken Sie auf Erstellen.

Die Console kehrt zur Seite Time-to-live zurück. Wenn der Vorgang erfolgreich gestartet wird, fügt die Seite der Tabelle „TTL-Richtlinien“ einen Eintrag hinzu. Bei einem Fehler wird auf der Seite eine Fehlermeldung angezeigt.

gcloud

  1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  2. Verwenden Sie den Befehl firestore fields ttls update, um eine TTL-Richtlinie zu konfigurieren. Fügen Sie das Flag --async hinzu, um zu verhindern, dass die gcloud CLI auf den Abschluss des Vorgangs wartet.

    gcloud firestore fields ttls update ttl_field --collection-group=collection_group_name --enable-ttl

Es kann mindestens zehn Minuten oder länger dauern, bis eine TTL-Richtlinie aktiviert wird. Wenn Sie einen Vorgang gestartet haben, wird er durch Schließen des Terminals nicht abgebrochen.

TTL-Richtlinien ansehen

So rufen Sie TTL-Richtlinien und ihre Status auf:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Time-to-Live.

In der Google Cloud Console werden TTL-Richtlinien für Ihre Datenbank aufgeführt. Außerdem wird der Status jeder Richtlinie angezeigt.

gcloud

  1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  2. Mit dem Befehl firestore fields ttls list rufen Sie eine TTL-Richtlinie auf. Mit dem folgenden Befehl werden alle TTL-Richtlinien aufgelistet.

    gcloud firestore fields ttls list

    Verwenden Sie Folgendes, um TTL-Richtlinien für eine bestimmte Art aufzulisten:

    gcloud firestore fields ttls list  --collection-group=collection_group_name

Betriebsdetails anzeigen

Mit der gcloud CLI können Sie weitere Details zu einer TTL-Richtlinie im Status CREATING aufrufen.

Verwenden Sie den Befehl operations list, um alle laufenden und kürzlich abgeschlossenen Vorgänge anzeigen zu lassen:

gcloud firestore operations list

Die Antwort enthält eine Schätzung des Fortschritts des Vorgangs.

TTL-Richtlinie deaktivieren

So deaktivieren Sie eine TTL-Richtlinie:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Time-to-Live.

  4. Suchen Sie in der Tabelle „TTL-Richtlinie“ nach der Zeile für die TTL-Richtlinie. Klicken Sie in dieser Tabellenzeile auf die Schaltfläche Löschen (Papierkorb).

  5. Klicken Sie zur Bestätigung auf Löschen.

Die Google Cloud Console kehrt zur Seite Time-to-live zurück. Bei Erfolg wird die TTL-Richtlinie aus der Tabelle entfernt.

gcloud

  1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  2. Verwenden Sie den Befehl firestore fields ttls update, um eine TTL-Richtlinie zu konfigurieren. Fügen Sie das Flag --async hinzu, um zu verhindern, dass die gcloud CLI auf den Abschluss des Vorgangs wartet.

    gcloud firestore fields ttls update ttl_field --collection-group=collection_group_name --disable-ttl

TTL-Löschvorgänge überwachen

Mit Cloud Monitoring können Sie Messwerte zu TTL-gesteuerten Löschvorgängen ansehen. Datastore bietet die folgenden Messwerte für TTL:

datastore.googleapis.com/entity/ttl_deletion_count Anzahl der TTL-Löschvorgänge

Gesamtzahl der Entitäten, die durch TTL-Richtlinien gelöscht wurden.
datastore.googleapis.com/entity/ttl_expiration_to_deletion_delays Verzögerungen beim Löschen nach TTL-Ablauf

Die Zeit, die zwischen dem Ablauf einer Entität gemäß einer TTL-Richtlinie und dem tatsächlichen Löschen vergangen ist.

Informationen zum Einrichten eines Dashboards mit Datastore-Messwerten finden Sie unter Benutzerdefinierte Dashboards verwalten und Dashboard-Widgets hinzufügen.