Como fazer backup e a restauração

Esta página descreve como fazer o backup e a restauração dos dados armazenados pelo aplicativo no Google Cloud Datastore.

Antes de começar

  1. Crie um intervalo de armazenamento para o projeto, caso ainda não tenha feito isso. Se quiser, verifique se a conta de serviço padrão do App Engine do projeto tem acesso ao intervalo por meio da Access Control List. É possível que essa opção esteja definida por padrão. Ela pode ser modificada, se necessário.
  2. Ative o acesso ao Cloud Datastore Admin, caso ainda não tenha feito isso.

Como fazer backup de dados

Para criar um arquivo de backup para futuras restaurações de dados ou para exportação:

  1. (Recomendado) Desative as gravações do Cloud Datastore.
  2. Acesse a página Admin.

    Acesse a página "Admin"

  3. Clique em Abrir o Datastore Admin.

  4. Selecione os tipos de entidade dos quais quer fazer backup.

  5. Clique em Fazer backup de entidades para exibir o formulário de backup.

  6. Observe que o nome do backup é fornecido e inclui um registro de data.

    É preciso alterar esse valor se você fizer mais de um backup por dia, porque ele não será realizado se já houver um backup com o mesmo nome.

  7. A fila padrão é usada para o job de backup. Ela pode ser usada na maioria dos casos.

    Se você usar uma fila não padrão para backup/restauração, poderá especificar somente o destino ah-builtin-python-bundle em queue.yaml. Você não poderá usar outros destinos.

  8. Selecione o Google Cloud Storage como local de armazenamento do backup.

  9. Ao selecionar o Cloud Storage, você precisará fornecer o nome do intervalo em que os backups serão armazenados, no formato [BUCKET_NAME]. Se quiser, especifique o nome do intervalo usando uma estrutura de diretório como sufixo, como [BUCKET_NAME]/backups/foo. Se essas pastas ainda não existirem, elas serão criadas.

  10. Para iniciar os jobs de backup, clique em Fazer backup de entidades. Uma página de status do job será exibida. Status da tarefa de backup

  11. Clique em Voltar para o Datastore Admin para ver o status do backup.

  12. Após a conclusão do backup, ative novamente as gravações do Cloud Datastore caso estejam desativadas.

Como cancelar um backup

Se as tarefas de backup estiverem em execução no momento, elas serão exibidas na lista Backups pendentes na tela do Cloud Datastore Admin.

Para interromper a execução desses backups:

  1. Acesse a página Admin.

    Acesse a página "Admin"

  2. Clique em Abrir o Datastore Admin.

  3. Na seção Backups pendentes, selecione o backup na lista e clique em Cancelar.

Ao cancelar uma tarefa de backup, o App Engine tenta excluir os dados de backup salvos até esse ponto. Entretanto, há casos em que alguns arquivos podem permanecer após o cancelamento. Você pode encontrar esses arquivos no local escolhido para os backups no Google Cloud Storage e exclui-los com segurança após a conclusão do cancelamento. O nome desses arquivos começa com o seguinte padrão: datastore_backup_[BUCKET_NAME].

Como encontrar informações sobre um backup

Talvez você precise encontrar detalhes sobre um backup, tais como quais tipos de entidade ele contém, onde ele foi salvo no Google Cloud Storage e a hora de início e fim. Para exibir essas informações de backup:

  1. Acesse a página Admin.

    Acesse a página "Admin"

  2. Clique em Abrir o Datastore Admin.

  3. Selecione um ou mais backups na lista Backups ou Backups pendentes.

  4. Clique em Informações para exibir as informações sobre esses backups.

  5. Clique em Voltar para retornar à tela principal do Cloud Datastore Admin.

Como restaurar dados

Para restaurar a partir de um backup:

  1. (Recomendado) Desative as gravações do Cloud Datastore no aplicativo. Geralmente, é bom fazer isso para evitar conflitos entre a restauração e os dados novos gravados no Cloud Datastore.
  2. Acesse a página Admin.

    Acesse a página "Admin"

  3. Clique em Abrir o Datastore Admin.

  4. Na lista de backups disponíveis, selecione o backup que quer restaurar.

  5. Clique em Restaurar.

  6. Na página de consulta exibida, veja a lista de entidades com caixas de seleção. Por padrão, todas as entidades serão restauradas. Desmarque a caixa de seleção ao lado de cada entidade que não queira restaurar.

  7. Ainda na página de consulta, observe que a fila padrão, com as definições de desempenho pré-configuradas, é usada para o job de restauração. Se você precisar de outras características de desempenho da fila, altere para uma fila que tenha sido configurada de outra forma. Certifique-se de que ela não tenha destinos especificados em queue.yaml diferentes de ah-builtin-python-bundle.

  8. Inicie a restauração clicando em Restaurar. Uma página de status do job será exibida.

  9. Clique em Voltar para o Datastore Admin para ver o status da restauração. Restaurar o status

  10. Após a conclusão da restauração, ative novamente as gravações do Cloud Datastore no seu aplicativo caso estejam desativadas.

