Panoramica del recupero point-in-time (PITR)

Si applica alla versione Standard di Firestore e alla versione Enterprise di Firestore.

Il recupero point-in-time (PITR) protegge da eliminazioni o scritture accidentali. PITR conserva le versioni dei documenti dai timestamp precedenti. Ad esempio, nel caso in cui uno sviluppatore inserisca dati errati, elimini o scriva accidentalmente, PITR può recuperare i dati in un momento precedente (fino a un massimo di 7 giorni).

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

Finestra PITR

Dopo aver abilitato 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 a quando è stato abilitato PITR:

Stato di abilitazione PITR Dati PITR disponibili più recenti
Disabilitato 1 ora prima dell'ora della richiesta di lettura
abilitato entro 7 giorni 1 ora prima dell'abilitazione di PITR
abilitato più di 7 giorni fa 7 giorni prima dell'ora della richiesta di lettura

Nella finestra PITR viene conservata una sola versione al minuto. Puoi leggere i documenti con una granularità di un minuto utilizzando un timestamp di un minuto intero. Le letture che non hanno una granularità di un minuto, ad esempio 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 che vanno da v1, v2, ... vk tra 2023-05-30 09:00:00AM (esclusivo) e 2023-05-30 09:01:00AM (inclusivo) timestamp, una richiesta di lettura al timestamp 2023-05-30 09:01:00AM restituisce la versione vk del documento.

Puoi leggere i dati creati durante la finestra PITR. I dati vengono archiviati con una granularità di un minuto e puoi recuperarli con la stessa granularità. La funzionalità PITR è disabilitata 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 di earliestVersionTime.

Modalità di recupero dei dati

Esistono diversi modi per recuperare i dati:

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

  • Per recuperare l'intero database, utilizza una delle seguenti opzioni:

    • Clona il database per creare una copia del database in un timestamp specifico.

    • Esporta il database e specifica un timestamp precedente, quindi 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 clonare o esportare i dati PITR in cui il timestamp è un timestamp di un minuto intero negli ultimi sette giorni, ma non prima di earliestVersionTime.

Prezzi

Prima di abilitare PITR per il database, tieni presente le seguenti informazioni sui prezzi:

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

    L'archiviazione PITR non ha un livello senza costi e devi aver abilitato la fatturazione se vuoi utilizzare PITR.

  • Fatturazione del calcolo: tutte le query eseguite 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 Prezzi.

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

Passaggi successivi