Proses tugas migrasi dapat menimbulkan error selama runtime.
- Beberapa error, seperti sandi yang salah di database sumber, dapat dipulihkan, yang berarti error tersebut dapat diperbaiki dan tugas migrasi akan dilanjutkan secara otomatis.
- Beberapa di antaranya tidak dapat dipulihkan, seperti posisi binlog yang hilang, yang berarti tugas migrasi harus dimulai ulang dari awal.
Jika terjadi error, status tugas migrasi akan berubah menjadi Failed, dan sub-status mencerminkan status terakhir sebelum terjadi kegagalan.
Untuk memecahkan masalah error, buka tugas migrasi yang gagal untuk melihat error dan ikuti langkah-langkah yang diuraikan dalam pesan error.
Untuk melihat detail selengkapnya tentang error, buka Cloud Monitoring menggunakan link di tugas migrasi. Log difilter ke tugas migrasi tertentu.
Dalam tabel berikut, Anda dapat menemukan beberapa contoh masalah dan cara mengatasinya:
| Untuk masalah ini... | Kemungkinan masalah... | Coba yang ini... |
|---|---|---|
| Setelan database tujuan berbeda dengan konfigurasi Terraform yang digunakan untuk menyediakan database. (Masalah ini juga terkadang disebut sebagai penyimpangan konfigurasi.) | Saat Anda bermigrasi ke database tujuan yang ada, Database Migration Service akan mengubah setelan tertentu pada database tujuan Anda untuk menjalankan tugas migrasi. | Anda harus menerapkan ulang setelan yang digunakan dalam konfigurasi Terraform setelah mempromosikan tugas migrasi. Lihat Penyimpangan konfigurasi Terraform. |
Pesan error: Error processing table {table_name}: MySQL Error 1118
(42000): Row size too large (>8126). |
Tabel yang menggunakan kolom VARCHAR mungkin memiliki baris yang melebihi ukuran maksimum yang diizinkan oleh InnoDB (mesin penyimpanan default yang digunakan di MySQL). |
Anda dapat membatalkan pemblokiran tugas migrasi dengan mengonversi kolom menjadi BLOB atau TEXT,
atau dengan menyetel sementara flag
innodb_strict_mode ke off.
Lihat Error 1118: ukuran baris terlalu besar. |
Tugas migrasi gagal selama fase dump awal dengan pesan error berikut:ERROR 1064 (42000) at {line_number}: You have an error in your
SQL syntax; check the manual that corresponds to your MySQL server version for
the right syntax to use near {reserved_word} at {line_number}.
|
Masalah ini terjadi saat melakukan migrasi antar-versi MySQL.
Entity dalam versi MySQL sumber Anda mungkin menggunakan kata-kata yang tidak diizinkan
dalam versi MySQL yang ingin Anda migrasikan.
Misalnya, di MySQL 5.7, Anda dapat menggunakan kata |
Ganti nama objek database sumber yang dirujuk dalam pesan error atau letakkan
dalam tanda petik terbalik (``) untuk menghindari sintaksis. Setelah selesai, coba lagi tugas migrasi.
|
Pesan error: ERROR 1109 (42S02): Unknown table in <schema name here> |
Database Migration Service tidak memigrasikan skema sistem mysql,
performance_schema, information_schema,
ndbinfo, atau sys.
Tugas migrasi Anda mungkin gagal jika database sumber berisi objek yang mereferensikan tabel dari salah satu skema ini. |
Periksa database sumber Anda untuk menemukan objek yang merujuk ke tabel yang ada dalam skema sistem yang tidak dimigrasikan. Lihat ERROR 1109 (42S02): Unknown table in <schema name here>. |
Pesan error: Unknown table 'COLUMN_STATISTICS' in information_schema (1109) |
Relevan untuk skenario dump database manual hanya dengan mysqldump.Database MySQL dalam versi sebelum 8 tidak memiliki tabel COLUMN_STATISTICS. Utilitas |
Gunakan flag --column-statistics=0 saat menggunakan mysqldump. |
Pesan error: Specified key was too long; max key length is 767 bytes. |
Instance database sumber mungkin memiliki variabel innodb_large_prefix yang telah ditetapkan. |
Setel flag innodb_large_prefix ke ON saat membuat instance tujuan, atau update instance tujuan yang ada dengan flag tersebut. |
Pesan error: Table definition has changed. |
Ada perubahan bahasa definisi data (DDL) selama proses dump. | Hindari perubahan DDL selama proses dump. |
Pesan error: While 'Loading data': Dump timeout. |
Masalah konektivitas mungkin menyebabkan waktu tunggu habis. | Verifikasi koneksi jaringan dengan database sumber Anda. Untuk contoh panduan, lihat Men-debug konektivitas. |
| Jika ada perubahan bahasa definisi data (DDL) yang dilakukan selama proses dump, Database Migration Service mungkin macet karena kunci metadata. | Selidiki database sumber Anda untuk memeriksa proses yang macet dalam status
Waiting for table metadata lock. Jika Anda menemukan proses dengan status tersebut, sebaiknya mulai ulang tugas migrasi. Jangan melakukan perubahan DDL selama fase dump penuh setelah mulai ulang.
Anda dapat menggunakan
skrip contoh untuk memverifikasi bahwa operasi DDL dihentikan.
|
|
MySQL Error 2013: (HY000): Lost connection to MySQL server during query |
Masalah konektivitas mungkin menyebabkan waktu tunggu habis. | Verifikasi koneksi jaringan dengan database sumber Anda. Untuk panduan contoh, lihat Men-debug konektivitas. |
| Jika ada perubahan bahasa definisi data (DDL) yang dilakukan selama proses dump, Database Migration Service mungkin mengalami masalah kunci metadata. | Selidiki database sumber Anda untuk memeriksa proses yang macet dalam status Waiting for table metadata lock. Jika Anda menemukan proses dengan status tersebut, sebaiknya mulai ulang tugas migrasi. Jangan lakukan
perubahan DDL selama fase dump penuh setelah memulai ulang.
Anda dapat menggunakan
skrip contoh untuk memverifikasi bahwa operasi DDL dihentikan.
|
|
Pesan error: Timeout waiting for no write traffic on source: context deadline exceeded. |
Masalah konektivitas mungkin menyebabkan waktu tunggu habis. | Verifikasi koneksi jaringan dengan database sumber Anda. Untuk panduan contoh, lihat Men-debug konektivitas. |
| Jika ada perubahan bahasa definisi data (DDL) yang dilakukan selama proses dump, Database Migration Service mungkin mengalami masalah kunci metadata. | Selidiki database sumber Anda untuk memeriksa proses yang macet dalam status Waiting for table metadata lock. Jika Anda menemukan proses dengan status tersebut, sebaiknya mulai ulang tugas migrasi. Jangan melakukan perubahan DDL selama fase dump penuh setelah mulai ulang.
Anda dapat menggunakan
skrip contoh untuk memverifikasi bahwa operasi DDL dihentikan.
|
|
Pesan error: Access denied; you need (at least one of) the SUPER privilege(s) for this operation. |
Mungkin ada peristiwa, tampilan, fungsi, atau prosedur dalam database sumber yang menggunakan super user@localhost (seperti root@localhost). Hal ini tidak didukung oleh Cloud SQL. | Lihat informasi selengkapnya tentang penggunaan DEFINER di Cloud SQL. |
Pesan error: Definer user 'x' does not exist. Please create the user on the replica.
|
Pengguna tidak ada di replika. | Lihat informasi selengkapnya tentang penggunaan DEFINER di Cloud SQL. |
Pesan error: ERROR 1045 (28000) at line {line_number}: Access denied for user 'cloudsqlimport'@'localhost. |
Ada DEFINER di database sumber yang tidak ada di replika. |
Lihat informasi selengkapnya tentang penggunaan DEFINER di Cloud SQL. |
Pesan error: Lost connection to MySQL server during query when dumping table. |
Database sumber mungkin tidak dapat dijangkau, atau file dump berisi paket yang terlalu besar. | Coba saran ini. |
Pesan error: Got packet bigger than 'max_allowed_packet' bytes when dumping table. |
Paket tersebut lebih besar dari yang diizinkan oleh setelan. | Gunakan dump manual dengan opsi max_allowed_packet. |
| Migrasi data awal berhasil, tetapi tidak ada data yang direplikasi. | Mungkin ada tanda replikasi yang bertentangan. | Periksa setelan tanda ini. |
| Migrasi data awal berhasil, tetapi replikasi data berhenti berfungsi setelah beberapa saat. | Ada banyak kemungkinan penyebabnya. | Coba saran ini. |
Pesan error: mysqld check failed: data disk is full. |
Disk data instance tujuan penuh. | Perbesar ukuran disk instance tujuan. Anda dapat meningkatkan ukuran disk secara manual atau mengaktifkan peningkatan penyimpanan otomatis. |
| Gagal terhubung ke instance database sumber. | Terjadi masalah konektivitas antara instance database sumber dan instance tujuan. | Ikuti langkah-langkah dalam artikel men-debug konektivitas. |
| Migrasi dari database terkelola (Amazon RDS/Aurora) tidak dimulai. | Memigrasikan dari database sumber terkelola tanpa hak istimewa SUPERUSER memerlukan periode nonaktif singkat di awal migrasi. | Ikuti langkah-langkah dalam artikel ini. |
| Binlog dikonfigurasi dengan salah di database sumber. | Definisi Binlog salah. | Untuk tugas migrasi MySQL berkelanjutan, pastikan Anda mengikuti definisi binlog yang diperlukan. |
| Gagal menemukan file dump. | DMS tidak dapat menemukan file dump yang diberikan. | Hal ini dapat terjadi jika tugas migrasi tidak dapat menemukan file dump di lokasi yang ditentukan.
|
| Tidak dapat melanjutkan replikasi karena posisi binlog hilang. | Posisi binlog hilang dan tugas migrasi tidak dapat dilanjutkan. | Error ini dapat terjadi jika proses replikasi dijeda dalam waktu lama, sehingga posisi binlog hilang. Tugas migrasi tidak boleh dijeda selama jangka waktu yang mendekati periode retensi binlog. Mulai ulang tugas migrasi. |
Saat Anda bermigrasi ke
instance tujuan yang ada, Anda akan menerima pesan error berikut:
The destination instance contains existing data or user defined
entities (for example databases, tables, or functions). You can only
migrate to empty instances. Clear your destination instance and retry
the migration job.
|
Instance Cloud SQL tujuan Anda berisi data tambahan. Anda hanya dapat bermigrasi ke instance yang sudah ada dan kosong. Lihat Batasan umum. | Promosikan instance tujuan Anda untuk menjadikannya instance baca/tulis, hapus data tambahan, dan coba lagi tugas migrasi. Lihat Menghapus data tambahan dari instance tujuan yang ada. |
| Gagal menjalankan tugas migrasi karena versi database sumber dan tujuan tidak kompatibel. | Versi database sumber yang diberikan tidak kompatibel dengan versi database tujuan. | Pastikan versi database tujuan sama atau satu versi utama di atas versi tujuan sumber, lalu buat tugas migrasi baru. |
Pesan Error: Unable to connect to source database server.
|
Database Migration Service tidak dapat membuat koneksi ke server database sumber. | Pastikan instance database sumber dan tujuan dapat berkomunikasi satu sama lain, dan Anda telah menyelesaikan semua prasyarat yang diperlukan yang muncul saat Anda menentukan setelan untuk tugas migrasi. |
Pesan Error: Timeout waiting for no write traffic on source.
|
Memigrasikan dari database sumber terkelola tanpa hak istimewa SUPERUSER akan menyebabkan periode nonaktif singkat selama awal migrasi. |
Ikuti langkah-langkah di Bermigrasi dari RDS MySQL tanpa hak istimewa SUPERUSER. |
Pesan Error: ERROR 1146 (42S02) at line {line_number}: Table '{table_name}' doesn't exist.
|
Mungkin ada inkonsistensi antara nilai flag lower_case_table_names untuk database sumber dan nilai flag untuk instance Cloud SQL tujuan. |
Tetapkan nilai flag untuk instance Cloud SQL agar sesuai dengan nilai flag untuk database sumber. |
Pesan Error: ERROR 1109 (42S02) at line {line_number}: Unknown table '{table}' in {database}.
|
Beberapa objek di database sumber, seperti tampilan, fungsi, prosedur tersimpan, atau pemicu, mereferensikan tabel yang tidak ada lagi di database. | Periksa apakah objek ini ada. Jika ya, hapus objek dari database sumber atau tambahkan tabel yang dirujuk objek ke database sumber. |
Pesan Error: ERROR 1045: Access denied for user '{user_name}'@'{replica_IP}' (using password: YES)". Check if MySQL replication user and password are correct. Not attempting further retries. |
Anda memberikan sandi yang salah untuk instance sumber. Atau, instance sumber memaksakan koneksi SSL; namun, tugas migrasi tidak dikonfigurasi untuk menggunakan sertifikasi SSL. | Konfirmasi apakah setelan SSL, sandi, dan nama pengguna sudah benar untuk instance sumber dengan menggunakan klien Jika instance sumber adalah Cloud SQL, lihat Mewajibkan SSL/TLS untuk memverifikasi apakah SSL/TLS diperlukan untuk koneksi TCP. |
| Jeda replikasi selalu tinggi. | Beban tulis terlalu tinggi untuk ditangani replika. Kelambatan replikasi terjadi saat thread Cloud SQL untuk MySQL pada replika tidak dapat mengikuti thread I/O. Beberapa jenis kueri atau workload dapat menyebabkan jeda replikasi tinggi yang bersifat sementara atau permanen untuk skema tertentu. Beberapa penyebab umum kelambatan replikasi adalah:
|
Beberapa kemungkinan solusinya mencakup:
|
Pesan Error: 'Character set '#255' is not a compiled character set and is not specified in the '/usr/share/mysql/charsets/Index.xml' file' on query. |
Database sumber mungkin menggunakan himpunan karakter atau pemeriksaan yang tidak didukung oleh replika Cloud SQL yang dipilih. Salah satu contohnya adalah AWS Aurora versi 2.x, yang kompatibel dengan MySQL 5.7. Namun, versi ini mendukung kolasi utf8mb4_0900_as_ci, yang tidak didukung di Cloud SQL untuk MySQL 5.7. |
|
Error 1108: ukuran baris terlalu besar
Tabel dengan kolom yang menyimpan string panjang variabel dapat memiliki baris yang melebihi ukuran baris maksimum InnoDB default.Hal-hal yang sebaiknya dicoba
Menyesuaikan skema tabel sumber
Masalah ini dapat terjadi kembali setiap kali Anda menjalankan pernyataan INSERT ke dalam tabel yang melebihi batas baris ukuran maksimum. Untuk menghindari masalah di masa mendatang, sebaiknya sesuaikan tabel sebelum mencoba kembali migrasi:
- Ubah
ROW_FORMATtabel Anda menjadiDYNAMICatauCOMPRESSEDdengan menjalankan kueri berikut:ALTER TABLE TABLE_NAME ROW_FORMAT=FORMAT_NAME;
- TABLE_NAME adalah nama tabel yang barisnya melebihi batas ukuran baris maksimum
- FORMAT_NAME adalah
DYNAMICatauCOMPRESSED
ALTER TABLE mytable ROW_FORMAT=DYNAMIC;
- Mengonversi data baris menjadi BLOB atau TEXT. Salah satu cara untuk mencapai operasi ini
adalah dengan
fungsi
CONVERT().
Menonaktifkan mode ketat InnoDB
Jika Anda tidak dapat menyesuaikan skema tabel sumber, Anda dapat menonaktifkan validasi InnoDB untuk sementara guna menyelesaikan tugas migrasi. Perlu diingat bahwa masalah ini dapat muncul kembali selama upaya penulisan database di masa mendatang, jadi sebaiknya sesuaikan skema tabel Anda jika memungkinkan.
Untuk menonaktifkan validasi InnoDB sementara guna menyelesaikan tugas migrasi, ikuti langkah-langkah berikut:
| Jika... | Lalu... |
|---|---|
| Jika Anda bermigrasi ke instance tujuan baru |
|
| Jika Anda bermigrasi ke instance tujuan yang sudah ada |
|
Hapus data tambahan dari instance tujuan yang ada
Saat Anda bermigrasi ke
instance tujuan yang ada, Anda akan menerima pesan error berikut:
The destination instance contains existing data or user defined
entities (for example databases, tables, or functions). You can only
migrate to empty instances. Clear your destination instance and retry
the migration job.
Masalah ini dapat terjadi jika instance tujuan Anda berisi data tambahan. Anda hanya dapat bermigrasi ke instance yang ada dan kosong. Lihat Batasan umum.
Hal-hal yang sebaiknya dicoba
Hapus data tambahan dari instance tujuan dan mulai kembali tugas migrasi dengan melakukan langkah-langkah berikut:
- Hentikan tugas migrasi.
- Pada tahap ini, instance Cloud SQL tujuan Anda berada dalam mode
read-only. Promosikan instance tujuan untuk mendapatkan akses tulis. - Hubungkan ke instance Cloud SQL tujuan Anda.
- Hapus data tambahan dari database instance tujuan Anda. Tujuan
Anda hanya dapat berisi data konfigurasi sistem. Database tujuan tidak boleh berisi data pengguna (seperti tabel). Ada berbagai pernyataan SQL yang dapat Anda jalankan di database untuk menemukan data non-sistem, misalnya:
SELECT schema_name FROM information_schema.SCHEMATA WHERE schema_name NOT IN ('information_schema', 'sys', 'performance_schema', 'mysql');
- Mulai tugas migrasi.
Penyimpangan konfigurasi Terraform
Saat Anda melakukan migrasi ke database tujuan yang ada, Database Migration Service akan mengubah setelan tertentu database tujuan Anda untuk menjalankan tugas migrasi. Untuk database yang disediakan dengan Terraform, interaksi ini dapat menyebabkan pergeseran konfigurasi, yaitu konfigurasi database tujuan yang sebenarnya berbeda dengan konfigurasi yang ditetapkan dalam file Terraform Anda.Hal-hal yang sebaiknya dicoba
Jangan mencoba menerapkan ulang konfigurasi Terraform saat tugas migrasi sedang berjalan. Anda dapat menyesuaikan konfigurasi yang diperlukan dengan aman setelah database tujuan dipromosikan. Database Migration Service melakukan modifikasi berikut pada instance Cloud SQL tujuan Anda:- Konfigurasi pencadangan ditetapkan ke nilai default.
- Pemulihan point-in-time direset ke nilai default.
ERROR 1109 (42S02): Unknown table in <schema name here>
Tugas migrasi gagal dengan pesan berikut:
ERROR 1109 (42S02): Unknown table in <schema name here>
, misalnya: ERROR 1109 (42S02) at line X: Unknown table 'GLOBAL_STATUS' in information_schema.
Masalahnya mungkin adalah
Database Migration Service tidak memigrasikan skema sistem mysql,
performance_schema, information_schema,
ndbinfo, atau sys (lihat Batasan yang diketahui).
Tugas migrasi Anda mungkin gagal jika database sumber berisi objek yang mereferensikan tabel dari salah satu skema ini.
Hal-hal yang sebaiknya dicoba
Periksa database sumber Anda untuk menemukan objek yang mereferensikan tabel dari skema sistem. Di database sumber, jalankan kueri berikut:# Query to check routines or functions definitions. SELECT ROUTINE_SCHEMA, ROUTINE_NAME FROM information_schema.routines WHERE ROUTINE_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys') AND ROUTINE_DEFINITION like '%OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE%' # Query to check view definitions. SELECT TABLE_SCHEMA, TABLE_NAME FROM information_schema.views WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys') AND view_definition like '%OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE%' # Query to check trigger definitions. SELECT TRIGGER_SCHEMA, TRIGGER_NAME FROM information_schema.TRIGGERS WHERE TRIGGER_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys') AND event_object_table = 'OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE' # Query to check constraint definitions. SELECT TABLE_SCHEMA, TABLE_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys') AND REFERENCED_TABLE_NAME = 'OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE'
Tabel 'COLUMN_STATISTICS' tidak dikenal dalam information_schema
Saat menjalankan utilitas mysqldump versi 8 atau yang lebih baru untuk mengekspor database MySQL versi sebelum 8, Anda akan mengalami error ini: Unknown table 'COLUMN_STATISTICS' in information_schema (1109).
Masalahnya mungkin adalah
Database MySQL dalam versi yang lebih lama dari 8 tidak memiliki tabel COLUMN_STATISTICS. Utilitas mysqldump di versi 8 dan yang lebih baru mencoba mengekspor tabel ini secara default. Ekspor gagal karena kolom tidak ada.
Hal-hal yang sebaiknya dicoba
Tambahkan flag --column-statistics=0 ke perintah mysqldump untuk menghapus tabel COLUMN_STATISTICS dari ekspor. Untuk mengetahui informasi selengkapnya, lihat Mengekspor database MySQL menggunakan mysqldump.
Kunci yang ditentukan terlalu panjang; panjang maksimal kunci adalah 767 byte
Anda melihat error Specified key was too long; max key length is 767 bytes.
Masalahnya mungkin adalah
Database sumber mungkin telah menyetel variabel innodb_large_prefix. Hal ini memungkinkan awalan kunci indeks lebih panjang dari 767 byte. Nilai defaultnya adalah OFF untuk MySQL 5.6.
Hal-hal yang sebaiknya dicoba
Setel flag innodb_large_prefix ke ON saat membuat database tujuan, atau update database tujuan yang ada dengan flag tersebut.
Definisi tabel telah berubah
Anda melihat error Table definition has changed.
Masalahnya mungkin adalah
Ada perubahan DDL selama proses dump.
Hal-hal yang sebaiknya dicoba
Jangan ubah tabel atau lakukan perubahan DDL lainnya selama proses dump.Anda dapat menggunakan skrip untuk memverifikasi bahwa operasi DDL dihentikan.
Akses ditolak; Anda memerlukan (setidaknya salah satu) hak istimewa SUPER untuk operasi ini
Anda melihat error Access denied; you need (at least one of) the SUPER privilege(s) for this operation.
Masalahnya mungkin adalah
Mungkin ada peristiwa, tampilan, fungsi, atau prosedur dalam database sumber yang menggunakan super user@localhost (seperti root@localhost). Hal ini tidak didukung oleh Cloud SQL.
Hal-hal yang sebaiknya dicoba
Lihat dokumen ini
tentang memigrasikan database dengan klausa DEFINER.
Pesan error: Definer user 'x' does not exist. Please create the user on the replica.
Anda melihat error Definer user 'x' does not exist. Please create the user on the replica.
Masalahnya mungkin adalah
Penyebab utamanya adalah pengguna dalam database sumber dengan klausa
DEFINER tidak ada di database replika.
Hal-hal yang sebaiknya dicoba
Lihat dokumen ini tentang memigrasikan database dengan klausa DEFINER. Anda mungkin perlu
membuat pengguna di database replika.
Pesan error: ERROR 1045 (28000) at line {line_number}: Access denied for user 'cloudsqlimport'@'localhost
Anda melihat error ERROR 1045 (28000) at line {line_number}: Access denied for user 'cloudsqlimport'@'localhost.
Masalahnya mungkin adalah
Penyebab utamanya adalah pengguna di database sumber dengan klausa DEFINER tidak ada di database replika dan pengguna tersebut direferensi silang dalam definisi objek di database sumber.
Hal-hal yang sebaiknya dicoba
Lihat dokumen ini
tentang memigrasikan database dengan klausa DEFINER. Anda mungkin perlu
membuat satu atau beberapa pengguna di database replika.
Koneksi ke server MySQL terputus selama kueri saat membuang tabel
Anda melihat error Lost connection to MySQL server during query when dumping table.
Masalahnya mungkin adalah
- Instance database sumber mungkin tidak dapat dijangkau dari instance tujuan.
- Database sumber mungkin memiliki tabel dengan blob besar atau string panjang yang memerlukan penetapan
max_allowed_packetke angka yang lebih besar di database sumber.
Hal-hal yang sebaiknya dicoba
- Pastikan instance database sumber sudah aktif dan dapat dijangkau.
- Konfigurasi flag
max-allowed-packetdalam tugas migrasi, lalu mulai ulang tugas migrasi. Atau, buat dump manual dengan opsimax_allowed_packetuntuk melakukan dump data dan bermigrasi dengan file dump. - Meningkatkan
max_allowed_packetkemungkinan besar akan memerlukan penyesuaian setelannet_read_timeoutdannet_write_timeoutdi database sumber (umumnya, setelan ini harus ditingkatkan hingga error koneksi berhenti).
Mendapatkan paket yang lebih besar dari byte 'max_allowed_packet' saat membuang tabel
Anda melihat error Got packet bigger than 'max_allowed_packet' bytes when dumping table.
Masalahnya mungkin adalah
Paket tersebut lebih besar dari yang diizinkan oleh setelan.
Hal-hal yang sebaiknya dicoba
Buat tugas migrasi menggunakan dump manual dengan opsi max_allowed_packet untuk melakukan dump data dan bermigrasi dengan file dump.
Tidak ada data yang direplikasi
Migrasi data awal berhasil, tetapi tidak ada data yang direplikasi.
Masalahnya mungkin adalah
Salah satu kemungkinan penyebabnya adalah database sumber Anda memiliki flag replikasi yang menyebabkan beberapa atau semua perubahan database tidak direplikasi.
Hal-hal yang sebaiknya dicoba
Pastikan flag replikasi seperti binlog-do-db, binlog-ignore-db, replicate-do-db, atau replicate-ignore-db tidak ditetapkan dengan cara yang bertentangan.
Jalankan perintah show master status pada database sumber untuk melihat setelan saat ini.
Migrasi data awal berhasil, tetapi replikasi data berhenti berfungsi setelah beberapa saat
Migrasi data awal berhasil, tetapi replikasi data berhenti berfungsi setelah beberapa saat.
Masalahnya mungkin adalah
Ada banyak penyebab utama masalah ini.
Hal-hal yang sebaiknya dicoba
- Periksa metrik replikasi untuk instance tujuan Anda di Cloud Monitoring.
- Error dari thread IO MySQL atau thread SQL dapat ditemukan di Cloud Logging dalam file log mysql.err.
- Error ini juga dapat ditemukan saat menghubungkan ke instance tujuan. Jalankan perintah
SHOW REPLICA STATUS, dan periksa kolom berikut dalam output:- Replica_IO_Running
- Replica_SQL_Running
- Last_IO_Error
- Last_SQL_Error
Catatan:
SHOW REPLICA STATUSadalah alias yang diperkenalkan di MySQL 8.0.22. Untuk versi sebelumnya (MySQL 5.7, MySQL 8.0), gunakan alias lama perintah status. Untuk mengetahui informasi selengkapnya, lihat Pernyataan status dalam dokumentasi MySQL.Jika Anda mendapatkan error
fatal error 1236 from master when reading data from binary log: 'Could not find first log file name in binary log index file' in Last_IO_Error, hal ini mungkin disebabkan oleh setelan retensi binlog yang tidak memadai pada instance sumber.Jika Anda mendapatkan error
error connecting to master 'USER_NAME@SOURCE_HOST:SOURCE_PORT' - retry-time: RETRY_TIME retries: RETRIES, hal ini mungkin disebabkan oleh instance tujuan yang gagal terhubung kembali ke sumber karena masalah konektivitas atau autentikasi.
Pemeriksaan mysqld gagal: disk data penuh
Anda melihat error mysqld check failed: data disk is full.
Masalahnya mungkin adalah
Disk data instance tujuan mungkin penuh.
Hal-hal yang sebaiknya dicoba
Tingkatkan ukuran disk instance tujuan.
Gagal terhubung ke database sumber
Gagal terhubung ke database sumber.
Masalahnya mungkin adalah
Terjadi masalah konektivitas antara instance database sumber dan instance tujuan.
Hal-hal yang sebaiknya dicoba
Ikuti langkah-langkah dalam artikel men-debug konektivitas.
Migrasi dari database terkelola (Amazon RDS/Aurora) tidak dimulai
Tugas migrasi gagal dimulai.
Masalahnya mungkin adalah
Migrasi dari database sumber terkelola tanpa hak istimewa SUPERUSER
memerlukan periode nonaktif singkat di awal migrasi.
Hal-hal yang sebaiknya dicoba
- Untuk Amazon RDS, ikuti langkah-langkah dalam artikel ini.
- Untuk Amazon Aurora, ikuti langkah-langkah dalam artikel ini.
Binlog tidak dikonfigurasi dengan benar di database sumber
Anda melihat error yang menunjukkan masalah pada log biner.
Masalahnya mungkin adalah
Hal ini dapat terjadi untuk tugas migrasi MySQL berkelanjutan jika konfigurasi binlog salah di database sumber.
Hal-hal yang sebaiknya dicoba
Pastikan Anda mengikuti langkah-langkah di sini.
Gagal membaca file dump yang diberikan
Anda melihat error yang menunjukkan masalah pada file dump.
Masalahnya mungkin adalah
DMS tidak dapat menemukan file dump yang diberikan.
Hal-hal yang sebaiknya dicoba
- Periksa jalur dump untuk memastikan file yang tepat ada di sana, atau ubah jalurnya
- Jika Anda mengubah jalur, gunakan permintaan
PATCHuntuk memastikan tugas menggunakannya. - Mulai ulang tugas migrasi.
Tidak dapat melanjutkan replikasi karena posisi binlog hilang
Posisi binlog hilang.
Masalahnya mungkin adalah
Error ini dapat terjadi jika proses replikasi dijeda dalam waktu lama, sehingga posisi binlog hilang. Tugas migrasi tidak boleh dijeda selama jangka waktu yang mendekati periode retensi data binlog.
Hal-hal yang sebaiknya dicoba
Mulai ulang tugas migrasi.
Gagal menjalankan tugas migrasi karena versi database sumber dan tujuan tidak kompatibel
Versi database sumber dan tujuan bukan kombinasi yang didukung.
Masalahnya mungkin adalah
Versi database sumber yang diberikan tidak kompatibel dengan versi database tujuan.
Hal-hal yang sebaiknya dicoba
Pastikan versi database tujuan sama atau satu versi utama di atas versi tujuan sumber, lalu buat tugas migrasi baru.
Tidak dapat terhubung ke server database sumber
Anda melihat error Unable to connect to source database server.
Masalahnya mungkin adalah
Database Migration Service tidak dapat membuat koneksi ke server database sumber.
Hal-hal yang sebaiknya dicoba
Pastikan instance database sumber dan tujuan dapat saling berkomunikasi. Kemudian, pastikan Anda telah menyelesaikan semua prasyarat yang diperlukan yang muncul saat Anda menentukan setelan untuk tugas migrasi.
Penggunaan disk instance tujuan Cloud SQL turun menjadi nol
Penggunaan disk tiba-tiba turun menjadi nol selama migrasi.
Masalahnya mungkin adalah
Mungkin terjadi kegagalan saat mengimpor data awal. Jika hal ini terjadi, proses migrasi akan mencoba melakukan pemuatan data lain. Proses ini akan menghapus data yang ada di instance tujuan terlebih dahulu (Itulah sebabnya Anda melihat penggunaan disk turun menjadi nol.), lalu mencoba memuat ulang data.
Hal-hal yang sebaiknya dicoba
Buka Logs Explorer, lalu pilih instance tujuan Anda dari daftar resource.
Cari pesan log yang serupa:
DUMP_STAGE(RETRY): Attempt .../...: import failed: error..."; Clearing database and trying again."
Temukan pesan setelah teks import failed: dan coba selesaikan masalah yang mendasarinya.