ApsaraDB RDS:Migrasikan data dari instans yang dikelola sendiri yang menjalankan MySQL 5.7 atau MySQL 8.0 ke instans ApsaraDB RDS for MySQL

Identifikasi objek yang tidak dimigrasikan

Jalankan kueri berikut pada instans sumber untuk mencantumkan prosedur tersimpan dan fungsi yang perlu Anda buat ulang setelah migrasi:

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

Catat juga akun pengguna dan pengaturan zona waktu sebelum melanjutkan.

Instal dependensi (CentOS)

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

Untuk Ubuntu, lihat Lampiran 2.

Buat MySQL Backup Helper

1. Unduh kode sumber:

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

2. Ekstrak paket:

   unzip master.zip

3. Buat backup_helper:

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

4. Buat oss_stream:

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

3.1 Periksa kompatibilitas migrasi

Jalankan backup_helper untuk memverifikasi bahwa instans sumber mendukung migrasi:

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

Ganti placeholder dengan nilai aktual Anda:

Jika pemeriksaan berhasil, lanjutkan ke langkah berikutnya.

3.2 Cadangkan dan unggah ke OSS

Jalankan pencadangan dan alirkan langsung ke bucket OSS Anda. Pilih perintah sesuai versi MySQL Anda.

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

Ganti placeholder dengan nilai aktual Anda:

Untuk database besar, jalankan perintah dengan nohup agar tidak terganggu jika sesi terputus. 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' &

Saat pencadangan selesai, terminal akan menampilkan completed OK !.

Login ke konsol OSS untuk memastikan file berhasil diunggah. Jika pengunggahan gagal, jalankan kembali perintah pencadangan.

Jika OSS sementara tidak tersedia, simpan cadangan ke file lokal terlebih dahulu lalu unggah nanti. Lihat Lampiran 3: Cadangkan secara lokal dan unggah ke OSS.

3.3 Impor cadangan di konsol ApsaraDB RDS

1. Login ke konsol ApsaraDB RDS. Di bilah navigasi atas, pilih wilayah instans RDS tujuan. Di panel navigasi kiri, klik Backups.

2. Di tab User Backups, klik Import Backup.

3. Pada wizard Import Guide, baca instruksi dan klik Next hingga mencapai 3. Import Data.

   Langkah 1. Back Up Source Database dan 2. Upload Backup Files to OSS dalam wizard ini sesuai dengan Langkah 3.1 dan 3.2 dalam panduan ini.

4. Pada langkah 3. Import Data, konfigurasikan parameter berikut lalu klik OK.

   Jika ApsaraDB RDS belum diberi otorisasi untuk mengakses OSS, klik Authorize di bagian bawah langkah ini. Di halaman yang muncul, klik Confirm Authorization Policy.

   Parameter	Description
   MySQL version	Menampilkan 5.7/8.0 secara otomatis. MySQL 5.7 dan MySQL 8.0 keduanya didukung.
   Region	Wilayah bucket OSS yang menyimpan file cadangan. Harus sesuai dengan wilayah instans RDS tujuan.
   OSS Bucket	Bucket OSS yang berisi file cadangan. Lihat Upload objects untuk detailnya.
   OSS file name	Objek cadangan di bucket OSS. Mendukung pencocokan fuzzy dan eksak. File harus dalam format _QP.XB, atau dikompresi sebagai TAR.GZ.
   Note	Deskripsi opsional untuk membantu mengidentifikasi file cadangan.
   Zone	Zona bucket OSS. Memilih zona memungkinkan ApsaraDB RDS membuat snapshot dalam hitungan detik, sehingga mengurangi waktu impor. Instans RDS baru akan dibuat di zona ini.
   Storage Capacity	Kapasitas penyimpanan yang diperlukan untuk file cadangan. Nilai valid: 20–6000 GB. Default-nya 3× ukuran file cadangan (minimum 20 GB).

5. Di tab User Backups, tunggu hingga Status tugas verifikasi berubah dari Verifying menjadi Completed.

   Penting

   Waktu verifikasi bervariasi. Instans dengan aktivitas write tinggi atau transaksi besar selama pencadangan mungkin memerlukan waktu verifikasi lebih lama.

6. Temukan file cadangan dan klik Restore di kolom Actions.

7. Konfigurasikan parameter berikut lalu klik Next: Instance Configuration.

   Parameter	Description
   Zone of Primary Node	Zona untuk instans RDS utama. Hanya ditampilkan jika Anda tidak memilih zona saat mengimpor file cadangan.
   Storage Type	ESSD PL1: Enterprise SSD tingkat kinerja 1. Standard SSD: Perangkat penyimpanan blok elastis standar. Lihat Storage types untuk detailnya.
   Instance Type	General-purpose (Entry-level): Memori dan I/O dialokasikan eksklusif, dengan CPU dan penyimpanan bersama. Lihat Primary ApsaraDB RDS instance types untuk daftar lengkapnya.
   Storage Capacity	Penyimpanan yang disediakan untuk file data, file sistem, file log, dan file transaksi. Dapat disesuaikan dalam penambahan 5 GB.

8. Konfigurasikan parameter berikut lalu klik Next: Confirm Order.

   Parameter	Description
   Network Type	Pilih VPC. virtual private cloud (VPC) menyediakan keamanan lebih tinggi dan kinerja lebih baik. Anda juga harus mengonfigurasi VPC dan vSwitch of Primary Node. Instans RDS dan instans ECS apa pun yang ingin Anda hubungkan harus berada di VPC yang sama.
   Parameter Template	Template parameter sistem atau kustom. Lihat Use a parameter template.
   Time Zone	Zona waktu untuk instans RDS.
   Table Name Case Sensitivity	Jika nama tabel di instans sumber peka huruf besar/kecil, pilih Case-sensitive untuk menjaga konsistensi.

9. Konfirmasi konfigurasi instans di bagian Parameters, atur Purchase Plan, terima Ketentuan Layanan, lalu klik Pay Now.

   ApsaraDB RDS memerlukan waktu 1–5 menit untuk membuat instans.