Como restaurar dados em outro aplicativo

Se você fizer backup dos dados usando o Google Cloud Storage, poderá restaurar os backups em aplicativos diferentes do usado para criar o backup.

Para restaurar os dados de backup de um aplicativo de origem em um aplicativo de destino:

  1. Crie uma política de gerenciamento de identidade e acesso (IAM) no intervalo de armazenamento do aplicativo de origem com a seguinte permissão:

    • membro: [PROJECT_ID]@appspot.gserviceaccount.com
    • papéis: Storage Legacy Bucket Reader e Storage Legacy Object Reader

    em que [PROJECT_ID] é o código do projeto do aplicativo de destino.

  2. Faça um novo backup no aplicativo de origem.

  3. (Recomendado) Desative as gravações do Cloud Datastore no aplicativo de destino para evitar conflitos entre os dados restaurados e os dados novos gravados no Cloud Datastore.

  4. Acesse a página Admin do aplicativo de destino.

    Acessar a página "Admin"

  5. Clique em Abrir o Datastore Admin.

  6. Na caixa de texto ao lado do botão Importar informações de backup, especifique o intervalo do aplicativo de origem em que está o backup no formato /gs/[BUCKET_NAME]. Backup de intervalo de armazenamento
    Se preferir, forneça o identificador de arquivo de um backup específico. Para exibi-lo, abra a página Administrador no aplicativo de origem, selecione o backup e clique em Informações. Você verá o identificador do arquivo ao lado de Identificador.

  7. Clique em Importar informações do backup.
    A página de seleção resultante mostra os backups disponíveis para o intervalo especificado, a menos que você tenha especificado um backup pelo identificador. Selecione o backup desejado e clique em uma das seguintes opções:

    • Adicionar à lista de backups, se quiser que ele seja mantido na lista de backups disponíveis do aplicativo.
    • Restaurar a partir do backup, se preferir restaurar deste backup, mas não quiser que ele seja exibido na lista de backups disponíveis do aplicativo.
  8. Na página de consulta exibida, veja a lista de entidades com caixas de seleção. Por padrão, todas as entidades serão restauradas. Desmarque a caixa de seleção ao lado de cada entidade que não queira restaurar.

  9. Ainda na página de consulta, observe que a fila padrão, com as definições de desempenho pré-configuradas, é usada para o job de restauração. Altere para uma fila que tenha sido configurada de maneira diferente se precisar de outras características de desempenho da fila.

  10. Inicie a restauração clicando em Restaurar. Uma página de status do job será exibida.

  11. Após a conclusão da restauração, ative novamente as gravações do Cloud Datastore caso estejam desativadas.

Como visualizar o uso de recursos

Backups muito frequentes geralmente levam a custos mais altos. Quando você executa uma tarefa do Cloud Datastore Admin, na verdade, está executando uma tarefa subjacente do MapReduce. Os jobs do MapReduce causam o aumento das horas da instância de front-end além das operações e do uso de armazenamento.

Para ver o uso dos recursos:

  1. Acesse a página App Engine no Console do GCP.

    Acessar a página “App Engine”

  2. Use os menus suspensos na parte superior da página para selecionar o serviço default e a versão ah-builtin-python-bundle.

Considerações sobre backup e restauração

O recurso de backup e restauração tem como finalidade ajudar você a recuperar exclusões acidentais de dados e permitir que você exporte dados. É possível fazer backup de todas as entidades ou apenas dos tipos selecionados, além de restaurar a partir de um desses backups quando necessário.

Os backups são salvos no Cloud Storage.

O backup não contém nenhum índice. Ao fazer uma restauração, os índices necessários são automaticamente recriados usando as definições de índice enviadas com o aplicativo.

Você também pode usar arquivos de backup para exportar seus dados para outros serviços do Google Cloud Platform, como o BigQuery.

As restaurações não atribuem novos códigos às entidades. Elas usam os códigos que existiam no momento do backup e substituem as entidades existentes pelo mesmo código. Durante uma restauração, os códigos são reservados à medida que as entidades são restauradas. Isso deve evitar conflitos de códigos com novas entidades se as gravações estiverem habilitadas enquanto uma restauração é executada. As novas entidades adicionadas desde o backup são mantidas.

Você pode restaurar todos os dados de um backup ou restaurar tipos de entidades específicos do backup. Além disso, você também pode usar esse recurso para restaurar um backup dos dados de um aplicativo em outro aplicativo, desde que você use o Google Cloud Storage para os backups.

Próximas etapas

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Datastore