Migrar um banco de dados para o Cloud SQL para PostgreSQL usando o Database Migration Service

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

Este guia de início rápido mostra como usar o Database Migration Service para migrar dados para o Cloud SQL para PostgreSQL. Os recursos criados neste guia de início rápido normalmente custam menos de um dólar (USD), supondo que você conclua as etapas, incluindo a limpeza, em tempo hábil.

Antes de começar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Database Migration Service API.

   Enable the API

7. Verifique se você tem o papel de administrador de migração do banco de dados atribuído à sua conta de usuário.

   Acessar a página IAM

Requisitos

O Database Migration Service oferece várias opções de banco de dados de origem e métodos de conectividade. Diferentes fontes funcionam melhor com alguns métodos de conectividade do que com outros. Neste guia de início rápido, presumimos que você esteja usando um banco de dados PostgreSQL independente em um ambiente em que seja possível configurar sua rede para adicionar uma regra de firewall de entrada. O banco de dados de origem pode ser local ou em um provedor de nuvem. Como não sabemos as especificidades do seu ambiente, não podemos fornecer etapas detalhadas sobre a configuração de rede.

Neste tutorial, você vai selecionar PostgreSQL como Mecanismo de banco de dados de origem e Permitir IP como o método de rede.

Criar um perfil de conexão de origem

Ao criar um perfil de conexão, você cria um registro que contém informações sobre o banco de dados de origem. O Database Migration Service usa as informações no perfil de conexão para migrar dados do banco de dados de origem para a instância de banco de dados do Cloud SQL.

1. Acesse a página "Perfis de conexão do Database Migration Service" no console do Google Cloud.

   Acessar a página "Perfis de conexão do serviço de migração de banco de dados"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, na lista Função do perfil, selecione Origem.

4. Na lista Mecanismo de banco de dados, selecione um dos seguintes tipos de classificação do banco de dados de origem:

   • Uma instância autônoma do PostgreSQL (PostgreSQL)
   • Uma instância do Cloud SQL para PostgreSQL (Cloud SQL para PostgreSQL)
   • Uma instância do Amazon RDS para PostgreSQL (Amazon RDS para PostgreSQL)

   Neste guia de início rápido, selecione PostgreSQL.

4. Forneça as seguintes informações:
   • No campo Nome do perfil de conexão, digite um nome para o perfil de conexão do banco de dados de origem, como My Connection Profile.
   • Mantenha o ID do perfil de conexão gerado automaticamente.
   • Insira as informações de conectividade:
     • Se você estiver replicando de um banco de dados auto-hospedado, insira o Nome do host ou endereço IP (domínio ou IP) e a Porta para acessar o host. A porta padrão do PostgreSQL é 5432.
     • Se você estiver replicando de um banco de dados do Cloud SQL, selecione a instância do Cloud SQL na lista suspensa.
   • Insira um Nome de usuário e uma Senha para autenticar na instância de origem.
   • (Opcional) Se você planeja transferir informações sensíveis por uma rede pública (usando listas de permissões de IP), recomendamos usar criptografia SSL/TLS para a conexão entre os bancos de dados de origem e de destino. Caso contrário, mantenha o valor padrão Nenhum.

5. Na seção Região do perfil de conexão da página, selecione a região em que você quer salvar o perfil de conexão.

   Os perfis de conexão, assim como todos os recursos, são salvos em uma região. A seleção da região não afeta quais jobs de migração podem usá-la ou quais regiões podem se conectar ao local dos dados, mas pode afetar a disponibilidade em caso de inatividade regional.

6. Clique em CRIAR.

Criar um job de migração

O Database Migration Service usa jobs de migração para migrar dados da instância de banco de dados de origem para a instância de destino do Cloud SQL.

A criação de um job de migração inclui:

• Como definir as configurações do job
• Selecionar o perfil de conexão que você criou para o banco de dados de origem (perfil de conexão de origem)
• Definir configurações para a instância de banco de dados do Cloud SQL de destino
• Configurar a conectividade entre as instâncias de banco de dados de origem e de destino
• Testar o job de migração para garantir que as informações de conexão fornecidas para o job sejam válidas.

Definir configurações para o job de migração

1. Acesse a página "Jobs de migração do serviço de migração de banco de dados" no console do Google Cloud.

   Acesse a página de jobs de migração do Database Migration Service

