ApsaraDB RDS:Periksa detail laporan pemeriksaan untuk peningkatan versi mesin utama

check_ins_major_version

Error message: Current engine version does not support operations.

What it checks: Apakah versi instans saat ini dan versi target membentuk jalur peningkatan versi mesin utama yang didukung.

Cause: Jalur peningkatan bukan salah satu dari MySQL 5.6 ke 5.7, MySQL 5.7 ke 8.0, atau MySQL 8.0 ke 8.4, atau bentuk instans saat ini tidak mendukung jalur peningkatan tersebut.

Fix: Lihat Prasyarat untuk peningkatan versi mesin utama untuk memastikan versi sumber, versi target, dan bentuk instans. Jika konsol tidak menyediakan titik masuk peningkatan yang sesuai, submit a ticket.

check_ins

Error message: Specified instance does not exist or not support.

What it checks: Apakah instans tersebut ada.

Cause: Instans telah dihapus atau tidak ada.

Fix: Pastikan instans target ada sebelum menjalankan Pemeriksaan Awal.

check_ins_status

Error message: Current DB instance state does not support this operation.

Yang diperiksa: Apakah instance berada dalam status Running.

Cause: Operasi lain sedang berlangsung—misalnya, restart instans atau pembuatan koneksi jaringan—sehingga instans tidak dalam status Running.

Fix: Tunggu hingga tugas saat ini selesai. Setelah instans kembali ke status Running, jalankan kembali Pemeriksaan Awal.

check_master_ins

Error message: Current DB instance type does not support this operation.

What it checks: Apakah instans merupakan primary instance.

Cause: Instans tersebut adalah disaster recovery instance atau read-only instance, bukan primary instance.

Fix: Jalankan Pemeriksaan Awal pada primary instance.

check_ins_locked_state

Error message: Current DB instance lock mode does not support this operation.

What it checks: Apakah instans terkunci.

Cause: Instans berada dalam status Locking.

Fix: Buka kunci instans tersebut. Setelah status instans berubah menjadi Running, jalankan kembali Pemeriksaan Awal. Untuk informasi lebih lanjut, lihat Apa yang harus saya lakukan jika instans saya berada dalam status Locking?

check_maxscale_kernel

Error message: The Maxscale version used by the instance is too low, please upgrade the Maxscale version first.

What it checks: Apakah versi minor database proxy MaxScale kompatibel dengan versi utama target, berdasarkan jalur peningkatan.

Cause: Versi proxy tidak memenuhi persyaratan untuk versi minor target. Untuk peningkatan dari 5.7 ke 8.0, versi proxy harus 1.13.41 atau lebih baru. Untuk peningkatan dari 8.0 ke 8.4, versi proxy harus 2.25.11 atau lebih baru.

Fix: Upgrade proxy ke versi minor yang didukung, lalu jalankan kembali Pemeriksaan Awal. Peningkatan dari 8.0 ke 8.4 memerlukan versi proxy resolvable 2.25.11 atau lebih baru.

check_ins_tde_state

Error message: Specified TDEStatus is not configured on the This custins.

What it checks: Apakah transparent data encryption (TDE) diaktifkan.

Cause: TDE diaktifkan pada instans.

Fix: Instans dengan TDE yang diaktifkan tidak dapat ditingkatkan langsung dari konsol. Untuk prosedur peningkatan alternatif, lihat Upgrade the database version.

check_target_ins_level

Error message: Current DB instance level does not support this operation. (Error code: InvalidInstanceLevel.Malformed)

What it checks: Apakah tipe instans saat ini tersedia untuk dibeli.

Cause: Instans menggunakan tipe instans yang sudah dihentikan. Instans tersebut tidak dapat ditingkatkan secara langsung.

Fix: Ubah instans ke tipe instans yang saat ini tersedia, lalu coba lagi peningkatannya.

check_target_read_level

Error message: The read-only instance level is not supported in the target instance.

