A recuperação pontual (PITR, na sigla em inglês) do Cloud Firestore oferece proteção contra exclusão ou gravaçõ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 | |
---|---|---|
Desativada | 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 está 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
- Saiba mais sobre como recuperar dados com a PITR.