Skip to main content

Migrar um banco de dados para a Magalu Cloud

Regiões

Este recurso está disponível nas seguintes regiões:
br-se1
br-ne1

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.

Informação

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:

  1. Verificação de compatibilidade
  2. Criação da instância de destino
  3. Migração dos dados, com mysqldump ou com mydumper/myloader
  4. Validação da migração
Aviso

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_mode padrão, e desabilitou por padrão o plugin de autenticação mysql_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.0

    Substitua:

    • usuario pelo usuário administrador do banco de origem.
    • host_de_origem pelo 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.

Dica

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_gb
    FROM information_schema.tables
    GROUP BY table_schema
    ORDER 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.

Nota

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.

Aviso

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; e SHOW GRANTS FOR 'usuario'@'host';.
  • Os schemas de sistema mysql, sys, information_schema e performance_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 mysql instalado (necessário para o mysqldump/mysql e para as validações);
  • O mydumper instalado, 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:

AbordagemIndicada paraCaracterísticas
mysqldump e mysqlBancos pequenos, ambientes de teste e cenários simplesFerramentas nativas do MySQL, instaladas junto com o cliente. Exportação e importação em um único arquivo .sql, sem paralelismo.
mydumper e myloaderBancos médios e grandes, ou janelas de migração curtasFerramenta 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_origem pelo endereço do servidor MySQL de origem.
  • usuario pelo usuário administrador do banco de origem.
  • nome_do_banco pelo 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çãoDescrição
--single-transactionExporta a partir de um snapshot consistente do InnoDB, sem bloquear as tabelas para escrita.
--routines --triggers --eventsInclui stored procedures, functions, triggers e events, que ficam de fora por padrão.
--set-gtid-purged=OFFEvita 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-tablespacesDispensa o privilégio PROCESS na origem, exigido pelo mysqldump a partir do MySQL 8.0.21.
--databasesInclui 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_vm pelo 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_instancia pelo IP privado da instância MySQL na Magalu Cloud.
  • usuario pelo 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.

Nota

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.

Nota

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_origem pelo endereço do servidor MySQL de origem.
  • usuario pelo usuário administrador do banco de origem.
  • nome_do_banco pelo 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çãoDescrição
--threadsNú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.
--rowsDivide 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.
--compressComprime os arquivos de dados, reduzindo o espaço em disco e o tempo de transferência para a Magalu Cloud.
--triggers --events --routinesInclui triggers, events, stored procedures e functions, que ficam de fora por padrão.
--skip-definerRemove a cláusula DEFINER dos objetos exportados (veja Remover as cláusulas DEFINER).
--checksum-allGrava checksums dos dados e da estrutura, que o myloader compara ao final da carga.
--trx-tablesInforma 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=InnoDBDefine 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.tabela2 ou --regex para exportar apenas parte das tabelas;
  • --where="updated_at >= '2026-10-01'" para exportar apenas as linhas alteradas após uma carga inicial;
  • --no-data para exportar apenas a estrutura e validar a criação dos objetos no destino antes da carga completa;
  • --disk-limits para pausar a exportação quando o disco livre ficar abaixo de um limite;
  • --logfile e --verbose=3 para 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_vm pelo 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_instancia pelo IP privado da instância MySQL na Magalu Cloud.
  • usuario pelo 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çãoDescrição
--threadsNúmero de threads de importação. Como regra inicial, utilize o número de vCPUs da instância de destino.
--optimize-keysCria 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=failCompara 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_nova para restaurar um banco com outro nome;
  • --drop-table=DROP (ou TRUNCATE) para recriar tabelas que já existem no destino. O padrão é abortar a carga;
  • --resume para retomar uma carga interrompida de onde parou, sem recarregar as tabelas concluídas;
  • --skip-triggers --skip-post para 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
Perigo

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.

Aviso

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:

  1. Execute a carga (mysql ou myloader) sempre contra a porta 3306 (instância primária).

  2. 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.
  3. Execute a carga normalmente, conforme descrito nas seções anteriores.

  4. 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 ACTIVE antes de seguir.

  5. 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.

Aviso

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.tables
    WHERE table_schema = 'nome_do_banco' GROUP BY table_type;

    SELECT routine_type, COUNT(*) FROM information_schema.routines
    WHERE 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ê utilizou mydumper --checksum-all e myloader --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​

SintomaCausa provávelSolução
ERROR 1419: You do not have the SUPER privilege and binary logging is enabled ao criar triggers ou functionsO 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çãoObjetos 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 abortaO 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-logO 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' bytesLinhas 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çãoA 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 valueO 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 lentaTabelas 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​

  1. Recrie os usuários e permissões na nova instância, conforme Gerenciar usuários e permissões;
  2. 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;
  3. Crie um snapshot da instância logo após a validação, para ter um ponto de restauração do estado inicial;
  4. 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;
  5. 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.