Questa pagina descrive come utilizzare la console Google Cloud e il client gcloud di Google Cloud per configurare i criteri TTL (Time to Live). Prima di leggere questa pagina, è necessario comprendere il modello di dati Cloud Firestore.
Panoramica della durata
Utilizza i criteri TTL per rimuovere automaticamente i dati inattivi dai tuoi database. Un criterio TTL designa un determinato campo come data di scadenza per i documenti di un determinato gruppo di raccolte. 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 dei documenti. Per i prezzi delle operazioni di eliminazione, consulta i prezzi di Cloud Firestore.
Limiti e vincoli
- È possibile contrassegnare come campo TTL un solo campo per gruppo di raccolte.
- Sono consentite un totale di 200 configurazioni a livello di campo. Una configurazione di campo può contenere più configurazioni per lo stesso campo. Ad esempio, un'esenzione per l'indicizzazione a campo singolo e un criterio TTL per lo stesso numero di campi di una configurazione di campo verso il limite.
- Per i clienti di Firestore in modalità Datastore, TTL non può essere utilizzato con una modalità di concorrenza Ottimista con gruppi di entità. Valuta la possibilità di impostare la modalità di concorrenza ottimistica.
Eliminazione TTL
Tieni presente i seguenti comportamenti chiave dell'eliminazione basata su TTL:
L'eliminazione tramite TTL non è un processo istantaneo. I documenti scaduti continuano a essere visualizzati nelle query e nelle richieste di ricerca finché il processo TTL non li 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 documento tramite TTL non elimina le sottoraccolte al suo interno.
L'applicazione di un criterio TTL a un gruppo di raccolte 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 il gruppo di raccolta.
Se un documento ha una scadenza nel passato e aggiungi un nuovo criterio TTL alla raccolta, il documento verrà eliminato entro 24 ore dal momento in cui il criterio TTL termina la configurazione e diventa attivo.
Il TTL non elimina necessariamente i documenti nello stesso ordine dei relativi timestamp di scadenza.
Le eliminazioni non vengono eseguite a livello transazionale. I documenti con la stessa data di scadenza non vengono necessariamente eliminati contemporaneamente. Se hai bisogno di questo comportamento, esegui le eliminazioni utilizzando una libreria client.
Cloud Firestore rispetterà sempre il campo TTL più recente per determinare la scadenza. Ad esempio, se il campo TTL di un documento scaduto, ma non ancora eliminato, viene aggiornato con una data successiva, il documento non scadrà e verrà utilizzata la nuova data.
Il TTL è progettato per ridurre al minimo l'impatto su altre attività del database. Le eliminazioni guidate da TTL vengono trattate con una priorità più bassa. Sono inoltre in atto altre strategie per attenuare i picchi di traffico dovuti alle eliminazioni basate su TTL.
L'eliminazione tramite TTL chiama tutti gli ascoltatori snapshot attivi e attiva gli attivatori Cloud Functions Cloud Firestore.
Campi e indici TTL
Un campo TTL può essere indicizzato o non indicizzato. Tuttavia, poiché un campo TTL è un timestamp, l'indicizzazione del campo può influire sulle prestazioni a tassi di traffico più elevati. L'indicizzazione di un campo timestamp può creare hotspot, il che è contrario alle best practice. Gli hotspot hanno un'elevata frequenza di lettura, scrittura ed eliminazione per un intervallo di documenti limitato.
Per impostazione predefinita, Cloud Firestore crea un indice a campo singolo per tutti i campi. Puoi creare un'esenzione dell'indice a campo singolo per disattivare gli indici in un campo 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.list
edatastore.indexes.get
. - La modifica dei criteri TTL richiede l'autorizzazione
datastore.indexes.update
. - La verifica dello stato delle operazioni TTL richiede
datastore.operations.list
edatastore.operations.get
.
Per i ruoli che assegnano queste autorizzazioni, vedi Cloud Firestore Ruoli di Identity and Access Management.
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 un criterio TTL
Quando crei un criterio TTL, designi un campo documento come data di scadenza per i documenti di un gruppo di raccolte.
TTL utilizza un campo specificato per identificare i documenti idonei all'eliminazione.
Questo campo TTL deve essere di tipo Date and time
. Puoi selezionare un campo già esistente o designare un campo che prevedi di aggiungere in un secondo momento.
Tieni presente quanto segue prima di impostare il valore del campo TTL:
Il valore del campo TTL può essere un'ora nel futuro, nel presente o nel passato. Se il valore è un'ora nel passato, il documento è immediatamente idoneo all'eliminazione. Ad esempio, potresti creare un criterio TTL con il campo
expireAt
, che poi aggiungi ai documenti esistenti.Se utilizzi qualsiasi altro tipo di dati o non imposti il valore del campo TTL, il TTL per il singolo documento verrà disabilitato.
Per creare un criterio 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 per il gruppo di raccolte e un nome per il campo del timestamp.
Fai clic su Crea.
La console torna alla pagina Durata. Se l'operazione viene avviata correttamente, nella pagina viene aggiunta una voce alla tabella dei criteri TTL. In caso di errore, nella pagina viene visualizzato un messaggio di errore.
gcloud
Utilizza il comando firestore fields ttls
update
per configurare un criterio TTL. Aggiungi il flag --async
per impedire a gcloud CLI di attendere il completamento dell'operazione.
gcloud firestore fields ttls update ttl_field --collection-group=collection_group_name --enable-ttl
Durata dell'attivazione del criterio 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 la annulla.
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
Utilizza il comando
firestore fields ttls list
per configurare un criterio TTL. Il comando seguente elenca tutti i criteri TTL.
gcloud firestore fields ttls list
Per elencare i criteri TTL in un gruppo di raccolte 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:
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 facendo clic su Elimina.
La console torna alla pagina Durata. Se l'operazione riesce, Cloud Firestore rimuove il criterio TTL dalla tabella.
gcloud
1. Utilizza il comando
firestore fields ttls update
per configurare un criterio TTL. Aggiungi il flag --async
per impedire a 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. Cloud Firestore fornisce le seguenti metriche per il TTL:
Tipo di metrica | Nome metrica | Descrizione metrica |
---|---|---|
firestore.googleapis.com/document/ttl_deletion_count | Conteggio delle eliminazioni della durata (TTL) |
Conteggio totale dei documenti eliminati dai criteri TTL. |
firestore.googleapis.com/document/ttl_expiration_to_deletion_delays | Ritardi dall'eliminazione alla scadenza del TTL |
Tempo trascorso tra la scadenza di un documento in base a un criterio TTL e il momento in cui è stato effettivamente eliminato. |
Per configurare una dashboard con le metriche Cloud Firestore, consulta Gestire la dashboard personalizzata e Aggiungere widget della dashboard.