Importar um arquivo SQL

Esta página descreve como importar um arquivo SQL para um banco de dados do AlloyDB.

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

  1. Faça upload do arquivo SQL em um bucket do Cloud Storage.

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

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

  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)

Fazer upload do arquivo SQL

Para fazer upload do arquivo SQL, crie um bucket do Cloud Storage e envie o arquivo SQL para ele.

  1. Crie um bucket de armazenamento regional padrão no projeto e na região em que está localizado o banco de dados AlloyDB. Ao seguir estas instruções, aloque armazenamento local suficiente para a VM do Compute Engine e para acomodar o arquivo SQL que você está importando.

  2. Faça upload do arquivo SQL no bucket de armazenamento criado.

Preparar um host de cliente

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

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

Importar o arquivo SQL

Para importar o arquivo SQL, você recebe o endereço IP da instância principal do AlloyDB em que seu banco de dados está localizado e usa a ferramenta psql para importar o arquivo no banco de dados.

  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. Copie o arquivo SQL para o sistema de arquivos local do host do cliente: 
    gcloud storage cp gs://BUCKET_NAME/SQL_FILE_NAME .
  4. Importe o arquivo SQL: 
    psql -h IP_ADDRESS -U postgres DB_NAME < SQL_FILE_NAME
    • IP_ADDRESS: o endereço IP da instância principal.
    • DB_NAME: o nome do banco de dados para importar.
    • SQL_FILE_NAME: o arquivo SQL enviado.

Limpar recursos

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