Fazer backup e restaurar dados
Nesta página, descrevemos como usar o recurso de backups programados do Firestore. Use backups para proteger seus dados contra corrupção de dados no nível do aplicativo ou contra exclusão acidental.
Com os backups, você pode configurar programações de backup para fazer backups diários ou semanais do banco de dados especificado. É possível usar esses backups para restaurar dados em um novo banco de dados.
Sobre backups
Um backup é uma cópia consistente do banco de dados em um determinado momento. O backup contém todos os dados e configurações de índice naquele momento. Um backup não contém políticas de tempo de vida do banco de dados. Um backup reside no mesmo local que o banco de dados de origem.
Os backups têm um período de retenção configurável e são armazenados até que o período de armazenamento expire ou até que você exclua o backup. A exclusão do banco de dados de origem não exclui automaticamente os backups relacionados.
O Firestore armazena metadados relacionados a backups e programações de backups relacionados a um banco de dados. O Firestore retém esses metadados até que todos os backups do banco de dados expirem ou sejam excluídos.
Criar ou manter backups não afeta o desempenho das leituras ou gravações no banco de dados ativo.
Custos
Quando você usa backups, os seguintes itens são cobrados:
- A quantidade de armazenamento usada por cada backup.
- Para uma operação de restauração, a cobrança é feita com base no tamanho do backup.
Para mais detalhes e tarifas exatas, consulte a página de preços.
Antes de começar
Verifique se a cobrança está ativada para o projeto do Google Cloud. Saiba como verificar se o faturamento está ativado em um projeto.Funções exigidas
Para receber as permissões necessárias para gerenciar backups e programações de backup, peça ao administrador para conceder a você um ou mais dos seguintes papéis do Identity and Access Management:
roles/datastore.owner
: acesso total ao banco de dados do FirestoreOs papéis a seguir também estão disponíveis, mas não aparecem no console do Google Cloud. Use a Google Cloud CLI para atribuir esses papéis:
roles/datastore.backupsAdmin
: acesso de leitura e gravação aos backupsroles/datastore.backupsViewer
: acesso de leitura aos backupsroles/datastore.backupSchedulesAdmin
: acesso de leitura e gravação às programações de backuproles/datastore.backupSchedulesViewer
: acesso de leitura a programações de backuproles/datastore.restoreAdmin
: permissões para iniciar operações de restauração.
Criar e gerenciar programações de backup
Os exemplos abaixo demonstram como configurar uma programação de backup. Para cada banco de dados, é possível configurar até uma programação de backup diária e uma semanal. Não é possível configurar várias programações de backups semanais para diferentes dias da semana.
Não é possível configurar a hora exata do backup. Os backups são feitos em horários diferentes todos os dias. Para programações de backup semanais, configure o dia da semana para fazer um backup.
Criar uma programação de backup
Para criar uma programação de backup para um banco de dados, use o comando gcloud alpha firestore backups schedules create
.
Criar uma programação de backup diária
Para criar uma programação de backup diária, defina a flag --recurrence
como daily
:
gcloud alpha firestore backups schedules create \ --database='DATABASE_ID' \ --recurrence=daily \ --retention=RETENTION_PERIOD
Substitua:
DATABASE_ID
: o ID do banco de dados para fazer backup. Defina como(default)
para o banco de dados padrão.RETENTION_PERIOD
: defina um valor de até 14 semanas (14w
).
Criar uma programação de backup semanal
Para criar uma programação de backup semanal, defina a flag --recurrence
como weekly
:
gcloud alpha firestore backups schedules create \ --database='DATABASE_ID' \ --recurrence=weekly \ --retention=RETENTION_PERIOD \ --day-of-week=DAY
Substitua:
DATABASE_ID
: o ID do banco de dados para fazer backup. Defina como(default)
para o banco de dados padrão.RETENTION_PERIOD
: defina um valor de até 14 semanas (14w
).DAY
: o dia da semana em que o backup será feito. Defina como um dos seguintes:SUN
para domingoMON
para segunda-feiraTUE
para terça-feiraWED
para quarta-feiraTHU
para quinta-feiraFRI
para sexta-feiraSAT
para sábado
Listar programações de backup
Para listar todas as programações de backup de um banco de dados, use o comando gcloud alpha firestore backups schedules list
.
Esse comando retorna informações sobre todas as programações de backup.
gcloud alpha firestore backups schedules list \ --database='DATABASE_ID'
Substitua DATABASE_ID
pelo ID do banco de dados. Use
(default)
para o banco de dados padrão.
Descrever a programação de backup
Para recuperar informações sobre uma programação de backup, use o
comando gcloud alpha firestore backups schedules describe
:
gcloud alpha firestore backups schedules describe \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID
Substitua:
DATABASE_ID
: o ID do banco de dados para fazer backup. Defina como(default)
para o banco de dados padrão.BACKUP_SCHEDULE_ID
: o ID de uma programação de backup. É possível ver o ID de cada programação de backup ao listar todas as programações de backup.
Atualizar uma programação de backup
Para atualizar o período de armazenamento de uma programação de backup, use o
comando gcloud alpha firestore backups schedules update
:
gcloud alpha firestore backups schedules update \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID --retention=RETENTION_PERIOD
Substitua:
DATABASE_ID
: o ID do banco de dados para fazer backup. Defina como(default)
para o banco de dados padrão.BACKUP_SCHEDULE_ID
: o ID de uma programação de backup. É possível ver o ID de cada programação de backup ao listar todas as programações de backup.RETENTION_PERIOD
: defina um valor de até 14 semanas (14w
).
Excluir uma programação de backup
Para excluir uma programação de backup, use o
comando gcloud alpha firestore backups schedules delete
:
gcloud alpha firestore backups schedules delete \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID
Substitua:
DATABASE_ID
: o ID do banco de dados para fazer backup. Defina como(default)
para o banco de dados padrão.BACKUP_SCHEDULE_ID
: o ID de uma programação de backup. É possível ver o ID de cada programação de backup ao listar todas as programações de backup.
A exclusão de uma programação de backup não remove os já criados por ela. É possível aguardar até que eles expirem após o período de armazenamento ou excluir um backup manualmente. Consulte Excluir backup.
Gerenciar backups
Listar backups
Para listar os backups disponíveis, use o
comando gcloud alpha firestore backups list
:
gcloud alpha firestore backups list \ --format="table(name, database, state)"
A flag --format="table(name, database, state)"
formata a saída em um formato mais legível.
Para listar apenas os backups de um local específico, use a flag --location
:
gcloud alpha firestore backups list \ --location=LOCATION \ --format="table(name, database, state)"
Substitua LOCATION
pelo nome de um local do Firestore.
Descrever um backup
Para mais detalhes sobre um backup, use o
comando gcloud alpha firestore backups describe
:
gcloud alpha firestore backups describe \ --location=LOCATION \ --backup=BACKUP_ID
LOCATION
: o local do banco de dados.BACKUP_ID
: o ID de um backup. É possível ver o ID de cada backup ao listar todos os backups.
Excluir backup
Para excluir um backup, use o comando gcloud alpha firestore backups delete
:
gcloud alpha firestore backups delete \ --location=LOCATION \ --backup=BACKUP_ID
LOCATION
: o local do banco de dados.BACKUP_ID
: o ID de um backup. É possível ver o ID de cada backup ao listar todos os backups.
Restaurar dados de um backup de banco de dados
As operações de restauração gravam os dados de um backup em um novo banco de dados
do Firestore. Para iniciar uma operação de restauração, use o comando gcloud alpha firestore databases restore
:
gcloud alpha firestore databases restore \ --source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \ --destination-database='DATABASE_ID'
PROJECT_ID
: o ID do projeto.LOCATION
: o local do backup do banco de dados e o local do novo banco de dados criado para os dados restaurados.BACKUP_ID
: o ID de um backup. É possível ver o ID de cada backup ao listar todos os backups.DATABASE_ID
: um ID do novo banco de dados. Não é possível usar um ID de banco de dados que já está em uso. O modo do banco de dados corresponde ao modo do backup.
A saída vai incluir os componentes metadata
, name
e response
:
metadata: '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID database: projects/PROJECT_ID/databases/DATABASE_ID operationState: PROCESSING progressPercentage: completedWork: '20' estimatedWork: '100' startTime: '2023-12-06T14:20:17.398325Z' name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid response: '@type': type.googleapis.com/google.firestore.admin.v1.Database createTime: '2023-12-06T14:20:17.398325Z' name: projects/PROJECT_ID/databases/DATABASE_ID ...
O campo metadata
inclui um componente progressPercentage
, detalhando o progresso estimado da restauração até o momento e um operationState
especificando
o estado geral da restauração.
Para recuperar essas informações novamente, use gcloud firestore operations list
:
gcloud firestore operations list --database=DATABASE_ID
ou usando o campo name
da saída descrita acima, com gcloud firestore operations describe
:
gcloud firestore operations describe OPERATION_NAME