Auf dieser Seite wird beschrieben, wie Sie die Google Cloud console und die Google Cloud CLI verwenden, um Richtlinien zur Gültigkeitsdauer (Time-to-Live, TTL) zu konfigurieren. Bevor Sie diese Seite lesen, sollten Sie das Datastore-Modell kennen.
Übersicht über die Gültigkeitsdauer
Mit TTL-Richtlinien werden veraltete Daten automatisch aus Ihren Datenbanken entfernt. Eine TTL-Richtlinie legt ein bestimmtes Attribut als Ablaufzeit für Entitäten eines bestimmten Typs fest. Mit TTL können Sie die Speicherkosten senken, indem Sie veraltete Daten entfernen. 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 Entitäten 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 ein Attribut pro Typ als TTL-Attribut markieren.
- Sie können maximal 1.000 TTL-Richtlinien haben.
TTL-Löschvorgänge
Beachten Sie die folgenden wichtigen Verhaltensweisen bei TTL-gesteuerten Löschvorgängen:
Das Löschen über TTL erfolgt nicht sofort. Abgelaufene Entitäten werden weiterhin in Abfragen und Suchanfragen angezeigt, bis sie tatsächlich durch den TTL-Prozess gelöscht werden. Bei TTL wird die Pünktlichkeit des Löschvorgangs gegen geringere Gesamtbetriebskosten für Löschvorgänge eingetauscht. 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, per Bulk-Löschvorgang gelöscht. Auch dieser Bulk-Löschvorgang erfolgt nicht sofort und hängt davon ab, wie viele Daten für diesen Typ vorhanden sind.
Wenn eine Entität eine Ablaufzeit in der Vergangenheit hat und Sie dem Typ eine neue TTL-Richtlinie hinzufügen, wird die Entität innerhalb von 24 Stunden nach Abschluss der Einrichtung der TTL-Richtlinie und deren Aktivierung gelöscht.
Entitäten werden 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 den Ablauf 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
Timestampfestgelegt ist. Wenn Sie das Feld leer lassen oder auf einen Wert wienullsetzen, können Sie Abläufe pro Dokument deaktivieren.TTL soll die Auswirkungen auf andere Datenbankaktivitäten minimieren. Löschvorgänge, die durch TTL ausgelöst werden, haben eine niedrigere Priorität. Es gibt auch andere Strategien, um Trafficspitzen durch TTL-gesteuerte Löschvorgänge zu vermeiden.
TTL-Attribute und -Indexe
Ein TTL-Attribut kann indexiert oder nicht indexiert sein. Da ein TTL-Attribut jedoch ein Zeitstempel ist, kann die Indexierung des Attributs die Leistung bei höheren Trafficraten beeinträchtigen. Die Indexierung 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
Der Principal, der eine TTL-Richtlinie konfiguriert, benötigt die folgende Berechtigung im Projekt:
- Zum Aufrufen von TTL-Richtlinien sind die Berechtigungen
datastore.indexes.listunddatastore.indexes.geterforderlich. - Zum Ändern von TTL-Richtlinien ist die Berechtigung
datastore.indexes.updateerforderlich. - Zum Prüfen des Status von TTL-Vorgängen sind
datastore.operations.listunddatastore.operations.geterforderlich.
Informationen zu Rollen, mit denen diese Berechtigungen zugewiesen werden, finden Sie unter Rollen von Identity and Access Management für Datastore.
TTL-Richtlinie erstellen
Wenn Sie eine TTL-Richtlinie erstellen, legen Sie ein Entitätsattribut als Ablaufzeit für Entitäten eines Typs fest. Die TTL-Richtlinie gilt für die angegebene Art in allen Namespaces.
TTL verwendet ein bestimmtes Attribut, um Entitäten zu identifizieren, die für das Löschen infrage kommen. Dieses TTL-Attribut muss vom Typ Date and time sein. Sie können ein bereits vorhandenes Attribut auswählen oder ein Attribut festlegen, das Sie später hinzufügen möchten.
Beachten Sie Folgendes, bevor Sie den Wert für das TTL-Attribut festlegen:
Der Wert für das TTL-Attribut 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, kommt die Entität sofort für das Löschen infrage. Sie können beispielsweise eine TTL-Richtlinie mit dem Attribut
expireAterstellen, das Sie dann vorhandenen Entitäten hinzufügen.Wenn Sie einen anderen Datentyp verwenden oder den Wert für das TTL-Attribut nicht festlegen, wird die TTL für die einzelne Entität deaktiviert.
So erstellen Sie eine TTL-Richtlinie:
Google Cloud Console
Rufen Sie in der Google Cloud console die Datenbanken Seite auf.
Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.
Klicken Sie im Navigationsmenü auf Gültigkeitsdauer.
Klicken Sie auf Richtlinie erstellen.
Geben Sie einen Typnamen und einen Namen für das Zeitstempelattribut ein.
Klicken Sie auf Erstellen.
Die Console kehrt zur Seite Gültigkeitsdauer 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
-
Aktivieren Sie Cloud Shell in der Google Cloud console.
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.
Verwenden Sie den
firestore fields ttls updateBefehl, um eine TTL-Richtlinie zu konfigurieren. Fügen Sie das Flag--asynchinzu, 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 dauern, bis eine TTL-Richtlinie aktiviert ist. Wenn Sie einen Vorgang gestartet haben, wird er durch Schließen des Terminals nicht abgebrochen.
TTL-Richtlinien ansehen
Führen Sie die folgenden Schritte aus, um TTL-Richtlinien und deren Status anzusehen.
Google Cloud Console
Rufen Sie in der Google Cloud console die Datenbanken Seite auf.
Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.
Klicken Sie im Navigationsmenü auf Gültigkeitsdauer.
In der Google Cloud console werden die TTL-Richtlinien für Ihre Datenbank mit dem Status der einzelnen Richtlinien aufgeführt.
gcloud
-
Aktivieren Sie Cloud Shell in der Google Cloud console.
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.
Verwenden Sie den
firestore fields ttls listBefehl, um eine TTL-Richtlinie anzusehen. Mit dem folgenden Befehl werden alle TTL-Richtlinien aufgelistet.gcloud firestore fields ttls list
Verwenden Sie Folgendes, um TTL-Richtlinien unter einer bestimmten 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 ansehen.
Verwenden Sie den operations list Befehl, um alle laufenden und
kürzlich abgeschlossenen Vorgänge anzusehen:
gcloud firestore operations list
Die Antwort enthält eine Schätzung des Fortschritts des Vorgangs.
TTL-Richtlinie deaktivieren
Führen Sie die folgenden Schritte aus, um eine TTL-Richtlinie zu deaktivieren.
Google Cloud Console
Rufen Sie in der Google Cloud console die Datenbanken Seite auf.
Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.
Klicken Sie im Navigationsmenü auf Gültigkeitsdauer.
Suchen Sie in der Tabelle „TTL-Richtlinien“ die Zeile für die TTL-Richtlinie. Klicken Sie in dieser Tabellenzeile auf die Schaltfläche Löschen (Papierkorb).
Klicken Sie zur Bestätigung auf Löschen.
Die Google Cloud Console kehrt zur Seite Gültigkeitsdauer zurück. Wenn der Vorgang erfolgreich ist, entfernt Datastore die TTL-Richtlinie aus der Tabelle.
gcloud
-
Aktivieren Sie Cloud Shell in der Google Cloud console.
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.
Verwenden Sie den
firestore fields ttls updateBefehl, um eine TTL-Richtlinie zu konfigurieren. Fügen Sie das Flag--asynchinzu, 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 zwischen TTL-Ablauf und Löschvorgang |
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 Benutzerdefiniertes Dashboard verwalten und Dashboard-Widgets hinzufügen.