Migre uma base de dados para o AlloyDB para PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

Migre uma base de dados para o AlloyDB para PostgreSQL

Este início rápido mostra como usar o serviço de migração de bases de dados para migrar dados para o AlloyDB for PostgreSQL. Normalmente, os recursos criados neste início rápido custam menos de 1 USD, desde que conclua os passos, incluindo a limpeza, atempadamente.

Antes de começar

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Enable the Database Migration Service API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

2. Certifique-se de que tem a função de administrador da migração da base de dados atribuída à sua conta de utilizador.

   Aceda à página IAM

Requisitos

O serviço de migração de base de dados oferece várias opções de base de dados de origem e métodos de conetividade. Algumas fontes funcionam melhor com determinados métodos de conetividade do que com outros. Neste início rápido, pressupomos que está a usar uma base de dados PostgreSQL autónoma num ambiente onde pode configurar a sua rede para adicionar uma regra de firewall de entrada. A base de dados de origem pode estar no local ou num fornecedor de nuvem. Como não podemos saber os detalhes específicos do seu ambiente, não podemos fornecer passos detalhados no que diz respeito à configuração de rede.

Neste início rápido, vai selecionar PostgreSQL para o motor de base de dados de origem, AlloyDB para PostgreSQL para o motor de base de dados de destino e VPC peering como método de rede.

Crie um perfil de associação de origem

Ao criar um perfil de associação, está a criar um registo que contém informações sobre a base de dados de origem. O Database Migration Service usa as informações no perfil de ligação para migrar dados da base de dados de origem para a instância da base de dados do AlloyDB de destino.

1. Aceda à página de perfis de ligação do serviço de migração de bases de dados na Google Cloud consola.

   Aceda à página de perfis de ligação do serviço de migração de bases de dados

2. Clique em CRIAR PERFIL.

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

4. Na lista Motor de base de dados, selecione um dos seguintes tipos de classificação da base de dados de origem:

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

   Para este início rápido, selecione PostgreSQL.

4. Forneça as seguintes informações:
   • No campo Nome do perfil de associação, introduza um nome para o perfil de associação da base de dados de origem, como My Connection Profile.
   • Mantenha o ID do perfil de associação gerado automaticamente.
   • Introduza as Informações de conetividade:
     • Se estiver a replicar a partir de uma base de dados alojada por si, introduza o nome de anfitrião ou o endereço IP (domínio ou IP) e a porta para aceder ao anfitrião. (A porta predefinida do PostgreSQL é 5432.)
     • Se estiver a replicar a partir de uma base de dados do Cloud SQL, selecione a instância do Cloud SQL na lista pendente.
   • Introduza um nome de utilizador e uma palavra-passe para fazer a autenticação na instância de origem.

5. Na secção Região do perfil de ligação da página, selecione a região onde quer guardar o perfil de ligação.

   Os perfis de ligação, como todos os recursos, são guardados numa região. A seleção da região não afeta as tarefas de migração que podem usá-las nem as regiões que podem estabelecer ligação à localização de dados propriamente dita, mas pode afetar a disponibilidade em caso de indisponibilidade regional.

6. Clique em CRIAR.

Crie uma tarefa de migração

O Database Migration Service usa tarefas de migração para migrar dados da instância da base de dados de origem para a instância da base de dados de destino do AlloyDB.

A criação de uma tarefa de migração inclui:

• Definir as definições da tarefa
• Selecionar o perfil de associação que criou para a base de dados de origem (perfil de associação de origem)
• Definir as definições da instância da base de dados do AlloyDB de destino
• Configurar a conetividade entre as instâncias da base de dados de origem e de destino
• Testar a tarefa de migração para garantir que as informações de associação que facultou para a tarefa são válidas

Defina as definições da tarefa de migração

1. Aceda à página de tarefas de migração do Database Migration Service na Google Cloud consola.

   Aceda à página de tarefas de migração do Database Migration Service

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

3. No campo Nome da tarefa de migração, introduza um nome para a tarefa de migração, como My Migration Job.

