Informações gerais da recuperação pontual (PITR, na sigla em inglês)

A recuperação pontual (PITR, na sigla em inglês) do Cloud Firestore oferece proteção contra gravações ou exclusões acidentais. A PITR mantém versões dos seus documentos de carimbos de data/hora passados. Por exemplo, no caso de um desenvolvedor enviar dados incorretos, exclusões ou gravações acidentais, o PITR pode recuperar os dados em um momento no passado (até um máximo de sete dias) sem problemas.

Para qualquer banco de dados ativo que siga as práticas recomendadas, o uso da PITR não afeta o desempenho das leituras ou gravações.

Janela de PITR

Depois que você ativa a PITR, o Cloud Firestore começa a reter dados dela. Os dados da PITR são retidos por sete dias na janela de PITR.

É possível ler os dados de um carimbo de data/hora com base em quando a PITR foi ativada:

Status de ativação da PITR Dados PITR mais antigos disponíveis
Desativado Uma hora antes do horário da solicitação de leitura
ativado nos últimos sete dias 1 hora antes da ativação da PITR
ativado há mais de 7 dias Sete dias antes do horário da solicitação de leitura

Uma única versão por minuto é mantida na janela de PITR. É possível ler documentos com granularidade por minuto usando um carimbo de data/hora de minuto inteiro. As leituras que não forem granularidade por minuto, por exemplo, 2023-05-30 09:00:00.1234AM, vão retornar um erro de que read_time é muito antigo.

Apenas uma versão de um documento é mantida em caso de várias gravações. Por exemplo, se um documento tiver várias gravações variando de v1, v2, ... vk entre 2023-05-30 09:00:00AM (exclusivo) e2023-05-30 09:01:00AM carimbo de data/hora (inclusive), uma solicitação de leitura no carimbo de data/hora 2023-05-30 09:01:00AM retorna a versão vk do documento.

É possível ler os dados criados durante a janela PITR. Os dados são armazenados em granularidade de um minuto e é possível recuperá-los na mesma granularidade. O recurso da PITR do Cloud Firestore fica desativado por padrão.

O campo earliestVersionTime do banco de dados especifica o horário de leitura mais permitido para seus dados.

Independentemente de a PITR estar ativada ou não, é possível ler (mas não exportar) documentos em qualquer carimbo de data/hora com granularidade de microssegundos na última hora, mas não antes do earliestVersionTime.

Maneiras de recuperar dados

Há duas maneiras de recuperar dados:

  • Para recuperar uma parte do banco de dados, realize uma leitura desatualizada especificando uma condição de consulta ou usando a pesquisa de chave direta com um carimbo de data/hora no passado e depois grave os resultados no banco de dados ativo. Isso normalmente é usado em operações cirúrgicas em um banco de dados ativo. Por exemplo, se você excluir acidentalmente um documento específico ou atualizar incorretamente um subconjunto de dados, poderá recuperá-lo com este método. Para receber instruções, consulte Como recuperar uma parte do banco de dados.

  • Para recuperar todo o banco de dados, exporte-o especificando um carimbo de data/hora no passado e importe-o para um novo banco de dados. A operação de exportação da PITR oferece suporte a todos os filtros, incluindo a exportação de todos os documentos e a exportação de coleções específicas. É possível exportar dados da PITR em que o carimbo de data/hora é um carimbo de data/hora de um minuto inteiro nos últimos sete dias, mas não antes do firstVersionTime.

Preços

Considere as seguintes informações de preços antes de ativar a PITR para seu banco de dados:

  • Armazenamento: o Cloud Firestore mede o tamanho do banco de dados diariamente. Durante o período de um mês, a média desses pontos de amostra é feita para calcular o tamanho do armazenamento do banco de dados. Esse valor médio é multiplicado pelo preço unitário de PITR (GB/mês). Consulte os preços de armazenamento para mais informações.

    O armazenamento da PITR não tem um nível sem custos, e é necessário ativar o faturamento se você quiser usar a PITR.

  • Faturamento de computação: todas as consultas feitas durante a janela PITR de sete dias, seja por leituras desatualizadas ou exportações, geram custos de operação de leitura com base no número de documentos lidos. Para mais informações, consulte Preços.

  • Faturamento mínimo: você pode receber uma cobrança de até 1 dia no custo de armazenamento da PITR mesmo se desativá-la dentro de um dia após a ativação.

A seguir