Questa pagina è stata tradotta dall'API Cloud Translation.

Gestisci la conservazione dei dati con i criteri TTL

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, dovresti conoscere Modello dei dati Firestore.

Panoramica della durata

Usa i criteri TTL per eseguire automaticamente per rimuovere i dati obsoleti dai database. Un criterio TTL designa un determinato campo come la data e l'ora di scadenza dei documenti in un determinato gruppo di raccolte. Con il 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 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. Configurazione in un solo campo può contenere più configurazioni per lo stesso campo. Ad esempio: un'esenzione dell'indicizzazione a campo singolo e un criterio TTL nello stesso campo vengono conteggiati come la configurazione di un campo per raggiungere il limite.
Per i clienti di Firestore in modalità Datastore, il TTL non può essere utilizzato con una modalità di contemporaneità di Ottimista con i gruppi di entità. Valuta la possibilità di cambiare la modalità di contemporaneità in Modalità di contemporaneità ottimistica.

Eliminazione TTL

Nota i seguenti comportamenti chiave dell'eliminazione basata su TTL:

L'eliminazione tramite TTL non è un processo istantaneo. Documenti scaduti continuano ad apparire nelle query e nelle richieste di ricerca fino al processo TTL le elimina. Il TTL scambia la tempestività dell'eliminazione a vantaggio di riduzione del costo totale di proprietà 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 documento.
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 data di scadenza passata e aggiungi un nuovo criterio TTL alla raccolta, il documento verrà eliminato entro 24 ore dal completamento della configurazione del criterio TTL e dalla sua attivazione.
Il TTL non elimina necessariamente i documenti nello stesso ordine i timestamp di scadenza.
Le eliminazioni non vengono eseguite in modo transazionale. Documenti con la stessa scadenza non vengono necessariamente eliminati nello stesso momento. Per necessità esegui le eliminazioni utilizzando una libreria client.
Firestore rispetterà sempre l'ultimo campo TTL 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 basate sul TTL vengono trattate con una priorità inferiore. Altre strategie sono per attenuare i picchi di traffico causati dalle eliminazioni basate su TTL.
Eliminazione tramite chiamate TTL tutte attive listener di snapshot e trigger le funzioni Cloud Run Trigger di Firestore.

Campi e indici TTL

Un campo TTL può essere indicizzato o meno. 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, che vanno contro le best practice. Gli hotspot sono caratterizzati da un elevato tasso di letture, scritture ed eliminazioni in un intervallo ristretto di documenti.

Per impostazione predefinita, 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 e datastore.indexes.get.
La modifica dei criteri TTL richiede l'autorizzazione datastore.indexes.update.
La verifica dello stato delle operazioni TTL richiede datastore.operations.list e datastore.operations.get.

Per i ruoli che assegnano queste autorizzazioni, vedi Ruoli di Identity and Access Management di Firestore.

Prima di iniziare

Prima di utilizzare gcloud CLI per gestire i criteri TTL, utilizza 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 del documento come data e ora 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 esiste già o puoi 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 In passato, il documento risultava immediatamente idoneo per l'eliminazione. Ad esempio, potrebbe creare un criterio TTL con il campo expireAt, che in seguito aggiungerai documenti esistenti.
L'utilizzo di qualsiasi altro tipo di dati o la mancata impostazione del valore del campo TTL disattiva il TTL per il singolo documento.

Per creare un criterio TTL:

Google Cloud Console

Nella console Google Cloud, vai alla pagina Database.

Vai a 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 inizia correttamente, la pagina aggiunge una voce alla tabella dei criteri TTL. In caso di errore, nella pagina viene visualizzato un messaggio di errore.

gcloud

In the Google Cloud console, activate Cloud Shell.

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 update per configurare un criterio TTL. Aggiungi il flag --async per impedire alla CLI gcloud 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 su un database vuoto, l'abilitazione di un TTL può richiedere 10 minuti o più . Una volta avviata un'operazione, la chiusura del terminale non la annulla.

Visualizzare i criteri TTL

Per visualizzare i criteri TTL e il relativo stato:

Google Cloud Console

Nella console Google Cloud, vai alla pagina Database.

Vai a Database
Seleziona il database richiesto dall'elenco dei database.
Nel menu di navigazione, fai clic su Durata.

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.

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 la firestore fields ttls list per configurare un criterio TTL. Il seguente comando elenca tutte le norme TTL.
```
gcloud firestore fields ttls list
```
Per elencare i criteri TTL all'interno di un gruppo di raccolte specifico, utilizza quanto segue:
```
gcloud firestore fields ttls list  --collection-group=collection_group_name
```

View operation details

You can use the gcloud CLI to view more details about a TTL policy that is in the CREATING state.

Use the operations list command to see all running and recently completed operations:

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.

Vai a 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. All'interno di questo fai clic sul pulsante Elimina (cestino).
Conferma l'operazione facendo clic su Elimina.

La console torna alla pagina Durata. Se il successo è successo, Firestore rimuove il criterio TTL dalla tabella.

gcloud

In the Google Cloud console, activate Cloud Shell.

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 la firestore fields ttls update per configurare un criterio TTL. Aggiungi il flag --async per impedire alla CLI gcloud 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. Firestore fornisce le seguenti metriche per il TTL:

Tipo di metrica	Nome metrica	Descrizione della 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	Scadenza della durata (TTL) per i ritardi di eliminazione	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 di Firestore, consulta Gestire la dashboard personalizzata e Aggiungere widget della dashboard.