Visão geral da recuperação pontual (PITR)

A recuperação pontual (PITR) do Cloud Firestore oferece proteção contra exclusão ou gravação acidental. O PITR mantém versões de seus documentos com carimbos de data/hora anteriores. Por exemplo, no caso de um desenvolvedor enviar dados incorretos, exclusões ou gravações acidentais, o PITR pode recuperar os dados para um momento no passado (até um máximo de 7 dias) sem problemas.

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

Janela PITR

Depois de ativar o PITR, o Cloud Firestore começa a reter os dados do PITR. Os dados PITR são retidos por 7 dias na janela PITR.

Você pode ler dados para um carimbo de data/hora com base em quando o PITR foi ativado:

Status de ativação do PITR Dados PITR mais antigos disponíveis
Desabilitado 1 hora antes do horário da solicitação de leitura
ativado em 7 dias 1 hora antes do PITR ser ativado
ativado há mais de 7 dias 7 dias antes do momento da solicitação de leitura

Uma única versão por minuto é retida na janela PITR. Você pode ler documentos com granularidade mínima usando um carimbo de data/hora de minuto inteiro. Leituras que não têm granularidade de minuto, por exemplo 2023-05-30 09:00:00.1234AM , retornarão um erro informando que o read_time é muito antigo.

Apenas uma versão de um documento é retida no caso de múltiplas 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) e 2023-05-30 09:01:00AM (inclusive) carimbo de data/hora, um solicitação de leitura no carimbo de data / hora 2023-05-30 09:01:00AM retorna a versão vk do documento.

Você pode ler os dados criados durante a janela PITR. Os dados são armazenados com granularidade mínima e você pode recuperar dados com a mesma granularidade. O recurso Cloud Firestore PITR está desativado por padrão.

O campofirstVersionTime do seu banco de dados especifica o primeiro tempo de leitura permitido para seus dados.

Independentemente de o PITR estar ativado ou não, você pode ler (mas não exportar) documentos em qualquer carimbo de data/hora com granularidade de microssegundos na última hora, mas não antes do primeiroVersionTime.

Maneiras de recuperar dados

Existem duas maneiras de recuperar dados:

  • Para recuperar uma parte do banco de dados , execute uma leitura obsoleta especificando uma condição de consulta ou usando pesquisa direta de chave junto com um carimbo de data/hora no passado e, em seguida, grave os resultados de volta no banco de dados ativo. Isso normalmente é usado para 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 obter instruções, consulte recuperando uma parte do seu banco de dados .

  • Para recuperar o banco de dados inteiro , exporte o banco de dados especificando um carimbo de data/hora no passado e depois importe-o para um novo banco de dados. A operação de exportação PITR suporta todos os filtros, incluindo a exportação de todos os documentos e a exportação de coleções específicas. Você pode exportar dados 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 mais antigoVersionTime.

Preços

Considere as seguintes informações de preço antes de ativar o 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, é calculada a média desses pontos de amostra para calcular o tamanho de armazenamento do banco de dados. Esse valor médio é multiplicado pelo preço unitário do PITR (GB-mês). Consulte preços de armazenamento para obter mais informações.

    O armazenamento PITR não tem um nível gratuito e você deve ter o faturamento ativado se quiser usar o PITR.

  • Faturamento de cálculo: quaisquer consultas feitas durante a janela PITR de 7 dias, seja por meio de leituras obsoletas ou exportações, incorrem em custos de operação de leitura com base no número de documentos lidos. Consulte preços para obter mais informações.

  • Faturamento mínimo: poderá ser cobrado até 1 dia do custo de armazenamento do PITR, mesmo se você desativar o PITR um dia após a ativação.

Qual é o próximo