Vista geral da recuperação pontual (PITR)

A recuperação pontual (PITR) protege contra a eliminação ou a escrita acidental. A PITR mantém versões dos seus documentos de datas/horas anteriores. Por exemplo, no caso de um programador enviar dados incorretos, eliminações ou escritas acidentais, a PITR pode recuperar os dados para um momento no passado (até um máximo de 7 dias).

Para qualquer base de dados em direto que siga as práticas recomendadas, a utilização da PITR não afeta o desempenho das leituras nem das escritas.

Intervalo PITR

Depois de ativar a PITR, o Firestore começa a reter dados da PITR. Os dados de PITR são retidos durante 7 dias no período de PITR.

Pode ler dados de uma data/hora com base no momento em que a PITR foi ativada:

Estado da ativação da PITR Dados PITR mais antigos disponíveis
Desativado 1 hora antes da hora do pedido de leitura
ativada no prazo de 7 dias 1 hora antes de a PITR ter sido ativada
ativada há mais de 7 dias 7 dias antes da hora do pedido de leitura

É retida uma única versão por minuto na janela PITR. Pode ler documentos com uma granularidade de minutos através de uma indicação de tempo de um minuto inteiro. As leituras que não estão ao nível de detalhe dos minutos, como 2023-05-30 09:00:00.1234AM, devolvem um erro a indicar que o read_time é demasiado antigo.

Apenas é retida uma versão de um documento em caso de várias escritas. Por exemplo, se um documento tiver várias escritas que variam de v1, v2, ... vk entre a data/hora 2023-05-30 09:00:00AM (exclusiva) e a data/hora 2023-05-30 09:01:00AM (inclusive), um pedido de leitura na data/hora 2023-05-30 09:01:00AM devolve a versão vk do documento.

Pode ler a partir dos dados criados durante o período PITR. Os dados são armazenados com um nível de detalhe de um minuto e pode recuperar dados com o mesmo nível de detalhe. A funcionalidade PITR está desativada por predefinição.

O campo earliestVersionTime da sua base de dados especifica a hora de leitura permitida mais antiga para os seus dados.

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

Formas de recuperar dados

Existem várias formas de recuperar dados:

  • Para recuperar uma parte da base de dados, execute uma leitura desatualizada especificando uma condição de consulta ou usando a pesquisa direta de chaves juntamente com uma data/hora no passado, e, em seguida, escreva os resultados novamente na base de dados ativa. Normalmente, esta opção é usada para operações cirúrgicas numa base de dados em tempo real. Por exemplo, se eliminar acidentalmente um determinado documento ou atualizar incorretamente um subconjunto de dados, pode recuperá-lo com este método. Para ver instruções, consulte o artigo sobre como recuperar uma parte da base de dados.

  • Para recuperar toda a base de dados, use uma das seguintes opções:

    • Clonar a base de dados para criar uma cópia da base de dados numa data/hora específica.

    • Exporte a base de dados e especifique uma data/hora no passado. Em seguida, importe-a para uma nova base 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.

    Pode clonar ou exportar dados PITR em que a data/hora é uma data/hora completa no minuto nos últimos sete dias, mas não antes de earliestVersionTime.

Preços

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

  • Armazenamento: o Firestore mede o tamanho da base de dados diariamente. Durante o período de um mês, estes pontos de amostragem são calculados em média para determinar o tamanho do armazenamento da base de dados. Este valor médio é multiplicado pelo preço unitário do PITR (GB-mês). Consulte os preços de armazenamento para mais informações.

    O armazenamento PITR não tem um nível gratuito e tem de ter a faturação ativada se quiser usar o PITR.

  • Faturação de computação: todas as consultas que fizer durante o período PITR de 7 dias, quer através de leituras desatualizadas ou exportações, incorrem em custos de operação de leitura com base no número de documentos lidos. Consulte os preços para mais informações.

  • Faturação mínima: pode ser-lhe cobrado até 1 dia do custo de armazenamento da PITR, mesmo que a desative no prazo de um dia após a ativação.

O que se segue?