Nesta página, descrevemos as operações de restauração do Spanner e explicamos como para restaurar um banco de dados. Para mais informações sobre restauração de banco de dados em Spanner, consulte Visão geral da restauração.
É possível restaurar um banco de dados do Spanner usando o seguinte:
- No console do Google Cloud.
- Usando a Google Cloud CLI.
- usando bibliotecas de cliente.
- Usando as APIs REST ou RPC.
Antes de começar
Os exemplos da CLI gcloud nesta página pressupõem o seguinte:
- Você já configurou a gcloud CLI para usar com Spanner. Se você nunca usou a Google Cloud CLI com Spanner, consulte Introdução ao Spanner usando a Google Cloud CLI.
Você configurou a Google Cloud CLI com seu projeto. Exemplo:
gcloud config set core/project PROJECT_ID
Você já tem uma instância chamada
test-instance
e um banco de dados chamadoexample-db
.
-
Para ter as permissões necessárias para restaurar um banco de dados usando um backup, peça ao administrador para conceder a você Papel do IAM Administrador de restauração do Cloud Spanner (
roles/spanner.restoreAdmin
) na instância.
Restaurar um banco de dados a partir de um backup
Console
Acesse a página "Instâncias do Spanner" no console do Google Cloud.
Clique na instância que contém o banco de dados para abrir a página Visão geral correspondente.
Clique no banco de dados para abrir a página Visão geral correspondente.
No painel de navegação, clique em Backup/restauração.
Clique no botão Ações para o backup selecionado e escolha Restaurar.
Preencha o formulário e clique no botão Restaurar.
Para verificar o progresso da operação, consulte o indicador de progresso, conforme mostrado na página de operações:
Se a operação demorar muito, será possível cancelá-la. Para mais informações, consulte Cancelar uma operação de instância de longa duração.
gcloud
Para restaurar um banco de dados, use gcloud spanner databases restore
:
gcloud spanner databases restore --async \
--destination-instance=test-instance --destination-database=example-db-restored \
--source-instance=test-instance --source-backup=example-db-backup-6
Observações sobre o uso:
- O comando retorna imediatamente por causa da sinalização
--async
. Sem a sinalização, o comando aguardará a conclusão da operação de restauração. - Se as instâncias de origem e de destino forem diferentes, elas precisarão ter a mesma configuração de instância.
- Se o banco de dados de destino já existir, a operação falhará.
Bibliotecas de cliente
O exemplo de código a seguir restaura um banco de dados de um determinado backup e aguarda
A operação de restauração (uma operação com RestoreDatabaseMetadata
)
a serem concluídas. O banco de dados restaurado é criado na mesma instância do
backup. Após a conclusão, a amostra recupera e imprime algumas informações de restauração
do banco de dados.
C++
C#
Go
Java
Node.js
PHP
Python
Ruby