Esta página foi traduzida pela API Cloud Translation.

Restaurar um cluster do AlloyDB de um cofre de backup

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Restaurar um cluster do AlloyDB de um backup armazenado

Para restaurar um cluster do AlloyDB para PostgreSQL com base em um backup armazenado em um cofre, siga estas instruções:

Restaure o backup em um novo cluster do serviço de Backup e DR.
Console
1. No console Google Cloud , acesse a página Backups em cofre.
  - O usuário final precisa ter roles/alloydb.admin no projeto em que o cluster de destino do AlloyDB está localizado.
  - O usuário final precisa ter roles/backupdr.restoreUser no projeto em que o backup de origem está.
  Acessar backups em vault
  
  A página Backups em vault lista apenas os recursos de dados que têm planos de backup aplicados e os backups armazenados em um backup vault dentro desse projeto.
2. Selecione o backup que você quer restaurar. Na página de detalhes do backup ou no menu , selecione Restaurar.
  
  A página Restaurar um backup mostra onde você seleciona as seguintes opções de restauração:
  - O Tipo de recurso é preenchido automaticamente com AlloyDB.
  - Em Nome do recurso, selecione o cluster do AlloyDB a ser restaurado.
  - Ao clicar em Backup, um painel é aberto mostrando todos os backups disponíveis. Selecione o backup específico a ser restaurado.
  - Em Escolher o destino da restauração, selecione o projeto em que você quer restaurar o cluster do AlloyDB.
3. Clique em Continuar.
4. A próxima página mostra os detalhes da restauração até o momento e pede que você Configure um novo cluster: isso cria um novo cluster do AlloyDB com base na configuração armazenada no backup. É possível personalizar o cluster depois que a restauração for concluída. Forneça um novo ID do cluster usando letras minúsculas, números e hifens. Comece com uma letra.
5. Escolha um método de conexão privada: Há dois métodos para conectar serviços em redes VPC hospedadas pelo Google Cloud ou por terceiros, sem atribuir endereços IP externo:
  - Acesso a serviços particulares: atribui o cluster a uma única rede VPC usando uma conexão de peering. Use essa opção ao se conectar a serviços específicos Google Cloud e de terceiros na mesma rede VPC que o cluster do AlloyDB. Isso exige outras APIs.
  - Private Service Connect: permite o acesso ao cluster de uma ou mais redes VPC usando listas de permissão e endpoints do Private Service Connect.
gcloud
```
gcloud beta alloydb clusters restore RESTORED_CLUSTER_ID \
    --project=WORKLOAD_PROJECT_ID \
    --region=REGION \
    --backupdr-backup=BACKUP_NAME
```
Substitua:
- RESTORED_CLUSTER_ID: o ID do novo cluster do AlloyDB que você está restaurando.
- WORKLOAD_PROJECT_ID: o ID do projeto em que você quer restaurar o cluster do AlloyDB.
- REGION: a Google Cloud região em que você quer restaurar o cluster do AlloyDB.
- BACKUP_NAME: o nome do backup que você quer restaurar.
Depois que o Backup e DR terminar de criar o cluster, crie uma instância principal para ele.

Ao criar a nova instância principal, especifique a configuração dela, incluindo tamanho e flags. O Backup and DR não armazena a configuração da instância como parte do backup. Observe que a configuração não precisa corresponder exatamente à da instância primária original.

Quando o Backup e DR terminar de criar a instância, você poderá usá-la para acessar os dados restaurados.
Conclua a configuração do novo cluster configurando instâncias de pool de leitura, se necessário.

Restaurar um cluster do AlloyDB para um momento específico

Para restaurar um cluster do AlloyDB para PostgreSQL para um ponto específico no tempo, siga estas instruções:
Console
1. No console Google Cloud , acesse a página Backups em cofre.
  - O usuário final precisa:
  roles/alloydb.admin no projeto em que o cluster de destino do AlloyDB está localizado.
  
  roles/backupdr.restoreUser no projeto em que o backup de origem existe.
  
  Acessar backups em vault
  
  A página Backups em vault lista apenas os recursos de dados que têm planos de backup aplicados e os backups armazenados em um backup vault dentro desse projeto.
2. Na parte de cima da lista de backups, selecione Restaurar de um ponto no tempo.
  
  O painel Restaurar de um momento no tempo em um novo cluster aparece. É aqui que você seleciona o ponto no tempo para restaurar e os detalhes do novo cluster que será criado:
  - Escolha um momento específico: insira um momento dentro da janela de recuperação do cluster para restaurar os dados dele.
  - Configurar um novo cluster: isso cria um novo cluster do AlloyDB com base na configuração armazenada no backup. É possível personalizar o cluster após a conclusão da restauração.
  Forneça um novo ID do cluster usando letras minúsculas, números e hifens. Comece com uma letra.