4. Mantenha o ID da tarefa de migração gerado automaticamente.

5. Abra a lista pendente Motor da base de dados de origem e selecione o tipo de classificação da base de dados de origem. Neste início rápido, selecione AlloyDB para PostgreSQL.

6. Selecione a região de destino onde a instância de destino vai ser criada.

7. Defina o Tipo de tarefa de migração como "Contínuo" porque quer que as alterações contínuas na base de dados de origem sejam migradas para a instância da base de dados AlloyDB de destino.

8. Reveja os pré-requisitos necessários gerados automaticamente para refletir a forma como o ambiente tem de ser preparado para uma tarefa de migração. Estes pré-requisitos podem incluir como configurar a base de dados de origem e como associá-la à instância da base de dados do AlloyDB de destino. É melhor concluir estes pré-requisitos neste passo, mas pode concluí-los em qualquer altura antes de testar a tarefa de migração ou iniciá-la. Para mais informações sobre estes pré-requisitos, consulte o artigo Configure a sua origem.

9. Clique em GUARDAR E CONTINUAR.

Especifique informações sobre o perfil de associação de origem

1. Abra a lista pendente Selecionar perfil de associação de origem e selecione o perfil de associação que criou.

2. Clique em GUARDAR E CONTINUAR.

Crie um cluster AlloyDB de destino

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

1. Escolha um tipo de cluster. Atualmente, o serviço de migração de base de dados suporta clusters do AlloyDB altamente disponíveis. Podem publicar dados de mais do que uma zona numa região, sem pools de leitura.
2. Clique em CONTINUAR.
3. Configure o cluster:
   1. No campo ID do cluster, introduza um ID para o seu cluster.
   2. No campo Palavra-passe, introduza uma palavra-passe para o utilizador postgres predefinido. Precisa da palavra-passe para iniciar sessão na sua base de dados.
   3. No campo Rede, selecione um caminho de rede para definir que recursos estão disponíveis quando define a conetividade da migração. Só é possível configurar clusters com um caminho de rede IP privado. Se planeia estabelecer ligação à base de dados de origem através da interligação de VPCs, selecione a VPC onde reside.
   4. Opcionalmente, selecione um nome de intervalo de IPs atribuído para especificar os endereços IP com os quais a sua instância pode estabelecer ligação.
   5. Clique em CONTINUAR.
4. Configure a sua instância principal. Uma instância principal determina a capacidade de computação de um cluster e suporta operações de leitura e escrita:
1. No campo ID da instância, introduza um ID para a sua instância principal.
2. Selecione um tipo de máquina.
3. Opcional: defina sinalizações para a sua instância. Pode usar flags para personalizar a sua instância. Para ver informações sobre as flags suportadas, consulte a documentação do AlloyDB. Para cada denúncia:
   1. Clique em ADICIONAR MARCAÇÃO.
   2. Selecione uma flag na lista Nova flag da base de dados.
   3. Indique um valor para a flag.
   4. Clique em CONCLUIR.
5. Clique em GUARDAR E CONTINUAR.
6. Confirme a sua escolha clicando em CRIAR DESTINO E CONTINUAR.
7. Aguarde a conclusão da criação da instância de destino.

O seu cluster do AlloyDB vai estar no estado "Bootstrapping" enquanto estiver a ser gerido pelo Database Migration Service. Enquanto estiver na fase de "Bootstrapping", não pode realizar operações no cluster. Se ainda quiser eliminar o cluster, pode fazê-lo através do gcloud com a opção --force.

Configure a conetividade

1. Escolha o método de rede que quer usar para estabelecer a conetividade entre as bases de dados de origem e de destino. Para este início rápido, use a lista Método de conetividade para selecionar Interligação de VPCs como método de rede.
2. Reveja a rede VPC da base de dados de origem. Clique em CONFIGURAR E CONTINUAR para concluir a configuração do perfil de associação.

Configure bases de dados de migração

Pode selecionar as bases de dados que quer migrar.

1. Na lista Bases de dados a migrar, selecione Todas as bases de dados.

   Todas as bases de dados existentes na origem são selecionadas para migração.

