Questa pagina descrive come utilizzare la console Google Cloud e Google Cloud CLI per configurare i criteri TTL (Time-To-Live). Prima di leggere questa pagina, devi conoscere il modello di dati in modalità Datastore.
Panoramica del tempo di vita
Utilizza le policy TTL per rimuovere automaticamente i dati inattivi dai tuoi database. Un criterio TTL designa una determinata proprietà come data e ora di scadenza per le entità di un determinato tipo. Con TTL, puoi ridurre i costi di archiviazione eliminando i dati obsoleti. In genere i dati vengono eliminati entro 24 ore dalla data di scadenza.
Prezzi
Le operazioni di eliminazione TTL vengono conteggiate ai fini dei costi di eliminazione delle entità. Per i prezzi delle operazioni di eliminazione, consulta Prezzi di Firestore in modalità Datastore.
Limiti e vincoli
- Solo una proprietà per tipo può essere contrassegnata come proprietà TTL.
- Sono consentiti un totale di 200 criteri TTL.
Eliminazione TTL
Tieni presente i seguenti comportamenti chiave dell'eliminazione basata su TTL:
L'eliminazione tramite TTL non è un processo istantaneo. Le entità scadute continuano a essere visualizzate nelle query e nelle richieste di ricerca finché il processo TTL non le elimina effettivamente. TTL scambia la tempestività dell'eliminazione con il vantaggio di un costo totale di proprietà ridotto per le eliminazioni. In genere i dati vengono eliminati entro 24 ore dalla data di scadenza.
L'eliminazione di un'entità tramite TTL non comporta l'eliminazione delle sue entità discendenti.
L'applicazione di un criterio TTL a un tipo esistente comporta l'eliminazione collettiva di tutti i dati scaduti in base al nuovo criterio TTL. Tieni presente che anche questa eliminazione collettiva non è istantanea e dipende dalla quantità di dati esistenti per quel tipo.
Se un'entità ha una data di scadenza passata e aggiungi un nuovo criterio TTL al tipo, l'entità verrà eliminata entro 24 ore dal completamento della configurazione del criterio TTL e dalla sua attivazione.
Il TTL non elimina necessariamente le entità nello stesso ordine dei relativi timestamp di scadenza.
Le eliminazioni non vengono eseguite in modo transazionale. Le entità con la stessa data di scadenza non vengono necessariamente eliminate contemporaneamente. Se hai bisogno di questo comportamento, esegui le eliminazioni utilizzando una libreria client.
La modalità Datastore rispetterà sempre il campo TTL più recente per determinare la scadenza. Ad esempio, se il campo TTL di un'entità scaduta, ma non ancora eliminata, viene aggiornato con una data successiva, l'entità non scadrà e verrà utilizzata la nuova data.
La modalità Datastore scade un documento solo quando il campo TTL è impostato su un tipo
Timestamp. Se il campo non è presente o è impostato su un valore comenullè possibile disattivare le scadenze su base di documento.Il TTL è progettato per ridurre al minimo l'impatto su altre attività del database. Le eliminazioni basate sul TTL vengono trattate con una priorità inferiore. Sono inoltre in atto altre strategie per attenuare i picchi di traffico dovuti alle eliminazioni basate su TTL.
Proprietà e indici TTL
Una proprietà TTL può essere indicizzata o non indicizzata. Tuttavia, poiché una proprietà TTL è un timestamp, l'indicizzazione della proprietà può influire sul rendimento a tassi di traffico più elevati. L'indicizzazione di una proprietà timestamp è contro le best practice e può creare hotspot. Gli hotspot sono caratterizzati da elevati tassi di lettura, scrittura ed eliminazione per un intervallo di chiavi ristretto.
Per impostazione predefinita, Datastore crea un indice integrato per tutte le proprietà. Puoi escludere una proprietà dagli indici per disattivare gli indici in una proprietà TTL.
Autorizzazioni
L'entità che configura un criterio TTL richiede la seguente autorizzazione nel progetto:
- Per visualizzare i criteri TTL sono necessarie le autorizzazioni
datastore.indexes.listedatastore.indexes.get. - La modifica dei criteri TTL richiede l'autorizzazione
datastore.indexes.update. - La verifica dello stato delle operazioni TTL richiede
datastore.operations.listedatastore.operations.get.
Per i ruoli che assegnano queste autorizzazioni, vedi Ruoli di Identity and Access Management di Datastore.
Prima di iniziare
Prima di utilizzare l'interfaccia a riga di comando gcloud per gestire i criteri TTL, utilizza il comando
gcloud components update
per aggiornare i componenti all'ultima versione disponibile:
gcloud components update
Crea una policy TTL
Quando crei un criterio TTL, designi una proprietà dell'entità come data e ora di scadenza per le entità di un tipo. Il criterio TTL si applica al tipo specificato in tutti gli spazi dei nomi.
TTL utilizza una proprietà specificata per identificare le entità idonee all'eliminazione. Questa proprietà TTL deve essere di tipo Date and time. Puoi selezionare una proprietà già esistente o designare una proprietà che prevedi di aggiungere in un secondo momento.
Prima di impostare il valore della proprietà TTL, considera quanto segue:
Il valore della proprietà TTL può essere un momento nel futuro, nel presente o nel passato. Se il valore è un valore nel passato, l'entità è immediatamente idonea all'eliminazione. Ad esempio, potresti creare un criterio TTL con la proprietà
expireAt, che poi aggiungi alle entità esistenti.L'utilizzo di qualsiasi altro tipo di dati o la mancata impostazione del valore della proprietà TTL disattiva il TTL per la singola entità.
Per creare una policy TTL:
Google Cloud Console
Nella console Google Cloud, vai alla pagina Database.
Seleziona il database richiesto dall'elenco dei database.
Nel menu di navigazione, fai clic su Tempo di vita.
Fai clic su Crea criterio.
Inserisci un nome di tipo e un nome di proprietà timestamp.
Fai clic su Crea.
La console torna alla pagina Durata. Se l'operazione inizia correttamente, la pagina aggiunge una voce alla tabella dei criteri TTL. In caso di fallimento, nella pagina viene visualizzato un messaggio di errore.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Utilizza il comando
firestore fields ttls updateper configurare un criterio TTL. Aggiungi il flag--asyncper impedire alla gcloud CLI di attendere il completamento dell'operazione.gcloud firestore fields ttls update ttl_field --collection-group=collection_group_name --enable-ttl
Anche in un database vuoto, l'attivazione di un criterio TTL può richiedere almeno dieci minuti. Una volta avviata un'operazione, la chiusura del terminale non annulla l'operazione.
Visualizzare i criteri TTL
Per visualizzare i criteri TTL e i relativi stati:
Google Cloud Console
Nella console Google Cloud, vai alla pagina Database.
Seleziona il database richiesto dall'elenco dei database.
Nel menu di navigazione, fai clic su Tempo di vita.
La console elenca i criteri TTL per il database e include lo stato di ciascun criterio.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Utilizza il comando
firestore fields ttls listper configurare un criterio TTL. Il seguente comando elenca tutte le norme TTL.gcloud firestore fields ttls list
Per elencare i criteri TTL di un tipo specifico, utilizza quanto segue:
gcloud firestore fields ttls list --collection-group=collection_group_name
Visualizza i dettagli dell'operazione
Puoi utilizzare gcloud CLI per visualizzare ulteriori dettagli su un'impostazione TTL
che si trova nello stato CREATING.
Utilizza il comando operations list per visualizzare tutte le operazioni in esecuzione e quelle completate di recente:
gcloud firestore operations list
La risposta include una stima dell'avanzamento dell'operazione.
Disattivare un criterio TTL
Per disattivare un criterio TTL, segui i passaggi riportati di seguito.
Google Cloud Console
Nella console Google Cloud, vai alla pagina Database.
Seleziona il database richiesto dall'elenco dei database.
Nel menu di navigazione, fai clic su Tempo di vita.
Nella tabella dei criteri TTL, individua la riga relativa al criterio TTL. In questa riga della tabella, fai clic sul pulsante Elimina (cestino).
Conferma l'operazione facendo clic su Elimina.
La console torna alla pagina Durata. In caso di esito positivo, Datastore rimuove il criterio TTL dalla tabella.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Utilizza il comando
firestore fields ttls updateper configurare un criterio TTL. Aggiungi il flag--asyncper impedire alla gcloud CLI di attendere il completamento dell'operazione.gcloud firestore fields ttls update ttl_field --collection-group=collection_group_name --disable-ttl
Monitorare le eliminazioni TTL
Puoi utilizzare Cloud Monitoring per visualizzare le metriche relative alle eliminazioni basate su TTL. Datastore fornisce le seguenti metriche per il TTL:
| datastore.googleapis.com/entity/ttl_deletion_count | Conteggio delle eliminazioni TTL |
Conteggio totale delle entità eliminate dai criteri TTL. |
| datastore.googleapis.com/entity/ttl_expiration_to_deletion_delays | Ritardi dalla scadenza TTL all'eliminazione |
Tempo trascorso tra la scadenza di un'entità in base a un criterio TTL e il momento in cui è stata effettivamente eliminata. |
Per configurare una dashboard con le metriche Datastore, consulta Gestire una dashboard personalizzata e Aggiungere widget della dashboard.