What it checks: Apakah tipe instans read-only instance tersedia untuk dibeli.

Cause: Read-only instance menggunakan tipe instans yang sudah dihentikan. Pemeriksaan ini berlaku untuk instans yang menggunakan SSD lokal.

Fix: Ubah read-only instance ke tipe instans yang tersedia, lalu jalankan kembali Pemeriksaan Awal.

• Untuk mengubah tipe instans, lihat Change the instance configuration.

• Untuk menemukan tipe instans yang tersedia, lihat Instance types for standard read-only instances atau Instance types for Yitian read-only instances.

check_upgrade_check_task

Error message: The task already exists.

What it checks: Apakah tugas Pemeriksaan Awal sedang berjalan untuk instans ini.

Cause: Pemeriksaan Awal peningkatan versi mesin utama sedang berlangsung.

Fix: Tunggu hingga Pemeriksaan Awal selesai. Setelah status instans berubah menjadi Running, jalankan kembali Pemeriksaan Awal.

check_upgrade_task

Error message: The task already exists.

What it checks: Apakah tugas peningkatan versi mesin utama sedang berjalan untuk instans ini.

Cause: Peningkatan versi mesin utama sedang berlangsung.

Fix: Tunggu hingga peningkatan selesai. Setelah status instans berubah menjadi Running, jalankan kembali Pemeriksaan Awal.

check_storage_type

Error message: Cloud ssd does not support this operation, please upgrade to essd.

What it checks: Apakah instans menggunakan SSD standar.

Cause: Instans menggunakan SSD standar.

Fix: Upgrade tipe penyimpanan ke ESSD (enterprise SSD), lalu coba lagi peningkatannya.

check_source_category

Error message: Specified source category is invalid.

What it checks: Apakah edisi instans berada dalam rentang yang didukung untuk peningkatan versi mesin utama.

Cause: Instans tidak berada pada High-availability Edition, Basic Edition, atau Cluster Edition, atau jalur peningkatan tidak mendukung tipe instans saat ini.

Fix: Pemeriksaan Awal peningkatan hanya didukung untuk instans pada High-availability Edition atau Basic Edition versi 5.7.

check_ins_biz_type

Error message: Specified biz type is not valid.

What it checks: Apakah instans merupakan instans public cloud.

Penyebab: Instans tersebut bukan instans cloud publik.

Fix: Pemeriksaan Awal peningkatan versi mesin utama hanya didukung untuk instans public cloud.

check_ins_tables_number

Error message: Upgrade not allowed due to excessive number of tables: more than 1000,000.

atau

Upgrade not allowed due to excessive number of tables: more than 1000,000.

What it checks: Apakah jumlah tabel pada instans melebihi batas yang diizinkan oleh jalur peningkatan saat ini.

Cause:

• Instans SSD lokal memiliki lebih dari 1.000.000 tabel dan tidak dapat ditingkatkan.

• Instans cloud disk memiliki lebih dari 1.000.000 tabel dan tidak dapat ditingkatkan.

Fix: Hapus tabel yang tidak diperlukan, lalu jalankan kembali Pemeriksaan Awal.

check_ins_db_engine

Error message: There are engines present such as MyISAM, Memory, TokuDB, Sphinx, or RocksDB.

What it checks: Apakah ada tabel yang menggunakan storage engine selain InnoDB.

Cause: Instans berisi tabel yang menggunakan MyISAM, Memory, TokuDB, Sphinx, atau RocksDB. Storage engine ini tidak didukung untuk peningkatan versi mesin utama.

Fix: Konversi semua tabel ke InnoDB sebelum melakukan peningkatan. Jika database sudah menggunakan InnoDB tetapi tabel tertentu masih menggunakan engine lain, jalankan perintah berikut untuk setiap tabel yang terpengaruh:

ALTER TABLE <table_name> engine=InnoDB;

check_ins_fts

Error message: The current instance has an FTS index, and the minor version is less than 20221130.

