GSP861

Visão geral

O Database Migration Service migra com eficiência objetos de banco de dados do MySQL, como esquema, dados e metadados, de uma instância de origem para uma de destino. Quando um job de migração é executado, ele move todas as tabelas em todos os bancos de dados e esquemas, exceto os seguintes bancos de dados do sistema: sys, mysql, performance_schema e information_schema.

As informações sobre usuários e privilégios são mantidas nos bancos de dados do sistema MySQL. Como os jobs do Database Migration Service não migram esses bancos de dados do sistema, você precisa gerenciar usuários e privilégios na instância de destino do Cloud SQL depois que ela é criada. Para mais informações sobre a fidelidade da migração, consulte o Guia de fidelidade da migração.

Se o usuário especificado em uma cláusula DEFINER de um objeto não existir na instância de destino, a invocação do objeto poderá falhar após a migração. Para mais detalhes, consulte o guia Criar e executar um job de migração do MySQL que contenha metadados com uma cláusula DEFINER.

Para evitar erros ao invocar objetos na instância de destino após a migração, conclua uma das duas ações abaixo antes de executar o job de migração:

• Garantir a presença do usuário: crie os usuários necessários na instância de destino do MySQL. Assim, todos os usuários associados às cláusulas DEFINER vão estar presentes no destino.
• Atualize os privilégios de segurança: na instância de origem do MySQL, mude as cláusulas DEFINER para INVOKER. Isso define os privilégios de segurança para acesso aos dados no destino como os do usuário que executa a consulta, e não os do usuário que definiu o objeto.

Depois que esses pré-requisitos forem atendidos, crie e salve um job do Database Migration Service e inicie-o. Após a conclusão da migração, a etapa final é verificar os metadados do usuário na instância do Cloud SQL para MySQL.

Atividades deste laboratório

Neste laboratório, você vai aprender a migrar dados de usuários do MySQL ao executar jobs do Database Migration Service.

• Identificar os usuários do MySQL na instância de origem.
• Atualizar as cláusulas DEFINER para INVOKER na instância de origem do MySQL.
• Criar e salvar um job do Database Migration Service sem iniciá-lo.
• Criar usuários na instância de destino do Cloud SQL.
• Iniciar um job do Database Migration Service criado anteriormente.
• Verificar os metadados do usuário na instância de destino do Cloud SQL.

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

   • O botão Abrir Console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Ativar o Cloud Shell

O Cloud Shell é uma máquina virtual com várias ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud. O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.

2. Clique nas seguintes janelas:

   • Continue na janela de informações do Cloud Shell.
   • Autorize o Cloud Shell a usar suas credenciais para fazer chamadas de APIs do Google Cloud.

Depois de se conectar, você verá que sua conta já está autenticada e que o projeto está configurado com seu Project_ID, . A saída contém uma linha que declara o projeto PROJECT_ID para esta sessão:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

3. (Opcional) É possível listar o nome da conta ativa usando este comando:

gcloud auth list

4. Clique em Autorizar.

Saída:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Opcional) É possível listar o ID do projeto usando este comando:

gcloud config list project

Saída:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Observação: consulte a documentação completa da gcloud no Google Cloud no guia de visão geral da gcloud CLI.

Verificar se a API Database Migration está ativada

1. Na barra de título do console do Google Cloud, digite API Database Migration no campo Pesquisar e clique em API Database Migration nos resultados da pesquisa.

2. Se necessário, clique em Ativar para ativar a API.

Tarefa 1: identificar os usuários atuais do MySQL na instância de origem

Assim como ocorre com outros recursos do Cloud, o acesso e as permissões da instância de destino do Cloud SQL são controlados no nível do projeto usando o Identity and Access Management (IAM). Para mais detalhes, consulte o guia do IAM para Cloud SQL.