2. Clique em CRIAR JOB DE MIGRAÇÃO.

3. No campo Nome do job de migração, digite um nome para o job de migração, como My Migration Job.

4. Mantenha o ID do job de migração gerado automaticamente.

5. Abra a lista suspensa Mecanismo de banco de dados de origem e selecione o tipo de classificação do banco de dados de origem.

6. Selecione a Região de destino em que a instância de destino será criada.

7. Defina o tipo de job de migração como "Contínuo" para que as mudanças contínuas no banco de dados de origem sejam migradas para a instância de banco de dados do Cloud SQL de destino.

8. Revise os pré-requisitos necessários que são gerados automaticamente para refletir como o ambiente precisa estar preparado para um job de migração. Esses pré-requisitos podem incluir como configurar o banco de dados de origem e como conectá-lo à instância de banco de dados do Cloud SQL de destino. É melhor concluir esses pré-requisitos nessa etapa, mas é possível concluí-los a qualquer momento antes de testar ou iniciar o job de migração. Para mais informações sobre esses pré-requisitos, consulte Configurar a origem.

9. Clique em SALVAR E CONTINUAR.

Especificar informações sobre o perfil de conexão de origem

1. Abra a lista suspensa Selecionar perfil de conexão de origem e selecione o perfil de conexão que você criou.

2. Clique em SALVAR E CONTINUAR.

Definir configurações para a instância de destino do Cloud SQL

1. Informe um ID da instância de destino para a instância do Cloud SQL. Por padrão, o ID do job de migração é preenchido automaticamente neste campo. Você pode manter esse nome ou inserir outro.

2. Informe uma senha alfanumérica para a instância de destino do Cloud SQL. Essa será a senha da conta de administrador postgres na instância.

   Insira a senha manualmente ou clique em GERAR para que o Database Migration Service crie uma senha automaticamente.

   Dica:para ver a senha em texto não criptografado, clique no ícone Revelar. O ícone se parece com um olho.

3. Escolha a Versão do banco de dados para a instância de destino na lista de versões compatíveis do Cloud SQL para o mecanismo de banco de dados especificado.

4. Selecione a Zona do Google Cloud desejada para a nova instância do Cloud SQL (ou deixe como "Qualquer").

5. Marque a caixa de seleção IP público porque, neste guia de início rápido, você vai usar a lista de permissões de IP como o método de rede. Esse método funciona configurando o servidor de banco de dados de origem para aceitar conexões do endereço IP de saída da instância do Cloud SQL.

   Para outros métodos de rede, como túnel SSH reverso, peering de VPC ou VPN, selecione a caixa de seleção IP particular.

6. Selecione o Tipo de máquina para a instância do Cloud SQL. O tamanho do disco precisa ser igual ou maior que o tamanho do banco de dados de origem.

7. Defina o Tipo de armazenamento e a Capacidade de armazenamento para a instância do Cloud SQL.

8. Clique em Criar e continuar para criar a nova instância.

9. Clique em CRIAR DESTINO E CONTINUAR na caixa de diálogo seguinte. A criação da instância pode levar vários minutos.

   Importante: esse procedimento cria uma instância do Cloud SQL. A cobrança é feita de acordo com a configuração selecionada.
   Observação: depois que a instância de destino é criada, algumas configurações do job de migração não podem mais ser editadas. Não é possível mudar o motor do banco de dados ou o tipo de migração.

Configurar conectividade

1. Escolha o método de rede que você quer usar para estabelecer a conectividade entre os bancos de dados de origem e de destino. Para este guia de início rápido, use a lista Método de conectividade para selecionar Lista de permissões de IP como método de rede.

   As listas de permissões de IP são um recurso de segurança usado com frequência para limitar e controlar o acesso de usuários confiáveis aos dados nos bancos de dados de origem e destino. É possível usar listas de permissões de IP para criar listas de endereços IP ou intervalos de IP confiáveis onde os usuários podem acessar esses dados. Além disso, para usar listas de permissões de IP, você precisa abrir o banco de dados ou o firewall de origem para conexões de entrada da instância de destino do Cloud SQL.

   Pode levar alguns minutos para que um endereço IP apareça no campo Endereço IP de saída de destino.

