ApsaraDB RDS:Migrate the data of a self-managed instance that runs MySQL 5.7 or MySQL 8.0 to an ApsaraDB RDS for MySQL instance

Identificar objetos que não são migrados

Execute a consulta a seguir na instância de origem para listar procedimentos armazenados e funções que precisam ser recriados após a migração:

SELECT ROUTINE_SCHEMA, ROUTINE_NAME, ROUTINE_TYPE
FROM information_schema.routines
WHERE ROUTINE_SCHEMA NOT IN ('sys', 'information_schema', 'performance_schema', 'mysql');

Registre também as contas de usuário e as configurações de fuso horário antes de prosseguir.

Instalar dependências (CentOS)

sudo yum install -y go
sudo yum install -y unzip

Para Ubuntu, consulte o Apêndice 2.

Compilar o MySQL Backup Helper

1. Baixe o código-fonte:

   wget https://github.com/aliyun/mysql-backup-helper/archive/refs/heads/master.zip

2. Descompacte o pacote:

   unzip master.zip

3. Compile o backup_helper:

   cd mysql-backup-helper-master
   go build -a -o backup_helper main.go

4. Compile o oss_stream:

   cd oss_stream
   go build -a -o oss_stream oss_stream.go

3,1 Verificar a compatibilidade da migração

Execute o backup_helper para confirmar se a instância de origem suporta a migração:

cd ~/mysql-backup-helper-master && ./backup_helper \
  -host <host-ip> \
  -port <port> \
  -user <username> \
  --password <password>

Substitua os espaços reservados pelos valores reais:

Se a verificação for bem-sucedida, prossiga para a próxima etapa.

3,2 Fazer backup e enviar para o OSS

Execute o backup e transmita-o diretamente para o bucket do OSS. Selecione o comando correspondente à sua versão do MySQL.

innobackupex --backup \
  --host=<host-ip> \
  --port=<port> \
  --user=<username> \
  --password=<password> \
  --stream=xbstream \
  --compress <temp-dir> | \
  ./mysql-backup-helper-master/oss_stream/oss_stream \
  -accessKeyId <AccessKey-ID> \
  -accessKeySecret <AccessKey-secret> \
  -bucketName <bucket-name> \
  -endpoint <OSS-endpoint> \
  -objectName <backup-file-name>

innobackupex --backup --host=127.0.0.1 --port=3306 --user=root --password=Aa123456@ \
  --stream=xbstream --compress /root/mysql/data | \
  ./mysql-backup-helper-master/oss_stream/oss_stream \
  -accessKeyId LTAI**************** \
  -accessKeySecret ****** \
  -bucketName test \
  -endpoint oss-ap-southeast-1.aliyuncs.com \
  -objectName backup_qp.xb

xtrabackup --backup \
  --host=<host-ip> \
  --port=<port> \
  --user=<username> \
  --password=<password> \
  --stream=xbstream \
  --compress <temp-dir> | \
  ./mysql-backup-helper-master/oss_stream/oss_stream \
  -accessKeyId <AccessKey-ID> \
  -accessKeySecret <AccessKey-secret> \
  -bucketName <bucket-name> \
  -endpoint <OSS-endpoint> \
  -objectName <backup-file-name>

xtrabackup --backup --host=127.0.0.1 --port=3306 --user=root --password=Aa123456@ \
  --stream=xbstream --compress /root/mysql/data | \
  ./mysql-backup-helper-master/oss_stream/oss_stream \
  -accessKeyId LTAI**************** \
  -accessKeySecret ******** \
  -bucketName test \
  -endpoint oss-ap-southeast-1.aliyuncs.com \
  -objectName backup_qp.xb

Substitua os espaços reservados pelos valores reais:

Para bancos de dados grandes, execute o comando com nohup para evitar interrupções caso a sessão seja desconectada. MySQL 5.7: MySQL 8.0:

nohup sh -c 'innobackupex --backup --host=127.0.0.1 --port=3306 --user=root --password=Aa123456@ --stream=xbstream --compress /root/mysql/data | ./mysql-backup-helper-master/oss_stream/oss_stream -accessKeyId LTAI**************** -accessKeySecret ****** -bucketName test -endpoint oss-ap-southeast-1.aliyuncs.com -objectName backup_qp.xb' &

nohup sh -c 'xtrabackup --backup --host=127.0.0.1 --port=3306 --user=root --password=Aa123456@ \
  --stream=xbstream --compress /root/mysql/data | \
  ./mysql-backup-helper-master/oss_stream/oss_stream \
  -accessKeyId LTAI**************** -accessKeySecret ****** \
  -bucketName test -endpoint oss-ap-southeast-1.aliyuncs.com -objectName backup_qp.xb' &

