Migrar para uma instância pré-existente do Cloud SQL

Nesta página, descrevemos como migrar seus bancos de dados para uma instância pré-existente do Cloud SQL criada diretamente no Cloud SQL.

Esse caminho é útil para cenários em que a instância de destino é gerenciada por uma equipe diferente ou se você precisa criar a instância fora do Database Migration Service (por exemplo, se você usa o Terraform). Se a migração tiver requisitos diferentes, siga um fluxo de migração diferente. Para mais informações, consulte Introdução às migrações do MySQL.

De modo geral, a migração segue estas etapas:

1. Configure o banco de dados de origem para permitir que o Database Migration Service mova seus dados para os novos bancos de dados.
2. Configure a conectividade de rede com a instância de origem do MySQL.
3. Crie o perfil de conexão e o job de migração.
4. Inicie e monitore o job de migração.
5. Promova o job de migração e mova seu aplicativo para usar os novos bancos de dados.

Custos

Neste documento, você usará os seguintes componentes faturáveis do Google Cloud

• Cloud SQL (consulte Preços do Cloud SQL).
• Se usado para armazenar chaves de criptografia gerenciadas pelo cliente (CMEK): Cloud Storage (consulte Preços do Cloud Storage).

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços.

Antes de começar

1. Verifique se esse caminho de migração pode oferecer suporte total ao seu cenário. Consulte as seguintes páginas:
   • Fontes e destinos compatíveis na página Visão geral do cenário lista todas as versões de origem e destino compatíveis.
   • Limitações conhecidas descreve tipos de dados, tamanhos de banco de dados e outras limitações compatíveis.
2. Para migrações únicas: considere a programação da migração. As migrações únicas executam apenas uma operação de despejo e carregamento completa sem captura de dados alterados subsequente. Recomendamos que você desative as gravações no banco de dados de origem para que o processo de migração não perca dados.
3. Considere em qual região você quer criar o banco de dados de destino. O Database Migration Service é um produto totalmente regional, o que significa que todas as entidades relacionadas à migração (perfis de conexão de origem e destino, jobs de migração, bancos de dados de destino, espaços de trabalho de conversão) precisam ser salvas em uma única região.
4. No Google Cloud console do, na página do seletor de projetos, selecione ou crie um Google Cloud projeto do.

   Acessar o seletor de projetos

5. Ative as APIs Database Migration Service e API Cloud SQL Admin.

   Ative as APIs

Funções exigidas

Para receber as permissões necessárias para realizar migrações homogêneas do MySQL com o Database Migration Service, peça ao administrador para conceder a você as funções necessárias do IAM no projeto:

• Administrador de migração do banco de dados (roles/datamigration.admin)
• Se você precisar criar a instância de destino fora do Database Migration Service, também precisará do Administrador do Cloud SQL (roles/cloudsql.admin)

Para mais informações sobre como conceder funções, consulte Gerenciar acesso na documentação do Identity and Access Management.

Esses papéis predefinidos contêm as permissões necessárias para realizar migrações homogêneas do MySQL com o Database Migration Service. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para realizar migrações homogêneas do MySQL com o Database Migration Service:

• datamigration.*
• cloudsql.instances.create
• cloudsql.instances.get
• cloudsql.instances.list
• cloudsql.instances.update
• cloudsql.instances.delete
• cloudsql.operations.get
• cloudsql.users.list
• cloudsql.users.get
• cloudsql.users.create
• cloudsql.users.update
• cloudsql.users.delete

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Preparar o banco de dados de origem

Para preparar os dados de origem para migração, siga estas etapas:

1. Considere se você quer fornecer seus próprios arquivos dump ou se o Database Migration Service deve executar o dump completo automaticamente:
   • Despejo automático (padrão): o Database Migration Service se conecta ao banco de dados de origem e executa o esquema inicial e o despejo de dados automaticamente quando o job de migração é iniciado. Não é necessário preparar nada antes de iniciar a migração.
   • Despejo manual: você pode gerar seus próprios arquivos dump e fazer upload deles para um bucket do Cloud Storage. Essa abordagem pode ser útil se você quiser reduzir a carga inicial na instância principal e fazer o despejo completo de uma réplica, executar o despejo durante uma janela de manutenção específica ou transmitir flags de exportação personalizadas. Consulte Exportar um banco de dados MySQL com mysqldump.
2. Escolha e configure o método de conectividade de rede de origem.
3. Configure a instância do banco de dados de origem.
   • Para migrações contínuas, consulte Configurar o banco de dados de origem para migrações contínuas.
   • Para migrações únicas, consulte Configurar o banco de dados de origem para migrações únicas.
4. Crie um perfil de conexão de origem..

Criar e configurar a instância de destino

Em alguns cenários, talvez você queira criar a instância de destino diretamente no Cloud SQL para aproveitar todas as opções de configuração disponíveis.

• Se você quiser criar o destino diretamente no Cloud SQL, considere cuidadosamente o tipo de rede da máquina de destino:

  • Se você quiser usar a conectividade de interfaces do Private Service Connect, crie a instância de destino como uma instância ativada para PSC. Consulte Criar uma instância ativada para PSC.
  • Se você quiser usar a conectividade de pareamento da nuvem privada virtual, crie a instância de destino como uma instância de PSA. Consulte Criar uma instância de banco de dados.
  • Se você quiser usar a conectividade da lista de permissões de IP público, crie a instância de destino com um IP público ativado. Consulte Criar uma instância de banco de dados.

• Se você já tiver uma instância do Cloud SQL de destino, siga para a próxima seção.

Criar e executar o job de migração

Para configurar e executar a migração, siga estas etapas:

1. Opcional: se você quiser gerenciar seus próprios certificados para o job de migração, prepare as chaves de criptografia necessárias.
2. Crie e execute o job de migração.

   É possível monitorar o progresso da migração e a integridade da instância de destino com os recursos de observabilidade do Database Migration Service. Consulte Métricas do job de migração.

Finalizar a migração

Quando você decidir mudar seu aplicativo para a nova instância do Cloud SQL para MySQL, finalize a migração seguindo estas etapas:

Migrações contínuas

1. Opcional: Configure réplicas de leitura em cascata. Se você quiser usar réplicas de leitura em cascata, poderá configurá-las quando o job de migração entrar na fase de CDC.
2. Interrompa todas as operações de gravação no banco de dados de origem. Você pode alterná-las para o modo somente leitura para manter a funcionalidade operacional.
3. Promova o job de migração.
4. Opcional: Verifique se os dados de migração estão completos.

Migrações únicas

Quando o Database Migration Service conclui a fase de despejo completo, a instância de destino é promovida automaticamente para uma instância independente. Para finalizar a migração, siga estas etapas:

1. Opcional: Verifique se os dados de migração estão completos.
2. Mude seu aplicativo para se conectar à nova instância do Cloud SQL para MySQL.

A seguir

Saiba mais sobre os Google Cloud recursos do Cloud SQL para MySQL. Consulte Recursos do Cloud SQL para MySQL.