What it checks: Apakah instans memiliki full-text indexes, dan apakah versi minor instans sumber lebih awal dari 20221130.

Cause: Pada versi lama RDS for MySQL 5.6, full-text indexes dibuat pada system tablespace. Selama peningkatan, indeks ini dapat merusak ruang tabel. Masalah ini telah diperbaiki pada versi minor RDS for MySQL 5.6 20221130, di mana full-text indexes dibuat pada ruang tabel terpisah.

Fix: Sebelum meningkatkan dari RDS for MySQL 5.6 ke 5.7, hapus semua full-text indexes dari system tablespace.

1. Pastikan instans menjalankan versi minor RDS for MySQL 5.6 20221130 atau lebih baru. Jika belum, upgrade ke versi minor RDS for MySQL 5.6 terbaru terlebih dahulu.

2. Hapus full-text index pada system tablespace. Gunakan nama tabel yang ditampilkan dalam prompt error.

   ALTER TABLE $table_name DROP INDEX $fts_name;

3. Buat ulang full-text index.

   ALTER TABLE $table_name ADD FULLTEXT INDEX $fts_name;

4. Verifikasi bahwa tidak ada full-text indexes yang tersisa pada system tablespace. Kueri berikut akan mengembalikan indeks semacam itu. Hasil kosong berarti Pemeriksaan Awal tidak akan gagal karena masalah ini.

   SELECT NAME FROM information_schema.INNODB_SYS_TABLES WHERE TABLE_ID IN ( SELECT CONV(SUBSTRING_INDEX(SUBSTRING_INDEX(NAME, '_', -4),'_', 1),16,10) FROM INNODB_SYS_TABLES WHERE NAME LIKE '%fts_00000000%' AND SPACE = 0);

check_read_ins_number

Error message: The number of read-only instances cannot be greater than 8.

What it checks: Jumlah read-only instances untuk instans yang menggunakan SSD lokal.

Cause: Instans memiliki lebih dari 8 read-only instances. Batasan ini hanya berlaku untuk instans yang menggunakan SSD lokal.

Fix: Lepaskan read-only instances tambahan. Setelah peningkatan selesai, buat ulang instans tersebut.

check_slave_state

Error message: The slave status is unhealthy or has delays.

What it checks: Kesehatan dan latensi replikasi pada node secondary.

Cause: Node secondary berada dalam status abnormal atau mengalami replication delay.

Fix: Di konsol, periksa metrik pemantauan Node Replication Thread Status (seconds) dan Node Replication Latency (seconds) di bawah Monitoring and alerts. Tunggu hingga node secondary kembali normal, lalu jalankan kembali Pemeriksaan Awal.

check_account

Error message: The instance has an aliyun_root account.

What it checks: Apakah akun aliyun_root ada pada instans.

Cause: Pengguna membuat akun aliyun_root secara manual di RDS for MySQL 5.6. Akun aliyun_root merupakan akun sistem default di RDS for MySQL 5.7 dan versi selanjutnya. Jika akun tersebut sudah ada di versi 5.6, peningkatan ke 5.7 akan gagal karena error duplikat nama.

Fix: Hapus atau ganti nama akun aliyun_root yang dibuat secara manual sebelum menjalankan Pemeriksaan Awal. Untuk informasi tentang akun sistem, lihat System accounts.

check_sys_schema

Error message: The instance already has a sys database.

What it checks: Apakah database sys ada pada instans.

Cause: Database sys dibuat secara default di RDS for MySQL 5.7. Jika database tersebut sudah ada di instans 5.6, peningkatan ke 5.7 akan gagal.

Fix: Ganti nama database sys yang sudah ada. Karena MySQL tidak mendukung RENAME DATABASE, jalankan ALTER TABLE ... RENAME untuk setiap tabel secara individual.

Untuk memastikan apakah database sys ada, jalankan:

SELECT * FROM information_schema.SCHEMATA WHERE SCHEMA_NAME='sys';

