- Início
- Migrar um banco de dados para a Magalu Cloud
Migrar um banco de dados para a Magalu Cloud
Regiões
Este recurso está disponível nas seguintes regiões:Esta página descreve como migrar um banco de dados MySQL hospedado fora da Magalu Cloud (em um servidor próprio, em outra nuvem ou em outro serviço gerenciado) para uma instância do DBaaS MySQL, utilizando ferramentas de backup lógico.
Se você deseja migrar entre instâncias do próprio DBaaS Magalu Cloud, como do MySQL 8.0 para o 8.4, consulte a página Migrar do MySQL 8.0 para o MySQL 8.4, que descreve esse cenário passo a passo.
O processo recomendado de migração é dividido em quatro etapas:
- Verificação de compatibilidade
- Criação da instância de destino
- Migração dos dados, com
mysqldumpou commydumper/myloader - Validação da migração
Se a sua instância de destino for um cluster Multi-AZ, leia com atenção a seção Migrar para um cluster Multi-AZ antes de iniciar a carga dos dados. Executar a carga da mesma forma que em uma instância single-instance pode deixar as instâncias secundárias (réplicas stand-by) do cluster fora de sincronia.
Verificar a compatibilidade
O DBaaS Magalu Cloud oferece o MySQL nas versões listadas na Política de Versões. Sempre que possível, crie a instância de destino na versão LTS mais recente disponível (atualmente o MySQL 8.4).
-
Origem em MySQL 8.0 ou 8.4: a migração é direta, sem ajustes especiais.
-
Origem em MySQL 5.7 ou anterior: o MySQL 8.x alterou diversos recursos, como palavras reservadas, collations e o
sql_modepadrão, e desabilitou por padrão o plugin de autenticaçãomysql_native_password(descontinuado no 8.0 e removido apenas no 9.0). Utilize a Upgrade Checker Utility do MySQL Shell para identificar os pontos do seu banco que precisam de ajuste antes da migração:mysqlsh usuario@host_de_origem:3306 -- util check-for-server-upgrade --target-version=8.4.0Substitua:
usuariopelo usuário administrador do banco de origem.host_de_origempelo endereço do servidor MySQL de origem.
Corrija todos os itens reportados como Error e avalie os Warnings antes de seguir para a migração.
-
Origem em MariaDB ou em forks do MySQL: a compatibilidade não é garantida. Valide tipos de dados, funções e sintaxes específicas em um ambiente de testes antes de migrar.
Sempre que possível, execute um teste de migração completo em um ambiente de homologação antes de aplicar o processo em produção. Além de validar o procedimento, você obtém uma estimativa realista do tempo de cada etapa, que é a base para dimensionar a janela de manutenção.
Criar a instância de destino
Crie uma nova instância MySQL na Magalu Cloud, pelo Console ou pela CLI, para receber os dados migrados. Ao dimensioná-la, considere:
-
Armazenamento: o volume precisa comportar os dados, os índices e espaço para crescimento. O tamanho do arquivo de dump não é uma boa referência. Consulte o tamanho real na origem com o comando:
SELECT table_schema AS banco,ROUND(SUM(data_length + index_length) / 1024 / 1024 / 1024, 2) AS tamanho_gbFROM information_schema.tablesGROUP BY table_schemaORDER BY tamanho_gb DESC; -
Tipo de instância: uma instância com mais vCPUs e memória acelera a carga dos dados. Se desejar, você pode modificar a instância para um tipo menor após a migração.
-
Alta disponibilidade: se precisar de failover automático, crie o destino como um cluster Multi-AZ e siga as orientações da seção Migrar para um cluster Multi-AZ.
Se o banco de origem utiliza configurações personalizadas (como sql_mode, max_allowed_packet ou default_time_zone), crie um grupo de parâmetros equivalente e associe-o à nova instância antes de iniciar a carga dos dados. Para comparar as configurações, execute SHOW GLOBAL VARIABLES; nos dois lados.
Se o banco de origem possui triggers ou functions, habilite o parâmetro log_bin_trust_function_creators no grupo de parâmetros da instância de destino antes da carga (a alteração exige reinício da instância). O log binário está sempre ativo no DBaaS e o usuário administrador não possui o privilégio SUPER, então sem esse parâmetro a criação desses objetos falha com o erro ERROR 1419: You do not have the SUPER privilege and binary logging is enabled. Alternativamente, o usuário administrador pode executar SET PERSIST log_bin_trust_function_creators = 1; diretamente na instância.
O que não é migrado automaticamente
Um backup lógico exporta os bancos de dados da aplicação, mas não inclui:
- Usuários, senhas e permissões: recrie-os na instância de destino seguindo Gerenciar usuários e permissões. Para listar o que existe na origem, utilize
SELECT user, host FROM mysql.user;eSHOW GRANTS FOR 'usuario'@'host';. - Os schemas de sistema
mysql,sys,information_schemaeperformance_schema: são gerenciados pelo próprio MySQL e nunca devem ser restaurados sobre a instância de destino. - Parâmetros do servidor (
my.cnf): utilize um grupo de parâmetros. - Configura ção de replicação, plugins e tablespaces externos: são específicos do ambiente de origem.
Preparar o host de acesso
As instâncias do DBaaS são acessíveis apenas pela rede privada da região. Você precisa de uma Máquina Virtual (Jumphost) na mesma região da instância de destino, com:
- O cliente
mysqlinstalado (necessário para omysqldump/mysqle para as validações); - O
mydumperinstalado, se for utilizar a opção 2 (veja Pré-requisitos); - Espaço em disco suficiente para receber os arquivos do dump. Se necessário, monte um volume adicional de Block Storage na VM. Nos exemplos desta página, os arquivos ficam em
/dados, o ponto de montagem desse volume.
Se o host de origem conseguir alcançar a rede privada da Magalu Cloud (por VPN, por exemplo), também é possível executar a exportação e a importação diretamente, sem transferir arquivos. Veja Migração em streaming.
Migrar os dados
Existem duas abordagens, e a escolha depende principalmente do tamanho do banco e da janela de indisponibilidade aceitável:
| Abordagem | Indicada para | Características |
|---|---|---|
mysqldump e mysql | Bancos pequenos, ambientes de teste e cenários simples | Ferramentas nativas do MySQL, instaladas junto com o cliente. Exportação e importação em um único arquivo .sql, sem paralelismo. |
mydumper e myloader | Bancos médios e grandes, ou janelas de migração curtas | Ferramenta open-source multi-thread. Exporta e restaura várias tabelas em paralelo, permite filtrar o que migrar, verificar checksums e retomar cargas interrompidas. |
Durante a exportação, qualquer alteração feita na origem após o início do dump não será incluída. Para uma migração consistente, coloque a aplicação em manutenção antes de exportar e só a aponte para a Magalu Cloud após validar os dados.
Opção 1: mysqldump e mysql
O mysqldump gera um único arquivo .sql com os comandos necessários para recriar os objetos e os dados, e o cliente mysql o executa na instância de destino. Ambos fazem parte do pacote mysql-client.
Exportar os dados da origem
Execute o mysqldump no host de origem (ou em qualquer máquina com acesso a ele):
mysqldump \
--host=host_de_origem \
--user=usuario \
--password \
--single-transaction \
--routines --triggers --events \
--set-gtid-purged=OFF \
--no-tablespaces \
--databases nome_do_banco \
| gzip > backup_file.sql.gz
Substitua:
host_de_origempelo endereço do servidor MySQL de origem.usuariopelo usuário administrador do banco de origem.nome_do_bancopelo banco a exportar. Para exportar vários bancos, liste-os separados por espaço.
As opções utilizadas no comando têm os seguintes efeitos:
| Opção | Descrição |
|---|---|
--single-transaction | Exporta a partir de um snapshot consistente do InnoDB, sem bloquear as tabelas para escrita. |
--routines --triggers --events | Inclui stored procedures, functions, triggers e events, que ficam de fora por padrão. |
--set-gtid-purged=OFF | Evita incluir no arquivo o comando SET @@GLOBAL.GTID_PURGED, que alteraria o estado de replicação da instância de destino com os GTIDs do servidor de origem. Esse valor não tem utilidade em uma carga lógica e pode interferir na replicação de um cluster Multi-AZ. |
--no-tablespaces | Dispensa o privilégio PROCESS na origem, exigido pelo mysqldump a partir do MySQL 8.0.21. |
--databases | Inclui os comandos CREATE DATABASE e USE no arquivo, dispensando a criação manual do banco no destino. |
Se a origem for MySQL 5.7 ou anterior e o cliente for 8.x, adicione --column-statistics=0. Se houver colunas binárias (BLOB, VARBINARY), adicione --hex-blob.
Remover as cláusulas DEFINER
Views, triggers, routines e events são exportados com a cláusula DEFINER='usuario'@'host' do usuário que os criou na origem. Se esse usuário for uma conta de sistema da instância de destino, como root@localhost (o caso mais comum em servidores próprios), a importação falha com o erro Access denied; you need (at least one of) the SYSTEM_USER privilege(s). Remova a cláusula do arquivo antes da importação, para que os objetos sejam criados em nome do usuário que executa a restauração:
zcat backup_file.sql.gz \
| sed -E 's/DEFINER=`[^`]+`@`[^`]+`//g' \
| gzip > backup_file_sem_definer.sql.gz
Transferir o arquivo para a Magalu Cloud
Copie o arquivo para a Máquina Virtual na Magalu Cloud. Para arquivos grandes, prefira o rsync, que permite retomar a transferência em caso de interrupção:
rsync -avP backup_file_sem_definer.sql.gz ubuntu@ip_publico_da_vm:/dados/
Substitua:
ip_publico_da_vmpelo endereço IP público da Máquina Virtual.
Restaurar os dados na instância de destino
Na Máquina Virtual, execute a restauração apontando para a instância de destino:
gunzip < backup_file_sem_definer.sql.gz \
| mysql --host=ip_privado_da_instancia --user=usuario --password --max-allowed-packet=1G
Substitua:
ip_privado_da_instanciapelo IP privado da instância MySQL na Magalu Cloud.usuariopelo usuário administrador da instância.
Se você não utilizou --databases na exportação, conecte-se à instância, crie o banco de destino e informe o nome dele ao final do comando mysql.
Se ocorrer o erro MySQL server has gone away ou Got a packet bigger than 'max_allowed_packet' bytes, aumente o parâmetro max_allowed_packet da instância de destino pelo grupo de parâmetros.
Opção 2: mydumper e myloader (recomendado)
O mydumper/myloader é uma ferramenta open-source de backup lógico multi-thread para MySQL. O mydumper exporta os dados em paralelo, gerando um diretório com um arquivo por objeto (tabelas grandes são divididas em vários arquivos), e o myloader restaura esse diretório também em paralelo. Em bases de maior volume, costuma ser significativamente mais rápida que o mysqldump.
Pré-requisitos
Instale o mydumper (o pacote já inclui o myloader) no host de origem e na Máquina Virtual da Magalu Cloud:
sudo install -d -m 0755 /etc/apt/keyrings
wget -qO- 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x1D357EA7D10C9320371BDD0279EA15C0E82E34BA&exact=on' | sudo tee /etc/apt/keyrings/mydumper.asc
echo "deb [signed-by=/etc/apt/keyrings/mydumper.asc] https://mydumper.github.io/mydumper/repo/apt/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee /etc/apt/sources.list.d/mydumper.list
sudo apt update && sudo apt install -y mydumper
sudo install -d -m 0755 /etc/apt/keyrings
wget -qO- 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x1D357EA7D10C9320371BDD0279EA15C0E82E34BA&exact=on' | sudo tee /etc/apt/keyrings/mydumper.asc
echo "deb [signed-by=/etc/apt/keyrings/mydumper.asc] https://mydumper.github.io/mydumper/repo/apt/debian $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee /etc/apt/sources.list.d/mydumper.list
sudo apt update && sudo apt install -y mydumper
wget -O GPG-KEY-MyDumper "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x79EA15C0E82E34BA"
sudo rpm --import GPG-KEY-MyDumper
sudo tee /etc/yum.repos.d/mydumper.repo <<'EOF'
[mydumper]
name=MyDumper
baseurl=https://mydumper.github.io/mydumper/repo/yum/$releasever
enabled=1
gpgcheck=1
EOF
sudo yum install -y mydumper
Para outras distribuições, containers ou compilação a partir do código-fonte, consulte a documentação oficial de instalação.
Os nomes de algumas opções mudaram ao longo das versões do mydumper. Esta página utiliza os nomes da versão estável atual. Se o seu pacote for mais antigo, confira os nomes equivalentes com mydumper --help e myloader --help, e utilize a mesma versão na origem e no destino.
Exportar os dados da origem
Execute o mydumper no host de origem (ou em uma máquina com acesso a ele):
mydumper \
--host=host_de_origem \
--user=usuario \
--ask-password \
--database=nome_do_banco \
--outputdir=./backup-mysql \
--threads=4 \
--rows=1000000 \
--compress \
--triggers --events --routines \
--skip-definer \
--checksum-all \
--trx-tables \
--table-engine-for-view-dependency=InnoDB
Substitua:
host_de_origempelo endereço do servidor MySQL de origem.usuariopelo usuário administrador do banco de origem.nome_do_bancopelo banco a exportar. Para vários bancos, separe os nomes por vírgula.
As opções utilizadas no comando têm os seguintes efeitos:
| Opção | Descrição |
|---|---|
--threads | Número de threads de exportação. Ajuste de acordo com as vCPUs e a carga do servidor de origem, para não degradar a aplicação durante o dump. |
--rows | Divide as tabelas em arquivos de aproximadamente N linhas. Sem essa opção, cada tabela vira um único arquivo e não pode ser exportada nem importada em paralelo. |
--compress | Comprime os arquivos de dados, reduzindo o espaço em disco e o tempo de transferência para a Magalu Cloud. |
--triggers --events --routines | Inclui triggers, events, stored procedures e functions, que ficam de fora por padrão. |
--skip-definer | Remove a cláusula DEFINER dos objetos exportados (veja Remover as cláusulas DEFINER). |
--checksum-all | Grava checksums dos dados e da estrutura, que o myloader compara ao final da carga. |
--trx-tables | Informa que todas as tabelas são InnoDB. O mydumper garante a consistência por snapshot de transação, sem executar FLUSH TABLES WITH READ LOCK, que exige o privilégio RELOAD e pode travar a origem. Remova esta opção se houver tabelas MyISAM. O aviso sobre coordenadas do binlog que ela gera pode ser ignorado. |
--table-engine-for-view-dependency=InnoDB | Define o engine da tabela temporária que o mydumper cria como dependência de cada view. O padrão é MEMORY, cuja criação o DBaaS não permite, e sem esta opção a importação aborta com ERROR 3161: Storage engine MEMORY is disabled. |
Outras opções úteis:
--tables-list=banco.tabela1,banco.tabela2ou--regexpara exportar apenas parte das tabelas;--where="updated_at >= '2026-10-01'"para exportar apenas as linhas alteradas após uma carga inicial;--no-datapara exportar apenas a estrutura e validar a criação dos objetos no destino antes da carga completa;--disk-limitspara pausar a exportação quando o disco livre ficar abaixo de um limite;--logfilee--verbose=3para gravar um log detalhado da exportação.
Para a lista completa de opções, consulte a documentação oficial de uso do mydumper.
Transferir o diretório para a Magalu Cloud
Empacote o diretório gerado e envie-o para a Máquina Virtual:
tar -cf backup-mysql.tar backup-mysql/
rsync -avP backup-mysql.tar ubuntu@ip_publico_da_vm:/dados/
Substitua:
ip_publico_da_vmpelo endereço IP público da Máquina Virtual.
Na Máquina Virtual, descompacte o arquivo:
cd /dados && tar -xf backup-mysql.tar
Alternativamente, envie o diretório para um bucket do Object Storage e baixe-o na Máquina Virtual, o que é útil quando a origem não tem acesso SSH direto à VM.
Restaurar os dados na instância de destino
Na Máquina Virtual, execute o myloader apontando para a instância de destino:
myloader \
--host=ip_privado_da_instancia \
--user=usuario \
--ask-password \
--directory=./backup-mysql \
--threads=4 \
--optimize-keys=AFTER_IMPORT_PER_TABLE \
--checksum=fail
Substitua:
ip_privado_da_instanciapelo IP privado da instância MySQL na Magalu Cloud.usuariopelo usuário administrador da instância.
O myloader cria os bancos automaticamente a partir dos arquivos do backup, sem necessidade de criá-los manualmente.
As opções utilizadas no comando têm os seguintes efeitos:
| Opção | Descrição |
|---|---|
--threads | Número de threads de importação. Como regra inicial, utilize o número de vCPUs da instância de destino. |
--optimize-keys | Cria as tabelas sem índices secundários, carrega os dados e só então cria os índices, o que é significativamente mais rápido no InnoDB. |
--checksum=fail | Compara os checksums gravados pelo mydumper --checksum-all com os objetos restaurados e aborta se houver divergência. |
Outras opções úteis:
--source-db=loja --database=loja_novapara restaurar um banco com outro nome;--drop-table=DROP(ouTRUNCATE) para recriar tabelas que já existem no destino. O padrão é abortar a carga;--resumepara retomar uma carga interrompida de onde parou, sem recarregar as tabelas concluídas;--skip-triggers --skip-postpara carregar os dados primeiro e importar triggers, routines e events em uma segunda execução, com--no-data --no-schemas.
Para a lista completa de opções, consulte a documentação oficial de uso do myloader.
Acelerar a carga desabilitando o redo log
O myloader oferece a opção --disable-redo-log, que desabilita o redo log do InnoDB durante a restauração e o reabilita automaticamente ao final. Sem as escritas no redo log e no doublewrite buffer, é comum observar uma carga de 3 a 4 vezes mais rápida.
myloader \
--host=ip_privado_da_instancia \
--user=usuario \
--ask-password \
--directory=./backup-mysql \
--disable-redo-log
Só desabilite o redo log para a carga inicial de uma instância vazia, nunca em uma instância que já contenha dados que você precisa manter ou que esteja em produção. Com o redo log desabilitado, qualquer interrupção inesperada do servidor pode causar perda de dados e corrupção da instância. Em uma carga inicial isso é apenas um contratempo (basta recriar a instância e refazer a carga), mas em um banco com dados relevantes o mesmo incidente destrói a base.
Se o myloader for interrompido ou abortar por erro, o redo log permanece desabilitado. Antes de qualquer outra operação, reabilite-o manualmente com ALTER INSTANCE ENABLE INNODB REDO_LOG; e confirme com SHOW GLOBAL STATUS LIKE 'Innodb_redo_log_enabled';.
Com o redo log desabilitado, o gargalo passa a ser a vazão do disco, e um número alto de threads não traz ganho. Com o redo log habilitado, utilize --threads próximo ao número de vCPUs da instância de destino.
Usar um arquivo de configuração (.cnf)
Em vez de repetir as opções em cada execução, você pode consolidá-las em um arquivo de configuração e reutilizá-lo com --defaults-file. Essa também é a forma recomendada de definir variáveis de sessão do myloader, como manter o log binário ativo durante a carga, o que é obrigatório ao carregar um cluster sem o modo de importação (veja Migrar para um cluster Multi-AZ).
Crie um arquivo migracao.cnf:
[mydumper]
host=host_de_origem
user=usuario
threads=4
rows=1000000
compress=1
triggers=1
events=1
routines=1
skip-definer=1
checksum-all=1
trx-tables=1
table-engine-for-view-dependency=InnoDB
[myloader]
host=ip_privado_da_instancia
user=usuario
threads=4
optimize-keys=AFTER_IMPORT_PER_TABLE
checksum=fail
[myloader_session_variables]
SQL_LOG_BIN=1
Substitua os valores de host e user de cada seção pelos dados do respectivo servidor (origem em [mydumper], destino em [myloader]). E utilize o arquivo nos dois comandos:
mydumper --defaults-file=./migracao.cnf --ask-password --database=nome_do_banco --outputdir=./backup-mysql
myloader --defaults-file=./migracao.cnf --ask-password --directory=./backup-mysql
Para a lista completa de seções e variáveis disponíveis, consulte a documentação oficial de uso do mydumper.
Migração em streaming
Se a máquina que executa os comandos consegue alcançar tanto a origem quanto a instância na Magalu Cloud (por exemplo, a Máquina Virtual com acesso ao servidor de origem via VPN), é possível encadear o mydumper e o myloader em um único pipeline, sem gravar o backup em disco:
mydumper --defaults-file=./migracao.cnf --database=nome_do_banco --stream \
| myloader --defaults-file=./migracao.cnf --stream
Nesse modo, o --ask-password não pode ser utilizado, pois os dois processos compartilham o terminal. Informe as senhas no arquivo .cnf, com password=senha_origem na seção [mydumper] e password=senha_destino na seção [myloader], e restrinja a permissão do arquivo com chmod 600 migracao.cnf. Evite passar --password na linha de comando: a senha ficaria visível no histórico do shell e na lista de processos. Como não há arquivo intermediário, também não é possível utilizar --resume: se a carga falhar, ela precisa ser reiniciada do zero.
Migrar para um cluster Multi-AZ
Um cluster Multi-AZ é composto por uma instância primária (leitura e escrita, porta 3306) e duas instâncias secundárias, as réplicas stand-by (somente leitura, porta 3307), mantidas em sincronia via Group Replication, que propaga as transações pelo log binário.
A forma recomendada de carregar um cluster é o modo de importação. Enquanto ele está ativo, as instâncias secundárias deixam de replicar a primária. Ao sair do modo de importação, elas são reconstruídas a partir de uma cópia completa dos dados da primária. Por isso, durante o modo de importação, o log binário da sessão de carga não afeta as secundárias: o padrão do myloader (SQL_LOG_BIN=0) pode ser mantido. O modo de importação também já desabilita o redo log da primária, então a opção --disable-redo-log do myloader é desnecessária nesse caso.
Enquanto o modo de importação estiver ativo, o cluster fica sem alta disponibilidade e a primária opera com o redo log desabilitado. Uma interrupção inesperada da primária nesse período pode causar perda de dados e corrupção da instância. Use o modo de importação apenas durante a carga inicial e saia dele assim que a carga terminar.
Ao restaurar em um cluster, com qualquer uma das duas opções:
-
Execute a carga (
mysqloumyloader) sempre contra a porta 3306 (instância primária). -
Coloque o cluster em modo de importação antes da carga, informando o ID do cluster de destino:
mgc dbaas clusters start-import-mode [flags]Flags
Obrigatórios
cluster-id(string): Valor referente ao ID do cluster.
-
Execute a carga normalmente, conforme descrito nas seções anteriores.
-
Retorne o cluster ao modo normal de operação ao final da carga:
mgc dbaas clusters stop-import-mode [flags]Flags
Obrigatórios
cluster-id(string): Valor referente ao ID do cluster.
A reconstrução das secundárias leva mais tempo quanto maior for o volume de dados. Aguarde o cluster voltar ao status
ACTIVEantes de seguir. -
Valide também as secundárias (porta 3307), não só a primária.
Se não for usar o modo de importação, as secundárias recebem a carga em tempo real, pelo log binário. Nesse caso, mantenha o log binário ativo durante toda a carga, definindo SQL_LOG_BIN=1 na seção [myloader_session_variables] do arquivo de configuração. O arquivo gerado pelo mysqldump com --set-gtid-purged=OFF, como no exemplo da Opção 1, não desabilita o log binário e não precisa de ajuste.
Fora do modo de importação, uma carga com SQL_LOG_BIN=0 (o padrão do myloader) não é replicada: as linhas inseridas na primária não chegam às secundárias, que ficam sem os dados, comprometendo a alta disponibilidade.
Os detalhes completos desse procedimento estão na seção Migrar para um cluster Multi-AZ da página de migração entre versões.
Validar a migração
Após a restauração, valide a consistência dos dados entre a origem e a instância de destino antes de redirecionar a aplicação:
-
Compare a lista de bancos e tabelas nos dois lados (
SHOW DATABASES;/SHOW TABLES;). -
Compare a quantidade de views, routines, triggers e events:
SELECT table_type, COUNT(*) FROM information_schema.tablesWHERE table_schema = 'nome_do_banco' GROUP BY table_type;SELECT routine_type, COUNT(*) FROM information_schema.routinesWHERE routine_schema = 'nome_do_banco' GROUP BY routine_type;SELECT COUNT(*) FROM information_schema.triggers WHERE trigger_schema = 'nome_do_banco';SELECT COUNT(*) FROM information_schema.events WHERE event_schema = 'nome_do_banco'; -
Compare a contagem de linhas por tabela (
SELECT COUNT(*) FROM nome_da_tabela;). -
Compare o checksum das tabelas com o comando nativo do MySQL
CHECKSUM TABLE, executado nos dois lados. Se você utilizoumydumper --checksum-allemyloader --checksum=fail, essa verificação já foi feita automaticamente ao final da carga.CHECKSUM TABLE nome_do_banco.nome_da_tabela;
Se os valores retornados forem iguais nos dois lados, os dados foram migrados corretamente. Por fim, aponte um ambiente de homologação da aplicação para a nova instância e execute os testes funcionais antes da virada definitiva.
Problemas comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
ERROR 1419: You do not have the SUPER privilege and binary logging is enabled ao criar triggers ou functions | O log binário está ativo e o parâmetro log_bin_trust_function_creators está desligado (padrão). | Habilite log_bin_trust_function_creators no grupo de parâmetros da instância, ou execute SET PERSIST log_bin_trust_function_creators = 1; como usuário administrador, e refaça a carga. |
ERROR 1227: Access denied; you need (at least one of) the SYSTEM_USER privilege(s) na importação | Objetos com cláusula DEFINER de uma conta de sistema, como root@localhost. | Exporte com mydumper --skip-definer ou importe com myloader --skip-definer. Com mysqldump, remova o DEFINER com sed (veja Remover as cláusulas DEFINER). |
ERROR 3161: Storage engine MEMORY is disabled e o myloader aborta | O backup contém views, e o mydumper gerou a tabela temporária de dependência de cada view com ENGINE=MEMORY, que o DBaaS não permite criar. | Refaça a exportação com --table-engine-for-view-dependency=InnoDB. Para aproveitar um backup já gerado, importe com myloader --ignore-errors=3161. |
Innodb_redo_log_enabled continua OFF após uma carga com --disable-redo-log | O myloader foi interrompido ou abortou antes de reabilitar o redo log. | Execute ALTER INSTANCE ENABLE INNODB REDO_LOG; como usuário administrador. |
MySQL server has gone away ou Got a packet bigger than 'max_allowed_packet' bytes | Linhas ou INSERTs maiores que o limite do servidor. | Aumente max_allowed_packet no grupo de parâmetros da instância de destino. |
Access denied; you need (at least one of) the RELOAD privilege(s) na exportação | A origem (geralmente outro serviço gerenciado) não permite FLUSH TABLES WITH READ LOCK. | Utilize mydumper --trx-tables (origem 100% InnoDB). Com mysqldump, utilize --single-transaction. |
Unknown collation: 'utf8mb4_uca1400_ai_ci' (ou outra collation desconhecida) | Origem em MariaDB, cujas collations da família uca1400 não existem no MySQL. | Converta as tabelas e colunas para uma collation existente no MySQL (como utf8mb4_0900_ai_ci) antes da exportação, ou substitua o nome da collation nos arquivos do dump antes da carga. |
Erros de sql_mode, como Incorrect datetime value ou Field doesn't have a default value | O sql_mode padrão do MySQL 8.x é mais estrito que o de versões antigas ou de configurações personalizadas. | Defina o mesmo sql_mode da origem no grupo de parâmetros do destino. |
| Importação muito lenta | Tabelas em arquivo único, poucas threads ou instância subdimensionada. | Utilize --rows na exportação, --optimize-keys e --threads adequados na importação e, se preciso, aumente temporariamente o tipo da instância. |
Próximos passos
- Recrie os usuários e permissões na nova instância, conforme Gerenciar usuários e permissões;
- Atualize a connection string das suas aplicações para apontar para o IP privado da instância na Magalu Cloud. Aplicações hospedadas fora da rede privada precisam de VPN ou de uma Máquina Virtual (Jumphost) para acessá-la;
- Crie um snapshot da instância logo após a validação, para ter um ponto de restauração do estado inicial;
- Monitore o desempenho e os logs de acesso da nova instância após a virada, e ajuste o grupo de parâmetros ou o tipo da instância conforme necessário;
- Somente após validar que a aplicação está estável na Magalu Cloud, desative o banco de origem, mantendo um backup final dele.
Em caso de dúvidas
Se tiver qualquer dúvida durante o processo de migração, abra um Ticket de suporte e nossa equipe irá te auxiliar.