Exportar um arquivo DMP

Para criar um arquivo binário portátil de um banco de dados do AlloyDB para PostgreSQL que possa ser restaurado posteriormente usando a ferramenta pg_restore, exporte o banco de dados para um arquivo DMP de formato personalizado usando pg_dump.

O procedimento para realizar a exportação envolve estas tarefas:

  1. Crie um bucket do Cloud Storage para armazenar o arquivo DMP.

  2. Prepare um host cliente para realizar a operação de exportação.

  3. Exporte o banco de dados para o arquivo DMP.

  4. Limpe os recursos criados para realizar o procedimento.

Antes de começar

  • Você precisa ter o papel básico do IAM de Proprietário (roles/owner) ou Editor (roles/editor) no projeto do Google Cloud que está usando ou ter estes papéis predefinidos do IAM:
    • Administrador do AlloyDB (roles/alloydb.admin) ou Leitor do AlloyDB (roles/alloydb.viewer)
    • Administrador do Storage (roles/storage.admin)
    • Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1)

Criar um bucket do Cloud Storage

Crie um bucket de armazenamento regional padrão no projeto e na região em que está o banco de dados AlloyDB.

Preparar um host cliente

Para preparar um host cliente para realizar a operação de exportação, crie uma VM do Compute Engine que possa se conectar à instância principal do AlloyDB em que o banco de dados está localizado e instale a ferramenta pg_dump e a Google Cloud CLI nessa VM.

  1. Siga as instruções em Conectar um cliente psql a uma instância para criar uma VM do Compute Engine com a conectividade adequada e a ferramenta pg_dump instalada. Ao seguir estas instruções, aloque armazenamento local suficiente para a VM do Compute Engine para acomodar o arquivo DMP que você vai criar.

  2. Instale a CLI gcloud para fornecer acesso de linha de comando para criar o arquivo DMP no bucket do Cloud Storage.

Exportar o banco de dados

Para exportar o banco de dados para um arquivo DMP, você recebe o endereço IP da instância primária do AlloyDB em que o banco de dados está localizado e, em seguida, usa a ferramenta pg_dump.

  1. Para conferir o endereço IP da instância principal do AlloyDB em que o banco de dados está, acesse os detalhes dela.
  2. Conecte-se por SSH à VM do Compute Engine.

    Console

    1. No console do Google Cloud , acesse a página Instâncias de VM.

      Acessar instâncias de VM

    2. Na lista de instâncias de máquina virtual, clique em SSH na linha da instância que você criou.

      Botão "SSH" ao lado do nome da instância.

    gcloud

    Use o comando gcloud compute ssh para se conectar à instância que você criou.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto que contém a instância.
    • ZONE: o nome da zona em que a instância está localizada.
    • VM_NAME: o nome da instância
  3. Exporte o banco de dados para um arquivo DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

    Será necessário inserir a senha do usuário postgres.

    Substitua:

    • IP_ADDRESS: o endereço IP da instância principal.
    • -F custom: define o formato do arquivo DMP como um arquivo de formato personalizado que pode ser importado posteriormente usando a ferramenta pg_restore.
    • DB_NAME: o nome do banco de dados que você quer exportar.
    • DMP_FILE_NAME: forneça um nome para o arquivo DMP a ser criado no sistema de arquivos local do host do cliente.

    Para informações sobre outras opções compatíveis com o comando pg_dump, consulte a documentação do PostgreSQL pg_dump.

  4. Copie o arquivo DMP para o bucket do Cloud Storage que você criou anteriormente: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Limpar recursos

Depois de exportar o arquivo DMP, exclua a VM do Compute Engine usada durante o procedimento de exportação.

A seguir