check_table_discard

Error message: There are tables that have been discarded.

What it checks: Apakah instans memiliki tabel dengan tablespace yang telah dibuang (tabel yang menjalankan ALTER TABLE ... DISCARD TABLESPACE) dan belum dipulihkan.

Cause: Instans berisi tabel yang dibuang dengan ukuran file tablespace dan ukuran blok keduanya bernilai 0.

Fix: Setelah memastikan keamanan data, pulihkan atau hapus tabel yang terpengaruh, lalu jalankan kembali Pemeriksaan Awal. Untuk versi sumber 5.7, jalankan:

SELECT space,name FROM INFORMATION_SCHEMA.INNODB_SYS_TABLESPACES WHERE FS_BLOCK_SIZE=0 AND FILE_SIZE=0 AND name NOT LIKE '%#sql%';

Untuk versi sumber 8.0, jalankan:

SELECT SPACE, NAME FROM INFORMATION_SCHEMA.INNODB_TABLESPACES WHERE FS_BLOCK_SIZE=0 AND FILE_SIZE=0 AND NAME NOT LIKE '%#sql%';

check_table_foreign_key

Error message: The partitioned table contains foreign keys.

What it checks: Apakah ada tabel partisi yang memiliki foreign keys, atau apakah ada tabel partisi yang dirujuk oleh foreign keys dari tabel lain.

Cause: Tabel partisi berisi foreign key, atau foreign key dari tabel lain merujuk ke tabel partisi.

Fix: Selesaikan konflik antara foreign keys dan tabel partisi.

1. Kueri tabel partisi yang berisi foreign keys.

   SELECT DISTINCT a.TABLE_SCHEMA, a.TABLE_NAME
   FROM information_schema.TABLE_CONSTRAINTS a, information_schema.PARTITIONS b
   WHERE a.CONSTRAINT_TYPE='FOREIGN KEY'
   AND a.TABLE_SCHEMA = b.TABLE_SCHEMA
   AND a.TABLE_NAME = b.TABLE_NAME
   AND (b.PARTITION_NAME IS NOT NULL OR b.SUBPARTITION_NAME IS NOT NULL);

2. Kueri tabel partisi yang dirujuk oleh foreign keys dari tabel lain.

   SELECT DISTINCT a.TABLE_SCHEMA, a.TABLE_NAME, a.REFERENCED_TABLE_SCHEMA, a.REFERENCED_TABLE_NAME
   FROM information_schema.KEY_COLUMN_USAGE a, information_schema.PARTITIONS b
   WHERE a.REFERENCED_TABLE_SCHEMA = b.TABLE_SCHEMA
   AND a.REFERENCED_TABLE_NAME = b.TABLE_NAME
   AND (b.PARTITION_NAME IS NOT NULL OR b.SUBPARTITION_NAME IS NOT NULL);

check_column_length

Error message: The number of views with column length greater than or equal to 64 is greater than 0.

What it checks: Apakah ada view yang memiliki nama kolom sepanjang 64 karakter atau lebih.

Cause: MySQL tidak mendukung nama kolom view dengan panjang 64 karakter atau lebih.

Fix: Kueri view yang terpengaruh, lalu hapus atau perpendek nama kolomnya.

SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME IN (SELECT TABLE_NAME FROM INFORMATION_SCHEMA.VIEWS) AND CHAR_LENGTH(COLUMN_NAME) >= 64;

check_foreign_key_constraint

Error message: The number of tables with foreign key constraint length greater than 64 is greater than 0.

What it checks: Apakah ada tabel yang memiliki nama kendala kunci asing lebih dari 64 karakter.

Cause: Nama kendala kunci asing yang lebih dari 64 karakter tidak didukung.

