Exportar um arquivo DMP

Esta página descreve como usar a ferramenta pg_dump para exportar um banco de dados do AlloyDB para um arquivo DMP de formato personalizado que pode ser importado posteriormente usando a ferramenta pg_restore.

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 de 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

  • É necessário ter a função básica de proprietário (roles/owner) ou editor (roles/editor) do IAM no projeto do Google Cloud que você 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á localizado o banco de dados do AlloyDB.

Preparar um host de cliente

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

  1. Siga as instruções 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 à 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ê precisa conferir o endereço IP da instância primária do AlloyDB em que o banco de dados está localizado e usar a ferramenta pg_dump.

  1. Acesse o endereço IP da instância principal do AlloyDB em que seu banco de dados está localizado confira os detalhes.
  2. Conecte-se por SSH à VM do Compute Engine.

    Console

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

      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 criada.

    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.

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

    O comando pg_dump simples acima. Para saber mais sobre a ampla gama de opções compatíveis com o comando, consulte a documentação do PostgreSQL (em inglês).

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

Limpar recursos

Depois de exportar o arquivo DMP, você pode excluir a VM do Compute Engine usada durante o procedimento de exportação.

A seguir