Nesta tarefa, você vai identificar os usuários do banco de dados gerenciados pelo controle de acesso ao banco de dados (por exemplo, administradores e superusuários). Esses usuários, diferentes daqueles gerenciados pelo IAM, podem precisar de acesso à instância de destino do Cloud SQL para testar os resultados do job de migração antes de conceder um acesso mais amplo do IAM. Para mais informações, consulte o guia Sobre usuários do MySQL.

Conectar-se à instância de origem do MySQL

1. Na barra de título do console do Google Cloud, no Menu de navegação (), clique em Compute Engine > Instâncias de VM.

2. Encontre a linha com a instância dms-mysql-training-vm.

3. Em Conectar, clique em SSH para abrir uma janela do terminal.

4. Se for solicitado, clique em Autorizar.

Ignore os avisos sobre upgrades que aparecem na janela do SSH.

5. Para se conectar ao console interativo do MySQL na janela do terminal, execute este comando:

mysql -u admin -p

6. Quando uma senha for solicitada, insira:

changeme!

Identificar os usuários atuais do MySQL

1. Execute esta consulta para identificar os usuários atuais do MySQL:

select host, user, authentication_string from mysql.user order by user;

Observe estes usuários do sistema: debian-sys-maint, mysql.session e mysql.sys. Eles não precisam ser recriados porque isso é feito pelo MySQL ao criar a instância de destino.

2. Execute a consulta modificada para excluir esses usuários do sistema:

select host, user, authentication_string from mysql.user where user not like '%mysql%' and user not like '%debian%' order by user;

3. Confira a lista de usuários que precisam ser recriados na instância de destino do Cloud SQL:

host	usuário
localhost	admin
%	admin
localhost	bsmith
localhost	dwilliams
localhost	mhill
localhost	root
%	root

Em uma tarefa futura, você vai criar o usuário raiz ao executar o job do Database Migration Service. Você também vai criar os outros usuários depois que o job de migração criar a instância de destino do Cloud SQL.

4. Mantenha a janela do terminal aberta para uso na próxima tarefa.

Tarefa 2: atualizar DEFINER para INVOKER na instância de origem do MySQL

Na tarefa anterior, você identificou os usuários atuais do MySQL na instância de origem. Nesta tarefa, você vai identificar e atualizar os objetos de banco de dados que têm entradas DEFINER para o usuário raiz ou outros que ainda não existem na instância de destino.

Se o usuário da instância de origem não for criado na instância de destino, todas as entradas DEFINER associadas precisarão ser alteradas para INVOKER. Especificamente, todas as entradas DEFINER do usuário raiz precisam ser atualizadas para INVOKER usando outro usuário, como um admin.

Com isso, é possível evitar falhas durante a invocação de objetos na instância de destino após a migração. Saiba mais no guia Criar e executar um job de migração do MySQL que contém metadados com uma cláusula DEFINER.

Identificar objetos com entradas DEFINER

Para saber mais sobre as entradas DEFINER em uma instância do MySQL, consulte as tabelas INFORMATION_SCHEMA para identificá-las e analisá-las antes da migração. Um exemplo são as entradas DEFINER que não estão associadas a bancos de dados do sistema, como o MySQL, e que são migradas para a instância de destino por esse motivo.

1. Execute esta consulta para identificar as entradas DEFINER:

select table_schema, table_name from information_schema.columns where column_name = 'DEFINER' and table_schema != 'mysql';

Os resultados indicam que você precisa verificar eventos, rotinas, gatilhos e visualizações em busca de entradas DEFINER.

Algumas dessas entradas DEFINER podem estar associadas a usuários do sistema, que não exigem outras ações. Esses usuários são excluídos das consultas que identificam as entradas DEFINER dos vários objetos de banco de dados.

2. Execute esta consulta para identificar entradas DEFINER em eventos:

select definer, event_schema, event_name from information_schema.events where definer not like '%mysql%' and definer not like '%debian%';

Não há instâncias de entradas DEFINER em eventos associados a usuários que não são do sistema.

3. Execute esta consulta para identificar entradas DEFINER em rotinas:

select definer, routine_schema, routine_name from information_schema.routines where definer not like '%mysql%' and definer not like '%debian%';