Fix: Perpendek nama kendala kunci asing yang terpengaruh, lalu jalankan kembali Pemeriksaan Awal. Untuk versi sumber 5.7, kueri INFORMATION_SCHEMA.INNODB_SYS_FOREIGN. Untuk versi sumber 8.0, kueri INFORMATION_SCHEMA.INNODB_FOREIGN. Contoh berikut untuk versi 5.7:

SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME IN (SELECT LEFT(SUBSTR(ID,INSTR(ID,'/')+1),INSTR(SUBSTR(ID,INSTR(ID,'/')+1),'_ibfk_')-1) FROM INFORMATION_SCHEMA.INNODB_SYS_FOREIGN WHERE CHAR_LENGTH(SUBSTR(ID,INSTR(ID,'/')+1))>64);

check_dictionary_table

Error message: In the MySQL 5.7 system database, there cannot be tables with the same name as those used by the MySQL 8.0 data dictionary.

What it checks: Apakah ada tabel di database sistem MySQL 5.7 yang memiliki nama yang sama dengan tabel yang digunakan oleh data dictionary MySQL 8.0.

Cause: Satu atau beberapa tabel di database sistem MySQL 5.7 memiliki nama yang bertabrakan dengan data dictionary MySQL 8.0.

Fix: Kueri nama tabel yang bertabrakan, lalu hapus atau ganti namanya.

SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE LOWER(
TABLE_SCHEMA) = 'mysql' and LOWER(TABLE_NAME) IN
('catalogs', 'character_sets', 'check_constraints', 'collations',
'column_statistics', 'column_type_elements', 'columns',
'dd_properties', 'events', 'foreign_key_column_usage', 'foreign_keys',
'index_column_usage', 'index_partitions', 'index_stats',
'indexes', 'parameter_type_elements', 'parameters', 'resource_groups', 'routines',
'schemata', 'st_spatial_reference_systems',
'table_partition_values', 'table_partitions', 'table_stats', 'tables',
'tablespace_files', 'tablespaces', 'triggers', 'view_routine_usage',
'view_table_usage');

check_ins_health

Error message: The master node of the instance is not available.

What it checks: Konektivitas dan ketersediaan instans.

Cause: Sumber daya seperti CPU atau disk sepenuhnya dimanfaatkan, sehingga node master tidak tersedia.

Fix: Di konsol, gunakan fitur Monitoring and alerts untuk memeriksa apakah semua metrik pemantauan berada dalam rentang normal.

check_table_index_type

Error message: For upgrades from 5.7 to 8.0: MySQL 8.0 does not support creating BTREE indexes on spatial fields.

For upgrades from 8.0 to 8.4: The current instance contains SPATIAL indexes. Drop these indexes before the upgrade and recreate them after the upgrade is complete.

What it checks: Kompatibilitas indeks berdasarkan jalur peningkatan. Untuk peningkatan dari 5.7 ke 8.0, memeriksa adanya indeks BTREE pada field spasial. Untuk peningkatan dari 8.0 ke 8.4, memeriksa apakah instans berisi indeks SPATIAL.

Cause: Untuk peningkatan dari 5.7 ke 8.0, instans memiliki indeks BTREE pada field spasial. Untuk peningkatan dari 8.0 ke 8.4, instans memiliki indeks SPATIAL.

Fix: Hapus indeks yang tidak kompatibel sebelum peningkatan, lalu buat ulang sesuai aturan versi target setelah peningkatan selesai. Untuk peningkatan dari 5.7 ke 8.0, jalankan kueri berikut:

SELECT DISTINCT s.* FROM INFORMATION_SCHEMA.STATISTICS s
INNER JOIN INFORMATION_SCHEMA.COLUMNS c
ON s.TABLE_SCHEMA = c.TABLE_SCHEMA
AND s.TABLE_NAME = c.TABLE_NAME
AND s.COLUMN_NAME = c.COLUMN_NAME
WHERE s.TABLE_SCHEMA NOT IN ('mysql', 'sys')
AND c.DATA_TYPE IN ('GEOMETRY', 'POINT', 'LINESTRING', 'POLYGON', 'MULTIPOINT',
'MULTILINESTRING', 'MULTIPOLYGON', 'GEOMETRYCOLLECTION')
AND s.INDEX_TYPE = 'BTREE';