2. Se o endereço IP de origem não estiver preenchido neste campo, copie o endereço IP de saída da instância do Cloud SQL do console e use-o para configurar o firewall de rede do servidor de banco de dados de origem para aceitar conexões desse endereço IP.
   
   1. Atualize o arquivo pg_hba.conf ou os grupos de segurança do Amazon RDS para aceitar conexões desse endereço IP.
   2. Nas regras de firewall, crie uma regra de entrada (ou de ingresso) para permitir as conexões na porta 5432 do endereço IP de conectividade da instância do Cloud SQL de destino.
3. Clique em CONFIGURAR E CONTINUAR para concluir a configuração do perfil de conexão.

Testar e criar o job de migração

1. Revise as configurações que você escolheu para o job de migração.

2. Clique em TEST JOB para verificar se a origem foi configurada corretamente, se as instâncias de origem e de destino podem se comunicar entre si e se o job de migração é válido.

3. Verifique se o status "Testes aprovados" aparece.

   Se o teste falhar, você pode resolver o problema na parte do fluxo destinada a isso e refazer o teste.

4. Clique em Criar e iniciar job para criar o job de migração e iniciá-lo imediatamente.

5. Clique em START na caixa de diálogo seguinte.

6. Na página Jobs de migração, verifique se o status do job é "Iniciando". Após alguns minutos, confirme se o status mudou para "Em execução".

Verificar o job de migração

Nesta seção, você confirma que o Database Migration Service usou o job de migração para migrar dados da instância de banco de dados de origem para a instância de destino do Cloud SQL.

1. Acesse a página Instâncias do SQL no console do Google Cloud.
2. Clique na entrada de réplica de leitura do job de migração.
3. Clique no ícone Ativar o Cloud Shell que aparece no canto superior direito da página.
4. No prompt do Google Cloud Shell, pressione Enter.
5. Opcional: se a caixa de diálogo Autorizar o Cloud Shell aparecer, clique em Autorizar.
6. Conecte-se à instância de banco de dados do Cloud SQL de destino.
7. No comando Inserir senha, digite a senha que você forneceu ou que o Database Migration Service gerou em Definir configurações para a instância de destino do Cloud SQL.

8. No prompt postgres, digite \list para listar os bancos de dados e verificar se você vê a instância de banco de dados de origem.
9. No prompt postgres, digite \connect SOURCE_DB_NAME porque você quer ver as tabelas associadas a essa instância de banco de dados. O nome do prompt muda de postgres para SOURCE_DB_NAME.
10. No prompt SOURCE_DB_NAME, digite \dt para acessar as tabelas dessa instância.
11. No prompt SOURCE_DB_NAME, insira GRANT cloudsqlexternalsync to USER; porque você quer conceder a esse usuário permissão de acesso aos dados nas tabelas dessa instância.

    Substitua USER pelo nome do usuário usado para se conectar à instância do banco de dados de destino.

12. No prompt SOURCE_DB_NAME, digite SELECT * from TABLE_NAME; para ver as informações replicadas de uma tabela na instância de banco de dados de origem.
13. Verifique se as informações na tabela estão corretas.

Isso confirma que o Database Migration Service migrou os dados.

Promover o job de migração

Você já pode promover o job de migração. Como resultado, a instância de banco de dados do Cloud SQL de destino substitui a instância de origem como o banco de dados principal.

1. Volte para a página Jobs de migração.

2. Clique no job de migração que você quer promover. A página Detalhes do job de migração é exibida.

3. Aguarde o atraso da replicação chegar a zero.

4. Interrompa todas as gravações no banco de dados de origem.

   É necessário interromper todas as gravações no banco de dados de origem porque, ao promover o job de migração, o banco de dados do Cloud SQL de destino se torna o principal.

5. Aguarde até que o atraso da replicação seja zero.

6. Clique no job de migração que você quer promover. O job precisa ter o status "Em execução".

7. Clique em PROMOVER para promover o job de migração.

8. Clique em PROMOVER novamente na caixa de diálogo seguinte.

9. Verifique se o job de migração tem o status "Promoção em andamento". Após alguns minutos, confirme se o status mudou para "Concluído".

Sua nova instância de banco de dados do Cloud SQL está pronta para uso.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

1. Use o console do Google Cloud para excluir o job de migração, o perfil de conexão, a instância do Cloud SQL e o projeto se você não precisar deles.

A seguir

• Saiba mais sobre como gerenciar perfis de conexão.
• Leia mais sobre os status de jobs de migração.
• Leia mais sobre as métricas de jobs de migração.