Não há instâncias de entradas DEFINER em rotinas associadas a usuários que não são do sistema.

4. Execute esta consulta para identificar entradas DEFINER em gatilhos:

select definer, trigger_schema, trigger_name from information_schema.triggers where definer not like '%mysql%' and definer not like '%debian%';

Não há instâncias de entradas DEFINER em gatilhos associados a usuários que não são do sistema.

5. Execute esta consulta para identificar entradas DEFINER em visualizações:

select definer, security_type, table_schema, table_name from information_schema.views where definer not like '%mysql%' and definer not like '%debian%' order by definer;

6. Confira os detalhes da visualização invoices_storenum_3656, que está associada a mhill:

definer	security_type	table_schema	table_name
admin@localhost	DEFINER	customers_data	customers_single
admin@localhost	DEFINER	sales_data	invoices_storenum_5173
bsmith@localhost	DEFINER	customers_data	customers_married
bsmith@localhost	DEFINER	sales_data	invoices_storenum_3980
mhill@localhost	DEFINER	sales_data	invoices_storenum_3656

Na próxima seção, você vai atualizar DEFINER para INVOKER na visualização.

Um dos usuários identificados anteriormente (dwilliams) não está associado a nenhuma entrada DEFINER nas visualizações. Além disso, não há instâncias de entradas DEFINER para o usuário raiz. Nenhuma ação é necessária para os usuários dwilliams ou raiz.

Atualizar DEFINER para INVOKER

Nesta subtarefa, você vai atualizar as entradas DEFINER associadas a mhill para INVOKER.

1. Execute este comando para conferir os detalhes da visualização associada a mhill:

select definer, security_type, table_schema, view_definition from information_schema.views where table_name = 'invoices_storenum_3656';

2. Selecione o banco de dados associado à visualização:

use sales_data;

3. Execute este comando para atualizar DEFINER para INVOKER na visualização:

alter sql security INVOKER view invoices_storenum_3656 as (select * from invoices where storeNum = 3656);

4. Confira novamente as entradas DEFINER para verificar se a visualização foi atualizada para INVOKER:

select definer, security_type, table_schema, table_name from information_schema.views where definer not like '%mysql%' and definer not like '%debian%' order by definer;

A entrada DEFINER associada a mhill foi atualizada para INVOKER. As entradas DEFINER associadas a admin e bsmith não foram alteradas.

Encerrar a sessão do terminal

1. Saia do console interativo do MySQL:

exit

2. Saia da sessão do terminal:

exit

Clique em Verificar meu progresso para conferir o objetivo. Atualizar as cláusulas DEFINER para INVOKER na instância de origem do MySQL.

Tarefa 3: criar e salvar um job do Database Migration Service sem iniciá-lo

Nesta tarefa, você vai criar e salvar um job de migração sem iniciá-lo. Especificamente, você vai criar um job de migração única usando o peering de VPC como opção de conectividade. No entanto, é possível criar e salvar qualquer job de migração para ser executado mais tarde.

Assim, é possível criar a instância de destino do Cloud SQL sem migrar dados até que você realize as tarefas necessárias, como criar usuários na instância de destino.

Encontrar as informações de conectividade da instância de origem do MySQL

1. No console do Google Cloud, no Menu de navegação (), clique em Compute Engine > Instâncias de VM.

2. Encontre a linha com a instância dms-mysql-training-vm.

3. Copie o valor do IP interno, como 10.128.0.2.

Criar perfil de conexão para a instância de origem do MySQL

1. Na barra de título do console, digite Migração de banco de dados no campo Pesquisar e clique em Migração de banco de dados nos resultados.

2. Clique em Perfis de conexão no painel à esquerda e em Criar perfil.

3. Defina as informações necessárias do perfil de conexão abaixo e deixe todas as outras configurações com os valores padrão:

Propriedade	Valor
Papel do perfil	Origem
Mecanismo do banco de dados	MySQL
Nome do perfil de conexão	mysql-vm
ID do perfil de conexão	mantenha o valor gerado automaticamente
Nome do host ou endereço IP	Insira o IP interno da instância de origem do MySQL que você copiou na tarefa anterior, como 10.128.0.2.
Porta	3306
Nome de usuário	admin
Senha	changeme!
Região

4. Clique em Criar.

Um novo perfil de conexão mysql-vm aparece na lista de Perfis de conexão.

Criar job de migração única

1. No painel à esquerda, clique em Jobs de migração e em Criar job de migração.

2. Para Criar job de migração, defina os seguintes valores na guia Começar:

Propriedade	Valor
Nome do job de migração	vm-to-cloudsql
ID do job de migração	mantenha o valor gerado automaticamente
Mecanismo de banco de dados de origem	MySQL
Região de destino
Tipo de job de migração	Única

Não altere as outras configurações.

3. Clique em Salvar e continuar.

Definir a instância de origem

1. Na guia Definir uma origem, em Perfil de conexão de origem, selecione mysql-vm.

2. Mantenha os valores padrão das outras configurações.

3. Clique em Salvar e continuar.

Definir a instância de destino

1. Na guia Definir um destino, em Tipo de cluster de destino, selecione Instância atual.

2. Para a instância de destino, selecione .

3. Clique em Selecionar e continuar.

4. Digite o nome da instância novamente e clique em Confirmar e continuar.

Observação: essa etapa pode levar alguns minutos para ser concluída.

Se uma nova tentativa for solicitada, clique no botão Tentar de novo para atualizar a API Service Networking.

Se você receber um erro sem um aviso para tentar de novo, verifique se realizou as etapas na seção Configuração e requisitos do laboratório para conferir se a API Service Networking foi ativada.

Ao final dessa etapa, uma mensagem atualizada vai ser exibida: this instance uses the existing managed service connection.

Pode levar alguns minutos para salvar o destino.

Definir método de conectividade

1. Na guia Definir método de conectividade, em Método de conectividade, selecione Peering de VPC.

2. Em VPC, selecione padrão.

O peering de VPC é configurado pelo Database Migration Service usando as informações fornecidas para a rede VPC (a rede padrão neste exemplo).

3. Clique em Configurar e continuar.

Salvar o job de migração única

1. Confira os detalhes do job de migração.

2. Clique em Criar job.

Não é necessário testar o job de migração. Se você testar o job agora, vai receber uma mensagem de erro porque há entradas DEFINER associadas a usuários que ainda não foram criados na instância de destino. Você vai criar esses usuários na próxima tarefa.

3. Se for preciso confirmar, clique em Criar.

O job de migração foi criado, mas não foi iniciado. Você vai iniciar o job em uma tarefa posterior, depois de criar os usuários na instância de destino do Cloud SQL.

Clique em Verificar meu progresso para conferir o objetivo. Criar e salvar um job do Database Migration Service sem iniciá-lo.

Tarefa 4: criar os usuários necessários na instância de destino do Cloud SQL

Antes de executar um job de migração no Cloud SQL, crie os usuários necessários do MySQL, incluindo administradores e superusuários para testar os resultados da migração antes de conceder acesso mais amplo pelo IAM. Além disso, é necessário criar usuários com cláusulas DEFINER associadas antes de iniciar a migração.

Nesta tarefa, você vai criar os usuários admin, bsmith e mhill.

1. Na barra de título do console do Google Cloud, digite Cloud SQL no campo Pesquisar e clique em Cloud SQL nos resultados.

2. Expanda a instância mysql-cloudsql-master e clique em mysql-cloudsql.

3. No menu Instância de réplica, clique em Usuários.

4. Clique em Adicionar conta de usuário.

5. Defina as propriedades na tabela abaixo e deixe todas as outras como estão:

Propriedade	Valor
Nome de usuário	admin
Senha	changeme!
Nome do host	Restringir host por endereço IP ou intervalo de endereços
Host	localhost

6. Clique em Adicionar.