Untuk peningkatan dari 8.0 ke 8.4, jalankan kueri berikut:

SELECT DISTINCT TABLE_SCHEMA, TABLE_NAME, INDEX_NAME FROM INFORMATION_SCHEMA.STATISTICS WHERE INDEX_TYPE IN ('SPATIAL', 'RTREE') AND TABLE_SCHEMA NOT IN ('mysql', 'sys', 'performance_schema', 'information_schema');

check_read_ins_level

Error message: The specifications of read-only instances are inconsistent.

What it checks: Apakah beberapa read-only instances di bawah instans SSD lokal menggunakan tipe instans yang konsisten.

Cause: Read-only instances di bawah primary instance yang sama menggunakan tipe instans berbeda, sehingga tipe instans target tidak dapat dipetakan secara seragam selama peningkatan.

Fix: Ubah read-only instances standar ke tipe instans yang tersedia dan konsisten, lalu jalankan kembali Pemeriksaan Awal.

check_bak_read_exists

Error message: There is a read-only instance, but there is no standby read-only instance.

What it checks: Apakah terdapat setidaknya satu standby read-only instance ketika instans SSD lokal memiliki read-only instances standar.

Penyebab: Instans hanya memiliki instansi hanya baca standar tanpa instansi hanya baca siaga, sehingga tidak memenuhi persyaratan alih bencana untuk peningkatan.

Fix: Sesuaikan topologi read-only instance dan pastikan terdapat setidaknya satu standby read-only instance. Jika Anda tidak dapat menyelesaikannya di konsol, submit a ticket.

check_bak_read_number

Error message: Verify that the number of spare read-only instances cannot exceed 5.

What it checks: Apakah jumlah standby read-only instances pada instans SSD lokal melebihi 5.

Cause: Jumlah standby read-only instances lebih dari 5.

Fix: Lepaskan atau sesuaikan standby read-only instances tambahan agar jumlahnya tidak melebihi 5, lalu jalankan kembali Pemeriksaan Awal.

check_read_ins_conn_type

Error message: The network types of the read-only instance and the standby read-only instance are inconsistent.

Yang diperiksa: Apakah jenis koneksi jaringan instansi hanya-baca standar dan instansi hanya-baca siaga konsisten.

Cause: Jenis koneksi LVS dan DNS keduanya ada dalam topologi yang sama.

Perbaikan: Ubah instansi hanya baca standar dan instansi hanya baca siaga ke jenis koneksi yang konsisten, lalu jalankan kembali Pemeriksaan Awal.

check_interrupt_task

Error message: The standby read-only has unfinished tasks.

What it checks: Apakah standby read-only instance memiliki tugas versi utama yang belum selesai atau terganggu.

Cause: Standby read-only instance masih memiliki tugas dalam status waiting, running, paused, atau interrupted.

Fix: Tunggu hingga tugas terkait selesai, atau tangani dan akhiri tugas abnormal tersebut, lalu jalankan kembali Pemeriksaan Awal.

check_mgr_disabled_for_84

Error message: MySQL 8.4 no longer supports Group Replication (MGR).

What it checks: Apakah MGR diaktifkan pada instans sumber saat meningkatkan dari 8.0 ke 8.4. Memeriksa apakah anggota ada di performance_schema.replication_group_members, atau apakah group_replication_start_on_boot diatur ke ON.

Cause: Instans memiliki anggota MGR, atau dikonfigurasi untuk secara otomatis memulai Group Replication saat instans dimulai.

Fix: Jalankan STOP GROUP_REPLICATION; untuk menghentikan MGR, hapus parameter terkait Group Replication, dan restart instans. Setelah memastikan MGR tidak lagi diaktifkan, jalankan kembali Pemeriksaan Awal.