Quando o backup for concluído, o terminal exibirá completed OK !.

Faça login no console do OSS para confirmar se o arquivo foi enviado com sucesso. Se o upload falhar, execute o comando de backup novamente.

Se o OSS estiver temporariamente indisponível, salve o backup em um arquivo local primeiro e faça o upload posteriormente. Consulte o Apêndice 3: Fazer backup localmente e enviar para o OSS.

3,3 Importar o backup no console do ApsaraDB RDS

1. Faça login no console do ApsaraDB RDS. Na barra de navegação superior, selecione a região da instância RDS de destino. No painel de navegação à esquerda, clique em Backups.

2. Na aba User Backups, clique em Import Backup.

3. No assistente Import Guide, leia as instruções e clique em Next até chegar à etapa 3. Import Data.

   As etapas 1. Back Up Source Database e 2. Upload Backup Files to OSS do assistente correspondem às etapas 3,1 e 3,2 deste guia.

4. Na etapa 3. Import Data, configure os parâmetros a seguir e clique em OK.

   Se o ApsaraDB RDS não estiver autorizado a acessar o OSS, clique em Authorize na parte inferior desta etapa. Na página exibida, clique em Confirm Authorization Policy .

   Parâmetro	Descrição
   MySQL version	Exibe 5.7/8.0 automaticamente. Tanto o MySQL 5.7 quanto o MySQL 8.0 são suportados.
   Region	Região do bucket do OSS que armazena o arquivo de backup. Deve corresponder à região da instância RDS de destino.
   OSS Bucket	Bucket do OSS que contém o arquivo de backup. Consulte Upload objects para obter detalhes.
   OSS file name	Objeto de backup no bucket do OSS. Suporta correspondência exata e aproximada. O arquivo deve estar no formato _QP.XB ou compactado como TAR.GZ.
   Note	Descrição opcional para ajudar a identificar o arquivo de backup.
   Zone	Zona do bucket do OSS. Selecionar uma zona permite que o ApsaraDB RDS crie um snapshot em segundos, reduzindo o tempo de importação. A nova instância RDS será criada nesta zona.
   Storage Capacity	Armazenamento necessário para o arquivo de backup. Valores válidos: 20–6000 GB. O padrão é 3× o tamanho do arquivo de backup (mínimo de 20 GB).

5. Na aba User Backups, aguarde até que o Status da tarefa de verificação mude de Verifying para Completed.

   Importante

   O tempo de verificação varia. Instâncias com alta atividade de escrita ou transações grandes durante o backup podem levar mais tempo para serem verificadas.

6. Localize o arquivo de backup e clique em Restore na coluna Actions.

7. Configure os parâmetros a seguir e clique em Next: Instance Configuration.

   Parâmetro	Descrição
   Zone of Primary Node	Zona para a instância RDS primária. Exibido apenas se você não selecionou uma zona ao importar o arquivo de backup.
   Storage Type	ESSD PL1: SSD empresarial de nível de desempenho 1. Standard SSD: Dispositivo de armazenamento em bloco elástico padrão. Consulte Storage types para obter detalhes.
   Instance Type	General-purpose (Entry-level): Memória e I/O alocados exclusivamente, com CPU e armazenamento compartilhados. Consulte Primary ApsaraDB RDS instance types para ver a lista completa.
   Storage Capacity	Armazenamento provisionado para arquivos de dados, sistema, logs e transações. Ajustável em incrementos de 5 GB.

8. Configure os parâmetros a seguir e clique em Next: Confirm Order.

   Parâmetro	Descrição
   Network Type	Selecione VPC. Uma Virtual Private Cloud (VPC) oferece maior segurança e melhor desempenho. Você também deve configurar a VPC e o vSwitch of Primary Node. A instância RDS e qualquer instância ECS à qual você deseje se conectar devem estar na mesma VPC.
   Parameter Template	Modelo de parâmetros do sistema ou personalizado. Consulte Use a parameter template.
   Time Zone	Fuso horário da instância RDS.
   Table Name Case Sensitivity	Se os nomes das tabelas na instância de origem diferenciam maiúsculas de minúsculas, selecione Case-sensitive para manter a consistência.

9. Confirme a configuração da instância na seção Parameters, defina o Purchase Plan, aceite os Termos de Serviço e clique em Pay Now.

   O ApsaraDB RDS leva de 1 a 5 minutos para criar a instância.