Exporte um ficheiro DMP

Esta página descreve como usar a ferramenta pg_dump para exportar uma base de dados do AlloyDB para um ficheiro de arquivo DMP de formato personalizado que pode importar mais tarde com a ferramenta pg_restore.

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

  1. Crie um contentor do Cloud Storage para armazenar o ficheiro DMP.

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

  3. Exporte a base de dados para o ficheiro DMP.

  4. Limpe os recursos criados para realizar o procedimento.

Antes de começar

  • Tem de ter a função básica de IAM de proprietário (roles/owner) ou editor (roles/editor) no Google Cloud projeto que está a usar, ou tem de ter estas funções de IAM predefinidas:
    • Administrador do AlloyDB (roles/alloydb.admin) ou leitor do AlloyDB (roles/alloydb.viewer)
    • Administrador de armazenamento (roles/storage.admin)
    • Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1)

Crie um contentor do Cloud Storage

Crie um contentor de armazenamento padrão ou de armazenamento regional no projeto e na região onde a sua base de dados do AlloyDB está localizada.

Prepare um anfitrião do cliente

Para preparar um anfitrião cliente para realizar a operação de exportação, crie uma VM do Compute Engine que possa estabelecer ligação à instância principal do AlloyDB onde a sua base de dados está localizada e instale a ferramenta pg_dump e a CLI do Google Cloud nessa VM.

  1. Siga as instruções Ligue 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, certifique-se de que atribui armazenamento local suficiente à VM do Compute Engine para acomodar o ficheiro DMP que vai criar.

  2. Instale a CLI gcloud para fornecer acesso à linha de comando para criar o ficheiro DMP no contentor do Cloud Storage.

Exporte a base de dados

Para exportar a base de dados para um ficheiro DMP, obtém o endereço IP da instância principal do AlloyDB onde a base de dados se encontra e, em seguida, usa a ferramenta pg_dump.

  1. Obtenha o endereço IP da instância principal do AlloyDB onde a sua base de dados está localizada vendo os respetivos detalhes.
  2. Estabeleça uma ligação SSH à VM do Compute Engine.

    Consola

    1. Na Google Cloud consola, aceda à página Instâncias de VM.

      Aceder às instâncias de VM

    2. Na lista de instâncias de máquinas virtuais, clique em SSH na linha da instância que criou.

      Botão SSH junto ao nome da instância.

    gcloud

    Use o comando gcloud compute ssh para se ligar à instância que criou.

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

    Substitua o seguinte:

    • 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 a base de dados para um ficheiro DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

    É-lhe pedido que introduza a palavra-passe do utilizador postgres.

    • IP_ADDRESS: o endereço IP da instância principal.
    • -F custom: define o formato do ficheiro DMP como um arquivo de formato personalizado que pode importar posteriormente através da ferramenta pg_restore.
    • DB_NAME: O nome da base de dados que quer exportar.
    • DMP_FILE_NAME: indique um nome de ficheiro para o ficheiro DMP a criar no sistema de ficheiros local do anfitrião do cliente.

    O exemplo acima mostra um comando pg_dump simples. Para obter informações sobre a grande variedade de opções suportadas pelo comando, consulte a documentação do PostgreSQL.

  4. Copie o ficheiro DMP para o contentor do Cloud Storage que criou anteriormente: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Limpe os recursos

Depois de exportar com êxito o ficheiro DMP, pode eliminar a VM do Compute Engine que usou durante o procedimento de exportação.

O que se segue?