Os usuários do plano Blaze podem configurar o Firebase Realtime Database para fazer backups automáticos. Esse recurso de autoatendimento permite backups diários de dados do aplicativo do Database e das regras no formato JSON em um bucket do Cloud Storage.
Configuração
Para começar, acesse a guia Backups na seção Database do Console do Firebase. Você verá as instruções no assistente para a configuração dos backups automatizados.
Por padrão, ativamos a compactação Gzip para reduzir os custos de armazenamento. É possível ativar a política de ciclo de vida de 30 dias no bucket para que os backups com mais de 30 dias sejam excluídos automaticamente.
Visualize o status e a atividade de backup diretamente no Console do Firebase, onde também é possível iniciar um backup manual. Isso pode ser útil caso precise de snapshots de um horário específico ou como uma medida de segurança antes de alterar o código.
Após a configuração, um novo bucket do Cloud Storage é criado com a permissão WRITER para o Firebase. Nesse bucket, não armazene dados que o Firebase possa acessar. O Firebase não terá acesso aos demais buckets do Cloud Storage ou a outras áreas do Google Cloud.
Restaurar a partir de um backup
Para restaurar o Firebase de um backup, primeiro faça o download do arquivo do Cloud Storage para o disco local. Basta clicar no nome do arquivo na seção de atividade de backup ou na interface do bucket do Cloud Storage. É necessário descompactar o arquivo, caso ele seja um arquivo Gzip.
Há duas maneiras de importar os dados:
Método 1: clique no botão "Importar JSON" na seção Dados do Database e selecione o arquivo de dados JSON do aplicativo.
Método 2: você também pode executar uma solicitação CURL na linha de comando.
Primeiro, recupere uma chave secreta do Firebase, que pode ser obtida na página Configurações de banco de dados.
Em seguida, insira estas informações no terminal, substituindo os campos DATABASE_NAME e SECRET pelos seus valores:
curl 'https://<DATABASE_NAME>.firebaseio.com/.json?auth=<SECRET>&print=silent' -x PUT -d @<DATABASE_NAME>.json
Se tiver problemas para restaurar o backup de um banco de dados muito grande, entre em contato com a nossa equipe de suporte.
Como fazer a programação
O backup diário do Database é definido em um horário específico que garante uma carga balanceada e maior disponibilidade para todos os clientes. Essa programação ocorrerá independentemente dos backups manuais que você faz ao longo do dia.
Como nomear arquivos
Os arquivos transferidos para o bucket do Cloud Storage são marcados com um carimbo de data/hora (padrão ISO 8601) e usam as seguintes convenções de nomenclatura:
- Dados do banco de dados:
YYYY-MM-DDTHH:MM:SSZ_<DATABASE_NAME>_data.json - Regras do banco de dados:
YYYY-MM-DDTHH:MM:SSZ_<DATABASE_NAME>_rules.json
Caso a Gzip esteja ativada, um sufixo .gz será anexado aos nomes de arquivos. Localize facilmente os backups de uma data ou hora específica usando a pesquisa de prefixos do Cloud Storage.
Compactação Gzip
Por padrão, compactamos os arquivos de backup com a Gzip para reduzir os custos de armazenamento e diminuir o tempo de transferência. O tamanho do arquivo compactado varia de acordo com as características dos dados do banco de dados. No entanto, os bancos de dados comuns podem chegar a ⅓ do tamanho original, reduzindo os custos de armazenamento e diminuindo o tempo de upload dos backups.
Para descompactar os arquivos JSON, execute o binário gunzip na linha de comando, que é fornecido por padrão no OS-X e na maioria das distribuições do Linux.
gunzip <DATABASE_NAME>.json.gz # Will unzip to <DATABASE_NAME>.json
Ciclo de vida de 30 dias do armazenamento
Oferecemos um switch fácil de configurar com uma política padrão de ciclo de vida de 30 dias para o bucket do Cloud Storage. Com esse recurso ativado, os arquivos do bucket são excluídos automaticamente após 30 dias. Isso ajuda a diminuir o número de backups antigos e indesejados, reduzir os custos de armazenamento e manter o diretório do bucket limpo. Se você coloca outros arquivos no bucket de backups automatizados, eles também são excluídos com a mesma política.
Custos
O recurso de backups pode ser ativado para projetos no plano Blaze sem custo adicional. No entanto, você receberá cobranças de acordo com as tarifas padrão dos arquivos de backup armazenados no bucket do Cloud Storage. É possível ativar a compactação Gzip e o ciclo de vida de 30 dias do armazenamento para reduzir os custos com armazenamento.