Migrar um banco de dados para o Cloud SQL para PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

Migrar um banco de dados para o Cloud SQL para PostgreSQL

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

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. 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 início rápido, selecione PostgreSQL para o Mecanismo de banco de dados de origem e Lista de permissão de 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 de destino do Cloud SQL.

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

   Acessar a página "Perfis de conexão" do Database Migration Service

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 independente 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 a 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á-las 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 de destino do Cloud SQL.

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

• Definir as configurações do job
• Selecione o perfil de conexão que você criou para seu banco de dados de origem (perfil de conexão de origem).
• Definir configurações para a instância de banco de dados de destino do Cloud SQL
• Configurar a conectividade entre as instâncias de banco de dados de origem e 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 Database Migration Service" no console Google Cloud .

   Acesse a página "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 destino do banco de dados do Cloud SQL. É 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 sua 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 escolha 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 previamente nesse campo. Você pode manter esse nome ou inserir outro.

2. Forneça 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 automaticamente.

   Dica:para ver a senha em texto não criptografado, clique no ícone Revelar. O ícone parece 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 Google Cloud zona desejada para a nova instância do Cloud SQL (ou deixe como "Qualquer").

5. Marque a caixa de seleção IP público porque, para este guia de início rápido, você está usando a lista de permissões de IP como 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, marque a caixa de seleção IP privado.

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 da 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 mecanismo de 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 aos dados nos bancos de dados de origem e destino apenas para usuários confiáveis. É 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 previamente nesse campo, copie o endereço IP de saída da instância do Cloud SQL no 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 ingresso) para permitir conexões na porta 5432 do endereço IP de conectividade da instância de destino do Cloud SQL.
3. 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 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 escolhidas para o job de migração.

2. Clique em TESTAR 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 bem-sucedidos!" 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 e iniciar o job de migração imediatamente.

5. Clique em INICIAR 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ê vai confirmar se o Database Migration Service usou o job de migração para migrar dados da instância de banco de dados de origem para a de destino do Cloud SQL.

1. Acesse a página Instâncias do SQL no Google Cloud console.
2. Clique na entrada de réplica de leitura do job de migração.
3. Clique no ícone Ativar o Cloud Shell que aparece na região superior direita da página.
4. No prompt do Google Cloud Shell, pressione Enter.
5. Opcional: se uma caixa de diálogo Autorizar o Cloud Shell for exibida, clique em Autorizar.
6. Conecte-se à instância de banco de dados de destino do Cloud SQL.
7. Quando o comando Inserir senha for exibido, digite a senha fornecida ou gerada pelo Database Migration Service 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 a instância de banco de dados de origem aparece.
9. No prompt postgres, insira \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, insira \dt para ver as tabelas dessa instância.
11. No prompt SOURCE_DB_NAME, insira GRANT cloudsqlexternalsync to USER; para 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, insira 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 de destino do Cloud SQL substitui a instância de banco de dados 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 diminuir até 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 Cloud SQL se tornará o principal.

5. Aguarde até que o atraso de 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 conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

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

A seguir

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