Importar um arquivo DMP

Esta página descreve como importar para um banco de dados do AlloyDB um arquivo DMP criado pela ferramenta pg_dump usando o formato custom ou directory.

Para importar um arquivo criado pela ferramenta pg_dump usando o formato plain, consulte Importar um arquivo SQL.

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

1. Faça upload do arquivo DMP para um bucket do Cloud Storage.

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

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

4. Limpe os recursos criados para realizar o procedimento.

Fazer upload do arquivo DMP

Para enviar o arquivo DMP, crie um bucket do Cloud Storage e faça o upload do arquivo para ele.

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

2. Faça o upload do arquivo DMP para o bucket de armazenamento que você criou.

Preparar um host de cliente

Para preparar um host cliente para realizar a operação de importaçã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_restore 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_restore instalada. Ao seguir estas instruções, aloque armazenamento local suficiente para a VM do Compute Engine acomodar o arquivo da DMP que você está importando.

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

Importar o arquivo DMP

Para importar o arquivo DMP, receba o endereço IP da instância primária do AlloyDB em que o banco de dados está localizado e use a ferramenta pg_restore para importar o arquivo para o banco de dados.

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

   Console

   1. No console 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.

      

   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. Copie o arquivo DMP para o sistema de arquivos local do host do cliente:

   gcloud storage cp gs://BUCKET_NAME/DMP_FILE_NAME .

4. Execute o comando a seguir para criar um arquivo TOC que comenta todas as instruções EXTENSION:

   pg_restore \
   -l DMP_FILE_NAME | sed -E 's/(.* EXTENSION )/; \1/g' > TOC_FILE_NAME

   • DMP_FILE_NAME: o arquivo DMP no sistema de arquivos local.
   • TOC_FILE_NAME: forneça um nome para o arquivo TOC a ser criado no sistema de arquivos local.
5. Importe o arquivo DMP:

   pg_restore -h IP_ADDRESS -U postgres \
     -d DB_NAME \
     -L TOC_FILE_NAME \
     DMP_FILE_NAME
   

   • IP_ADDRESS: o endereço IP da instância principal.
   • DB_NAME: o nome do banco de dados em que a importação será feita.
   • TOC_FILE_NAME: o arquivo TOC que você criou na etapa anterior.
   • DMP_FILE_NAME: o arquivo DMP.

   O comando pg_restore oferece várias opções adicionais para controlar a operação de importação de dados.

Limpar recursos

Depois de importar o arquivo DMP, você pode excluir o bucket do Cloud Storage e a VM do Compute Engine usada durante o procedimento de importação.