2. Clique em Guardar e continuar.

Teste e crie a tarefa de migração

1. Reveja as definições que escolheu para a tarefa de migração.

2. Clique em TESTAR TAREFA para verificar se a origem foi configurada corretamente, se as instâncias de origem e de destino conseguem comunicar entre si e se a tarefa de migração é válida.

3. Verifique se vê o estado "Testes aprovados com êxito!".

   Se o teste falhar, pode resolver o problema na parte adequada do fluxo e voltar a testar.

4. Clique em CRIAR E INICIAR TAREFA para criar a tarefa de migração e iniciá-la imediatamente.

5. Clique em INICIAR na caixa de diálogo subsequente.

6. Na página Tarefas de migração, verifique se a sua tarefa de migração tem o estado "A iniciar". Após alguns minutos, confirme que o estado muda para "Em execução".

Valide a tarefa de migração

Nesta secção, confirma que o Database Migration Service usou a tarefa de migração para migrar dados da instância da base de dados de origem para a instância da base de dados de destino do AlloyDB.

1. Aceda à página Clusters do AlloyDB na Google Cloud consola.

   Aceda à página Clusters do AlloyDB

2. Clique na entrada da réplica de leitura da tarefa de migração.
3. Clique no ícone Ativar Cloud Shell apresentado na região superior direita da página.
4. Na linha de comandos do Cloud Shell, prima Enter.
5. Opcional: se for apresentada uma caixa de diálogo Autorizar Cloud Shell, clique em Autorizar.
6. No comando Introduza a palavra-passe, introduza a palavra-passe que forneceu ou que o Database Migration Service gerou para si em Defina e crie a instância de destino do AlloyDB.

7. No comando postgres, introduza \list para listar as bases de dados e verifique se vê a instância da base de dados de origem.
8. No comando postgres, introduza \connect SOURCE_DB_NAME porque quer ver as tabelas associadas a esta instância da base de dados. O nome do comando muda de postgres para SOURCE_DB_NAME.
9. No comando SOURCE_DB_NAME, introduza \dt para ver as tabelas desta instância.
10. No comando SOURCE_DB_NAME, introduza GRANT alloydbexternalsync to USER; porque quer conceder a este utilizador autorização para aceder aos dados nas tabelas desta instância.

    Substitua USER pelo nome do utilizador que usou para estabelecer ligação à instância da base de dados de destino.

11. No comando SOURCE_DB_NAME, introduza SELECT * from TABLE_NAME; para ver as informações replicadas de uma tabela na instância da base de dados de origem.
12. Confirme que vê as informações corretas na tabela.

Isto confirma que o serviço de migração de bases de dados migrou os dados.

Promova a tarefa de migração

Tem tudo pronto para promover a tarefa de migração. Como resultado, a instância da base de dados AlloyDB de destino substitui a instância da base de dados de origem como base de dados principal.

1. Regresse à página Tarefas de migração.

2. Clique na tarefa de migração que quer promover. É apresentada a página Detalhes da tarefa de migração.

3. Aguarde até que o atraso na replicação tenda para zero.

4. Pare todas as gravações na base de dados de origem.

   Tem de parar todas as gravações na base de dados de origem porque, ao promover a tarefa de migração, a base de dados AlloyDB de destino torna-se a sua base de dados principal.

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

6. Clique na tarefa de migração que quer promover. Este trabalho deve ter o estado "Em execução".

7. Clique em PROMOTE (PROMOVER) para promover a tarefa de migração.

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

9. Verifique se a tarefa de migração tem o estado "Promoção em curso". Após alguns minutos, confirme que o estado muda para "Concluído".

A sua nova instância de base de dados do AlloyDB está pronta a ser usada.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Use a Google Cloud consola para eliminar a tarefa de migração, o perfil de ligação, o cluster do AlloyDB e o projeto se não precisar deles.

O que se segue?

• Leia mais sobre como gerir perfis de ligação.
• Leia mais acerca dos estados das tarefas de migração.
• Leia mais acerca das métricas de tarefas de migração.