Panoramica del recupero point-in-time (PITR)

Il recupero point-in-time (PITR) protegge da eliminazioni o scritture accidentali. PITR conserva le versioni dei tuoi documenti dalle timestamp passate. Ad esempio, nel caso in cui uno sviluppatore inserisca dati errati, eliminazioni o scritture accidentali, il recupero point-in-time può recuperare i dati in un momento specifico del passato (fino a un massimo di 7 giorni).

Per qualsiasi database live che segue le best practice, l'utilizzo del PITR non influisce sul rendimento delle letture o delle scritture.

Finestra PITR

Dopo aver abilitato il PITR, Cloud Firestore inizia a conservare i dati PITR. I dati PITR vengono conservati per 7 giorni nella finestra PITR.

Puoi leggere i dati per un timestamp in base al momento in cui è stato abilitato il PITR:

Stato di abilitazione PITR I primi dati PITR disponibili
Disabilitata 1 ora prima dell'ora della richiesta di lettura
abilitato entro 7 giorni 1 ora prima dell'abilitazione del PITR
attivato più di 7 giorni fa 7 giorni prima dell'ora della richiesta di lettura

Viene conservata una sola versione al minuto nella finestra PITR. Puoi leggere i documenti con una granularità al minuto utilizzando un timestamp di un minuto intero. Le letture che non hanno una granularità al minuto, come 2023-05-30 09:00:00.1234AM, restituiscono un errore che indica che read_time è troppo vecchio.

In caso di più scritture, viene conservata una sola versione di un documento. Ad esempio, se un documento ha avuto più scritture comprese tra v1, v2, ... vk tra il timestamp 2023-05-30 09:00:00AM (escluso) e 2023-05-30 09:01:00AM (incluso), una richiesta di lettura al timestamp 2023-05-30 09:01:00AM restituisce la versione vk del documento.

Puoi leggere i dati creati durante il periodo PITR. I dati vengono archiviati con una granularità di un minuto e puoi recuperarli con la stessa granularità. La funzionalità PITR è disattivata per impostazione predefinita.

Il campo earliestVersionTime del database specifica l'ora di lettura consentita più recente per i dati.

Indipendentemente dal fatto che PITR sia abilitato o meno, puoi leggere (ma non esportare) i documenti in qualsiasi timestamp con granularità di microsecondi nell'ultima ora, ma non prima del giorno earliestVersionTime.

Metodi per recuperare i dati

Esistono due modi per recuperare i dati:

  • Per recuperare una parte del database, esegui una lettura obsoleta specificando una condizione di query o utilizzando la ricerca diretta delle chiavi insieme a un timestamp nel passato, quindi riscrivi i risultati nel database live. Questa opzione viene in genere utilizzata per operazioni chirurgiche su un database attivo. Ad esempio, se elimini accidentalmente un documento specifico o aggiorni in modo errato un sottoinsieme di dati, puoi recuperarlo con questo metodo. Per istruzioni, vedi Recuperare una parte del database.

  • Per recuperare l'intero database, esporta il database specificando un timestamp nel passato e poi importalo in un nuovo database. L'operazione di esportazione PITR supporta tutti i filtri, inclusa l'esportazione di tutti i documenti e l'esportazione di raccolte specifiche. Puoi esportare i dati PITR in cui il timestamp è un timestamp di un minuto intero negli ultimi sette giorni, ma non prima del earliestVersionTime.

Prezzi

Prima di attivare il recupero point-in-time per il tuo database, tieni presente le seguenti informazioni sui prezzi:

  • Archiviazione: Cloud Firestore misura le dimensioni del database giornalmente. Nel corso di un mese, questi punti campione vengono mediati per calcolare le dimensioni di archiviazione del database. Questo valore medio viene moltiplicato per il prezzo unitario del PITR (GB-mese). Per maggiori informazioni, consulta Prezzi di archiviazione.

    Lo spazio di archiviazione PITR non ha un livello gratuito e devi aver attivato la fatturazione se vuoi utilizzare PITR.

  • Fatturazione del calcolo: tutte le query che esegui durante la finestra PITR di 7 giorni, tramite letture obsolete o esportazioni, comportano costi per le operazioni di lettura in base al numero di documenti letti. Per ulteriori informazioni, consulta la pagina Prezzi.

  • Fatturazione minima: ti potrebbe essere addebitato fino a un giorno di costo di archiviazione PITR anche se disattivi PITR entro un giorno dall'attivazione.

Passaggi successivi