Migrar um banco de dados para o AlloyDB 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 AlloyDB 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 rápido, você vai selecionar PostgreSQL para o Mecanismo de banco de dados de origem, AlloyDB para PostgreSQL para o Mecanismo de banco de dados de destino e Peering de VPC 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 destino do banco de dados AlloyDB.

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.

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

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)
• Como definir as configurações da instância de banco de dados do AlloyDB 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. Neste guia de início rápido, selecione AlloyDB para PostgreSQL.

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 alterações contínuas no banco de dados de origem sejam migradas para a instância de destino do AlloyDB.

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

Criar um cluster de destino do AlloyDB

Os clusters são o recurso de nível superior no AlloyDB. Para criar um cluster de destino:

1. Escolha um tipo de cluster. No momento, o Database Migration Service oferece suporte a clusters do AlloyDB altamente disponíveis. Elas podem veicular dados de mais de uma zona em uma região, sem pools de leitura.
2. Clique em CONTINUAR.
3. Configure seu cluster:
   1. No campo ID do cluster, insira um ID para o cluster.
   2. No campo Senha, insira uma senha para o usuário postgres padrão. Você vai precisar da senha para fazer login no seu banco de dados.
   3. No campo Rede, selecione um caminho de rede para definir quais recursos estão disponíveis ao definir a conectividade de migração. Os clusters só podem ser configurados com um caminho de rede IP particular. Se você planeja se conectar ao banco de dados de origem usando o peering de VPC, selecione a VPC em que ele está localizado.
   4. Opcionalmente, selecione um nome de intervalo de IP alocado para especificar os endereços IP com que a instância poderá se conectar.
   5. Clique em CONTINUAR.
4. Configure a instância principal. Uma instância principal determina a capacidade de computação de um cluster e oferece suporte a operações de leitura e gravação:
1. No campo ID da instância, insira um ID para a instância principal.
2. Selecione um tipo de máquina.
3. Opcional: defina sinalizações para sua instância. É possível usar flags para personalizar a instância. Para informações sobre as flags aceitas, consulte a documentação do AlloyDB. Para cada flag:
   1. Clique em ADICIONAR FLAG.
   2. Selecione uma flag na lista Nova flag do banco de dados.
   3. Informe um valor para a flag.
   4. Clique em CONCLUÍDO.
5. Clique em SALVAR E CONTINUAR.
6. Confirme sua escolha clicando em CRIAR DESTINO E CONTINUAR.
7. Aguarde a conclusão da criação da instância de destino.

O cluster do AlloyDB vai estar em um estado de "inicialização" enquanto for gerenciado pelo Database Migration Service. Durante o "inicialização", não é possível realizar operações no cluster. Se você ainda quiser excluir o cluster, faça isso usando o gcloud com a opção --force.

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 Peering de VPC como o método de rede.
2. Analise a rede VPC do seu banco de dados de origem. Clique em CONFIGURAR E CONTINUAR para concluir a configuração do perfil de conexão.

Configurar bancos de dados de migração

É possível selecionar os bancos de dados que você quer migrar.

1. Na lista Bancos de dados a serem migrados, selecione Todos os bancos de dados.

   Todos os bancos de dados que existem na origem são selecionados para migração.

2. Clique em Salvar e continuar.

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 de migração é "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 AlloyDB.

1. Acesse a página Clusters do AlloyDB no console do Google Cloud.

   Acesse a página Clusters do AlloyDB

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 Cloud Shell, pressione Enter.
5. Opcional: se a caixa de diálogo Autorizar o Cloud Shell aparecer, clique em Autorizar.
6. No comando Inserir senha, digite a senha que você forneceu ou que o Database Migration Service gerou para você em Definir e criar a instância de destino do AlloyDB.

7. 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.
8. 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.
9. No prompt SOURCE_DB_NAME, digite \dt para acessar as tabelas dessa instância.
10. No prompt SOURCE_DB_NAME, insira GRANT alloydbexternalsync 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.

11. 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.
12. 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 destino do AlloyDB 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 de destino do AlloyDB vai se tornar 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 AlloyDB está pronta para uso.

Limpar

Para evitar cobranças na 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, o cluster do AlloyDB 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.