7. Repita as etapas de 4 a 6 para criar mais dois usuários com acesso ao localhost:

Usuário	Senha
bsmith	mustchangeasap!
mhill	update!

Clique em Verificar meu progresso para conferir o objetivo. Criar usuários na instância de destino do Cloud SQL.

Tarefa 5: executar um job de migração criado anteriormente

Iniciar um job de migração

1. Na barra de título do console do Google Cloud, digite Migração de banco de dados no campo Pesquisar e clique em Migração de banco de dados nos resultados. > Jobs de migração**.

2. No painel à esquerda, clique em Jobs de migração** e depois no job de migração vm-to-cloudsql para ver a página de detalhes.

3. Clique no botão Iniciar para executar o job de migração.

Se for preciso confirmar, clique em Iniciar.

4. Confira o status do job de migração.
   • Se o job não tiver sido iniciado, o status será Não iniciado. Você poderá escolher iniciar ou excluir o job.
   • Quando o job for iniciado, o status vai mudar para Iniciando e, depois, para Em execução.
   • Quando o status do job mudar para Concluído, a migração terá sido concluída e será possível seguir para a próxima tarefa.

Clique em Verificar meu progresso para conferir o objetivo. Executar um job do Database Migration Service criado anteriormente.

Tarefa 6: confirmar os metadados do usuário no Cloud SQL para MySQL

Conectar-se à instância do MySQL

1. Na barra de título do console do Google Cloud, digite Cloud SQL no campo Pesquisar e clique em Cloud SQL nos resultados.

2. Clique no ID de instância mysql-cloudsql.

3. No menu Instância principal, clique em Visão geral.

4. Role para baixo até o painel Conectar-se a esta instância e clique em Abrir o Cloud Shell.

O comando para se conectar ao MySQL é pré-preenchido no Cloud Shell:

gcloud sql connect mysql-cloudsql --user=root --quiet

5. Execute o comando pré-preenchido.

Se precisar, clique em Autorizar para a API.

6. Se precisar inserir uma senha, que você já definiu, digite:

supersecret!

Você ativou o console interativo do MySQL.

Conferir os metadados do usuário na instância do Cloud SQL para MySQL

1. Execute esta consulta para conferir os usuários que não são do sistema:

select host, user, authentication_string from mysql.user where user not like '%mysql%' and user not like '%debian%' order by user;

Observe os usuários que você criou na tarefa anterior.

2. Execute esta consulta para verificar se os metadados do usuário foram migrados:

select definer, security_type, table_schema, table_name from information_schema.views where definer not like '%mysql%' and definer not like '%debian%' order by definer;

3. Confira as entradas para verificar se os metadados de invoices_storenum_3656 foram migrados corretamente:

definer	security_type	table_schema	table_name
admin@localhost	DEFINER	customers_data	customers_single
admin@localhost	DEFINER	sales_data	invoices_storenum_5173
bsmith@localhost	DEFINER	customers_data	customers_married
bsmith@localhost	DEFINER	sales_data	invoices_storenum_3980
mhill@localhost	INVOKER	sales_data	invoices_storenum_3656

4. Para selecionar o banco de dados no console interativo do MySQL, execute este comando:

use sales_data;

5. Consulte a visualização associada a mhill para verificar se ela é executada corretamente:

select * from invoices_storenum_3656;

A consulta retorna 27 linhas.

6. Saia do console interativo do MySQL:

exit

Clique em Verificar meu progresso para conferir o objetivo. Confirmar os metadados do usuário no Cloud SQL para MySQL

Parabéns!

Você aprendeu a migrar dados de usuários do MySQL ao executar jobs do Database Migration Service.

Próximas etapas/Saiba mais

Saiba mais sobre migração de dados, bancos de dados do Cloud SQL e o Database Migration Service:

• Documentação do Database Migration Service
• Documentação do Cloud SQL para MySQL
• Tipos de migração

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 4 de dezembro de 2025

Laboratório testado em 10 de dezembro de 2025

Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.