Esta página descreve como criar backups no Spanner. Para mais informações sobre backups, consulte Visão geral de backups. É possível fazer backup de bancos de dados usando o seguinte:
Antes de começar
-
Para ter as permissões necessárias para criar backups, peça ao administrador para conceder a você os seguintes papéis do IAM na instância:
-
Crie, visualize, atualize e exclua backups:
Administrador de backup do Cloud Spanner (
roles/spanner.backupAdmin
) -
Crie e visualize backups:
Gravador de backup do Cloud Spanner (
roles/spanner.backupWriter
)
-
Crie, visualize, atualize e exclua backups:
Administrador de backup do Cloud Spanner (
Os exemplos da CLI gcloud nesta página pressupõem o seguinte:
- Você já configurou a CLI gcloud para uso com o Spanner. Se você nunca usou a CLI gcloud com Spanner, consulte Introdução ao Spanner usando a gcloud CLI.
Você configurou CLI gcloud com seu projeto. Exemplo:
gcloud config set core/project PROJECT_ID
Criar backup
Console
No console do Google Cloud, acesse a página Instâncias do Spanner.
Clique na instância que contém o banco de dados que você quer fazer backup.
Clique no banco de dados.
No painel de navegação, clique em Backup/restauração.
Na guia Backups, clique em Criar backup.
Preencha o formulário e clique em Criar.
Para verificar o progresso de uma operação de backup, consulte Verifique o progresso da operação.
gcloud
Antes de usar os dados do comando abaixo, faça estas substituições:
- INSTANCE_ID: o ID da instância do Spanner.
- DATABASE_ID: o ID do banco de dados do Spanner.
- BACKUP_NAME: o nome do backup do Spanner.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud spanner backups create BACKUP_NAME --instance=INSTANCE_ID --database=DATABASE_ID --retention-period=1y --async
Windows (PowerShell)
gcloud spanner backups create BACKUP_NAME --instance=INSTANCE_ID --database=DATABASE_ID --retention-period=1y --async
Windows (cmd.exe)
gcloud spanner backups create BACKUP_NAME --instance=INSTANCE_ID --database=DATABASE_ID --retention-period=1y --async
Você receberá uma resposta semelhante a esta:
Create request issued for: BACKUP_NAME Check operation [projects/PROJECT_ID/instances/INSTANCE_ID/backups/BACKUP_NAME/operations/_auto_op_234567] for status.
Veja algumas observações de uso:
- Para definir a data de validade do backup, especifique a sinalização
--retention-period
ou--expiration-date
. Para informações sobre a sintaxe da data, consultegcloud topic datetimes
- O nome do backup precisa ser exclusivo na instância.
- O comando retorna imediatamente por causa da sinalização
--async
. Sem a sinalização, o comando aguardará a conclusão da operação de backup. - Especifique a sinalização
--help
para receber ajuda para qualquer comando.
Para verificar o progresso de uma operação de backup, consulte Verifique o progresso da operação.
Bibliotecas de cliente
O exemplo de código a seguir cria um backup em um version_time
específico
e aguarda a conclusão. Após a conclusão, ele verifica se o backup foi
tudo pronto e recupera algumas informações sobre ele, como nome, tamanho e
tempo de criação.
C++
C#
Go
Java
Node.js
PHP
Python
Ruby
A seguir
Para saber mais sobre backups, consulte Visão geral de backups.
Para gerenciar backups, consulte Gerenciar backups.