3. Escolha um método de conexão particular:
  
  Há dois métodos para conectar serviços em redes VPC hospedadas pelo Google Cloud ou por terceiros, sem atribuir endereços IP externo:
  - Acesso a serviços particulares: atribui o cluster a uma única rede VPC usando uma conexão de peering. Use essa opção ao se conectar a serviços específicos Google Cloud e de terceiros na mesma rede VPC que o cluster do AlloyDB. Isso exige outras APIs.
  - Private Service Connect: permite o acesso ao cluster de uma ou mais redes VPC usando listas de permissão e endpoints do Private Service Connect.
gcloud
1. Restaure o backup em um novo cluster do serviço de Backup e DR. Esse processo tem duas etapas.
  
  Primeiro, encontre o ID da fonte de dados:
  gcloud backup-dr data-source-references fetch-for-resource-type alloydb.googleapis.com/Cluster \ --location=REGION \ --project=WORKLOAD_PROJECT_ID \ --filter='dataSourceGcpResourceInfo.gcp_resourcename="projects/WORKLOAD_PROJECT_NUMBER/locations/REGION/clusters/CLUSTER_NAME'
  Em seguida, faça a restauração pontual
2. Para restaurar o cluster, use o ID da fonte de dados no seguinte script:
  gcloud beta alloydb clusters restore RESTORED_CLUSTER_ID \ --project=WORKLOAD_PROJECT_ID \ --region=REGION \ --backupdr-data-source=projects/VAULT_PROJECT_ID/locations/REGION/backupVaults/BV_ID/dataSources/DS_ID \ --point-in-time=POINT_IN_TIME
  Substitua:
  - WORKLOAD_PROJECT_ID: o ID do projeto em que você quer restaurar o cluster do AlloyDB.
  - REGION: a Google Cloud região em que você quer restaurar o cluster do AlloyDB.
  - RESTORED_CLUSTER_ID: o ID do novo cluster do AlloyDB que você está restaurando.
  - VAULT_PROJECT_ID: o ID do projeto que contém o cofre de backup.
  - BV_ID: o ID do cofre de backup.
  - DS_ID: o ID da fonte de dados.
  - POINT_IN_TIME: o ponto específico no tempo em que você quer restaurar o cluster. Um valor de exemplo é "2025-10-10T10:16:10Z"
Depois que o Backup e DR terminar de criar o cluster, crie uma instância principal para ele.

Ao criar a nova instância principal, especifique a configuração dela, incluindo tamanho e flags. O Backup and DR não armazena a configuração da instância como parte do backup. Observe que a configuração não precisa corresponder exatamente à da instância primária original.

Quando o Backup e DR terminar de criar a instância, você poderá usá-la para acessar os dados restaurados.
Conclua a configuração do novo cluster configurando instâncias de pool de leitura, se necessário.

Listar os backups no backup vault

Liste os backups e selecione o que você quer restaurar. Encontre o ID da fonte de dados e liste todos os backups dela com estes comandos:

      # Find the data source id
      gcloud backup-dr data-source-references fetch-for-resource-type alloydb.googleapis.com/Cluster \
        --location=REGION \
        --project=WORKLOAD_PROJECT_ID \
        --filter='dataSourceGcpResourceInfo.gcp_resourcename="projects/WORKLOAD_PROJECT_NUMBER/locations/REGION/clusters/CLUSTER_NAME "'

      # List backups
      gcloud backup-dr backups list \
        --project=VAULT_PROJECT_ID \
        --location=REGION \
        --backup-vault=BV_ID \
        --data-source='projects/VAULT_PROJECT_ID/locations/REGION/backupVaults/BV_ID/dataSources/DS_ID'

Substitua:

REGION: a Google Cloud região.
WORKLOAD_PROJECT_ID: o ID do projeto em que o cluster do AlloyDB está localizado.
WORKLOAD_PROJECT_NUMBER: o número do projeto em que o cluster do AlloyDB está localizado.
CLUSTER_NAME: o nome do cluster do AlloyDB.
VAULT_PROJECT_ID: o ID do projeto que contém o cofre de backup.
BV_ID: o ID do cofre de backup.
DS_ID: o ID da fonte de dados.

Restaurar um cluster do AlloyDB de um cofre de backup Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.