Al ejecutar una verificación previa antes de actualizar una instancia de ApsaraDB RDS for MySQL a una nueva versión principal del motor, el sistema comprueba varias condiciones e informa sobre cualquier problema que pueda bloquear el proceso. Esta página explica cada elemento de verificación, qué busca, por qué falla y cómo solucionarlo.
Si encuentra un error que no aparece en esta lista, envíe un ticket.
Elementos de verificación
La siguiente tabla cubre todos los elementos de verificación que devuelve la comprobación previa. Las rutas de actualización compatibles son MySQL 5.6 → MySQL 5.7, MySQL 5.7 → MySQL 8.0 y MySQL 8.0 → MySQL 8.4.
check_ins_major_version
Mensaje de error: Current engine version does not support operations.
Qué verifica: Si la versión actual de la instancia y la versión de destino forman una ruta de actualización de versión principal del motor compatible.
Causa: La ruta de actualización no es de MySQL 5.6 a 5.7, de MySQL 5.7 a 8.0 ni de MySQL 8.0 a 8.4, o bien la forma actual de la instancia no admite dicha ruta.
Solución: Consulte Prerequisites for a major engine version upgrade para confirmar la versión de origen, la versión de destino y la forma de la instancia. Si la consola no proporciona el punto de entrada de actualización correspondiente, envíe un ticket.
check_ins
Mensaje de error: Specified instance does not exist or not support.
Qué verifica: Si la instancia existe.
Causa: La instancia se eliminó o no existe.
Solución: Compruebe que la instancia de destino existe antes de ejecutar la verificación previa.
check_ins_status
Mensaje de error: Current DB instance state does not support this operation.
Qué verifica: Si la instancia se encuentra en estado Running.
Causa: Hay otra operación en curso (por ejemplo, un reinicio de instancia o la creación de una conexión de red), por lo que la instancia no está en estado Running.
Solución: Espere a que finalice la tarea actual. Una vez que la instancia vuelva al estado Running, inicie la verificación previa nuevamente.
check_master_ins
Mensaje de error: Current DB instance type does not support this operation.
Qué verifica: Si la instancia es una instancia primaria.
Causa: La instancia es una instancia de recuperación ante desastres o de solo lectura, no una instancia primaria.
Solución: Ejecute la verificación previa en una instancia primaria.
check_ins_locked_state
Mensaje de error: Current DB instance lock mode does not support this operation.
Qué verifica: Si la instancia está bloqueada.
Causa: La instancia se encuentra en estado Locking.
Solución: Desbloquee la instancia. Después de que el estado de la instancia cambie a Running, ejecute la verificación previa nuevamente. Para obtener más información, consulte What do I do if my instance is in the Locking state?
check_maxscale_kernel
Mensaje de error: The Maxscale version used by the instance is too low, please upgrade the Maxscale version first.
Qué verifica: Si la versión menor del proxy de base de datos MaxScale es compatible con la versión principal de destino, según la ruta de actualización.
Causa: La versión del proxy no cumple con el requisito de la versión menor de destino. Para actualizaciones de 5.7 a 8.0, la versión del proxy debe ser 1.13.41 o posterior. Para actualizaciones de 8.0 a 8.4, la versión del proxy debe ser 2.25.11 o posterior.
Solución: Upgrade the proxy to a supported minor version y luego ejecute la verificación previa nuevamente. Las actualizaciones de 8.0 a 8.4 requieren una versión de proxy resoluble de 2.25.11 o posterior.
check_ins_tde_state
Mensaje de error: Specified TDEStatus is not configured on the This custins.
Qué verifica: Si el cifrado transparente de datos (TDE) está habilitado.
Causa: TDE está habilitado en la instancia.
Solución: Las instancias con TDE habilitado no se pueden actualizar directamente desde la consola. Para conocer el procedimiento alternativo de actualización, consulte Upgrade the database version.
check_target_ins_level
Mensaje de error: Current DB instance level does not support this operation. (Error code: InvalidInstanceLevel.Malformed)
Qué verifica: Si el tipo de instancia actual está disponible para su compra.
Causa: La instancia utiliza un phased-out instance type. No se puede actualizar directamente.
Solución: Change the instance to a currently available instance type y luego reintente la actualización.
check_target_read_level
Mensaje de error: The read-only instance level is not supported in the target instance.
Qué verifica: Si el tipo de instancia de la instancia de solo lectura está disponible para su compra.
Causa: La instancia de solo lectura utiliza un tipo de instancia descontinuado. Esta verificación aplica a instancias que usan SSD locales.
Solución: Cambie la instancia de solo lectura a un tipo de instancia disponible y luego ejecute la verificación previa nuevamente.
Para cambiar el tipo de instancia, consulte Change the instance configuration.
Para encontrar tipos de instancia disponibles, consulte Instance types for standard read-only instances o Instance types for Yitian read-only instances.
check_upgrade_check_task
Mensaje de error: The task already exists.
Qué verifica: Si ya se está ejecutando una tarea de verificación previa para esta instancia.
Causa: Ya hay una verificación previa de actualización de versión principal del motor en curso.
Solución: Espere a que finalice la verificación previa. Después de que el estado de la instancia cambie a Running, ejecute la verificación previa nuevamente.
check_upgrade_task
Mensaje de error: The task already exists.
Qué verifica: Si ya se está ejecutando una tarea de actualización de versión principal del motor para esta instancia.
Causa: Ya hay una actualización de versión principal del motor en curso.
Solución: Espere a que finalice la actualización. Después de que el estado de la instancia cambie a Running, ejecute la verificación previa nuevamente.
check_storage_type
Mensaje de error: Cloud ssd does not support this operation, please upgrade to essd.
Qué verifica: Si la instancia utiliza SSD estándar.
Causa: La instancia utiliza SSD estándar.
Solución: Upgrade the storage type to ESSD (enterprise SSD) y luego reintente la actualización.
check_source_category
Mensaje de error: Specified source category is invalid.
Qué verifica: Si la edición de la instancia se encuentra dentro del rango compatible para actualizaciones de versión principal del motor.
Causa: La instancia no está en High-availability Edition, Basic Edition o Cluster Edition, o bien la ruta de actualización no admite el tipo de instancia actual.
Solución: Actualmente, las verificaciones previas de actualización solo son compatibles con instancias en High-availability Edition o en 5.7 Basic Edition.
check_ins_biz_type
Mensaje de error: Specified biz type is not valid.
Qué verifica: Si la instancia es una instancia de nube pública.
Causa: La instancia no es una instancia de nube pública.
Solución: Las verificaciones previas de actualización de versión principal del motor solo son compatibles con instancias de nube pública.
check_ins_tables_number
Mensaje de error: Upgrade not allowed due to excessive number of tables: more than 1000,000.
o
Upgrade not allowed due to excessive number of tables: more than 1,000,000.
Qué verifica: Si el número de tablas en la instancia excede el límite permitido por la ruta de actualización actual.
Causa:
Una instancia con SSD local tiene más de 1,000,000 de tablas y no se puede actualizar.
Una instancia con disco en la nube tiene más de 1,000,000 de tablas y no se puede actualizar.
Solución: Elimine las tablas redundantes y luego ejecute la verificación previa nuevamente.
check_ins_db_engine
Mensaje de error: There are engines present such as MyISAM, Memory, TokuDB, Sphinx, or RocksDB.
Qué verifica: Si alguna tabla utiliza un motor de almacenamiento distinto de InnoDB.
Causa: La instancia contiene tablas que usan MyISAM, Memory, TokuDB, Sphinx o RocksDB. Estos motores de almacenamiento no son compatibles con las actualizaciones de versión principal del motor.
Solución: Convierta todas las tablas a InnoDB antes de actualizar. Si la base de datos ya usa InnoDB pero algunas tablas individuales utilizan otros motores, ejecute el siguiente comando para cada tabla afectada:
ALTER TABLE <table_name> engine=InnoDB;check_ins_fts
Mensaje de error: The current instance has an FTS index, and the minor version is less than 20221130.
Qué verifica: Si la instancia tiene índices de texto completo y si la versión menor de la instancia de origen es anterior a 20221130.
Causa: En versiones anteriores de RDS for MySQL 5.6, los índices de texto completo se crean en el tablespace del sistema. Durante una actualización, estos índices pueden dañar el tablespace. Este problema se corrigió en la versión menor del motor 20221130 de RDS for MySQL 5.6, donde los índices de texto completo se crean en un tablespace separado.
Solución: Antes de actualizar de RDS for MySQL 5.6 a 5.7, elimine cualquier índice de texto completo del tablespace del sistema.
Asegúrese de que la instancia ejecute la versión menor del motor 20221130 o posterior de RDS for MySQL 5.6. De lo contrario, upgrade to the latest RDS for MySQL 5.6 minor engine version primero.
-
Elimine el índice de texto completo del tablespace del sistema. Utilice el nombre de tabla que se muestra en el mensaje de error.
ALTER TABLE $table_name DROP INDEX $fts_name; -
Vuelva a crear el índice de texto completo.
ALTER TABLE $table_name ADD FULLTEXT INDEX $fts_name; -
Compruebe que no queden índices de texto completo en el tablespace del sistema. La siguiente consulta devuelve dichos índices. Un resultado vacío significa que la verificación previa no fallará debido a este problema.
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
Mensaje de error: The number of read-only instances cannot be greater than 8.
Qué verifica: El número de instancias de solo lectura para instancias que usan SSD locales.
Causa: La instancia tiene más de 8 instancias de solo lectura. Este límite aplica únicamente a instancias que usan SSD locales.
Solución: Libere las instancias de solo lectura adicionales. Una vez completada la actualización, vuelva a crearlas.
check_slave_state
Mensaje de error: The slave status is unhealthy or has delays.
Qué verifica: El estado de salud y la latencia de replicación del nodo secundario.
Causa: El nodo secundario se encuentra en un estado anómalo o presenta un retraso en la replicación.
Solución: En la consola, revise las métricas de monitoreo Node Replication Thread Status (seconds) y Node Replication Latency (seconds) bajo Monitoring and alerts. Espere a que el nodo secundario vuelva a la normalidad y luego ejecute la verificación previa nuevamente.
check_account
Mensaje de error: The instance has an aliyun_root account.
Qué verifica: Si existe una cuenta aliyun_root en la instancia.
Causa: Un usuario creó manualmente una cuenta aliyun_root en RDS for MySQL 5.6. La cuenta aliyun_root es una cuenta predeterminada del sistema en RDS for MySQL 5.7 y versiones posteriores. Si ya existe en 5.6, la actualización a 5.7 fallará con un error de nombre duplicado.
Solución: Elimine o cambie el nombre de la cuenta aliyun_root creada manualmente antes de ejecutar la verificación previa. Para obtener información sobre las cuentas del sistema, consulte System accounts.
check_sys_schema
Mensaje de error: The instance already has a sys database.
Qué verifica: Si existe una base de datos sys en la instancia.
Causa: La base de datos sys se crea de forma predeterminada en RDS for MySQL 5.7. Si ya existe en una instancia 5.6, la actualización a 5.7 fallará.
Solución: Cambie el nombre de la base de datos sys existente. Dado que MySQL no admite RENAME DATABASE, ejecute ALTER TABLE ... RENAME para cada tabla individualmente.
Para confirmar si existe la base de datos sys, ejecute:
SELECT * FROM information_schema.SCHEMATA WHERE SCHEMA_NAME='sys';check_table_discard
Mensaje de error: There are tables that have been discarded.
Qué verifica: Si la instancia tiene tablas con tablespaces descartados (tablas en las que se ejecutó ALTER TABLE ... DISCARD TABLESPACE) y que no se han restaurado.
Causa: La instancia contiene tablas descartadas cuyo tamaño de archivo de tablespace y tamaño de bloque son ambos 0.
Solución: Después de confirmar la seguridad de los datos, restaure o elimine las tablas afectadas y luego ejecute la verificación previa nuevamente. Para la versión de origen 5.7, ejecute:
SELECT space,name FROM INFORMATION_SCHEMA.INNODB_SYS_TABLESPACES WHERE FS_BLOCK_SIZE=0 AND FILE_SIZE=0 AND name NOT LIKE '%#sql%';Para la versión de origen 8.0, ejecute:
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
Mensaje de error: The partitioned table contains foreign keys.
Qué verifica: Si alguna tabla particionada tiene claves externas, o si alguna tabla particionada es referenciada por claves externas de otras tablas.
Causa: Una tabla particionada contiene una clave externa, o la clave externa de otra tabla hace referencia a una tabla particionada.
Solución: Resuelva los conflictos entre claves externas y tablas particionadas.
-
Consulte las tablas particionadas que contienen claves externas.
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); -
Consulte las tablas particionadas a las que hacen referencia claves externas de otras tablas.
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
Mensaje de error: The number of views with column length greater than or equal to 64 is greater than 0.
Qué verifica: Si alguna vista tiene nombres de columna de 64 caracteres o más.
Causa: MySQL no admite nombres de columna de vistas con 64 caracteres o más.
Solución: Consulte las vistas afectadas y luego elimínelas o acorte los nombres de las columnas.
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
Mensaje de error: The number of tables with foreign key constraint length greater than 64 is greater than 0.
Qué verifica: Si alguna tabla tiene nombres de restricción de clave externa con más de 64 caracteres.
Causa: No se admiten nombres de restricción de clave externa con más de 64 caracteres.
Solución: Acorte los nombres de restricción de clave externa afectados y luego ejecute la verificación previa nuevamente. Para la versión de origen 5.7, consulte INFORMATION_SCHEMA.INNODB_SYS_FOREIGN. Para la versión de origen 8.0, consulte INFORMATION_SCHEMA.INNODB_FOREIGN. El siguiente ejemplo corresponde a 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
Mensaje de error: 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.
Qué verifica: Si alguna tabla en la base de datos del sistema de MySQL 5.7 comparte nombre con las tablas utilizadas por el diccionario de datos de MySQL 8.0.
Causa: Una o más tablas en la base de datos del sistema de MySQL 5.7 tienen nombres que entran en conflicto con el diccionario de datos de MySQL 8.0.
Solución: Busque los nombres de tabla en conflicto y luego elimínelos o cámbieles el nombre.
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
Mensaje de error: The master node of the instance is not available.
Qué verifica: La conectividad y disponibilidad de la instancia.
Causa: Recursos como CPU o disco están totalmente utilizados, lo que provoca que el nodo primario no esté disponible.
Solución: En la consola, utilice la función Monitoring and alerts para comprobar si todas las métricas de monitoreo se encuentran dentro de rangos normales.
check_table_index_type
Mensaje de error: 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.
Qué verifica: La compatibilidad de índices según la ruta de actualización. Para actualizaciones de 5.7 a 8.0, busca índices BTREE en campos espaciales. Para actualizaciones de 8.0 a 8.4, verifica si la instancia contiene índices SPATIAL.
Causa: Para actualizaciones de 5.7 a 8.0, la instancia tiene índices BTREE en campos espaciales. Para actualizaciones de 8.0 a 8.4, la instancia tiene índices SPATIAL.
Solución: Elimine los índices incompatibles detectados antes de la actualización y vuelva a crearlos según las reglas de la versión de destino después de completar la actualización. Para actualizaciones de 5.7 a 8.0, ejecute la siguiente consulta:
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';Para actualizaciones de 8.0 a 8.4, ejecute la siguiente consulta:
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
Mensaje de error: The specifications of read-only instances are inconsistent.
Qué verifica: Si varias instancias de solo lectura bajo una instancia con SSD local utilizan tipos de instancia consistentes.
Causa: Las instancias de solo lectura bajo la misma instancia primaria utilizan diferentes tipos de instancia, por lo que el tipo de instancia de destino no se puede asignar uniformemente durante la actualización.
Solución: Cambie las instancias de solo lectura estándar a un tipo de instancia disponible consistente y luego ejecute la verificación previa nuevamente.
check_bak_read_exists
Mensaje de error: There is a read-only instance, but there is no standby read-only instance.
Qué verifica: Si existe al menos una instancia de solo lectura en espera cuando una instancia con SSD local tiene instancias de solo lectura estándar.
Causa: La instancia tiene instancias de solo lectura estándar pero ninguna instancia de solo lectura en espera, lo cual no cumple con el requisito de conmutación de la actualización.
Solución: Ajuste la topología de instancias de solo lectura y mantenga al menos una instancia de solo lectura en espera. Si no puede completar esto en la consola, envíe un ticket.
check_bak_read_number
Mensaje de error: Verify that the number of spare read-only instances cannot exceed 5.
Qué verifica: Si el número de instancias de solo lectura en espera de una instancia con SSD local excede 5.
Causa: El número de instancias de solo lectura en espera es mayor que 5.
Solución: Libere o ajuste las instancias de solo lectura en espera adicionales para que el número no exceda 5, y luego ejecute la verificación previa nuevamente.
check_read_ins_conn_type
Mensaje de error: The network types of the read-only instance and the standby read-only instance are inconsistent.
Qué verifica: Si los tipos de conexión de red de la instancia de solo lectura estándar y la instancia de solo lectura en espera son consistentes.
Causa: Existen tanto tipos de conexión LVS como DNS en la misma topología.
Solución: Cambie la instancia de solo lectura estándar y la instancia de solo lectura en espera a un tipo de conexión consistente, y luego ejecute la verificación previa nuevamente.
check_interrupt_task
Mensaje de error: The standby read-only has unfinished tasks.
Qué verifica: Si la instancia de solo lectura en espera tiene tareas de versión principal sin finalizar o interrumpidas.
Causa: La instancia de solo lectura en espera aún tiene tareas en estado de espera, ejecución, pausa o interrupción.
Solución: Espere a que finalicen las tareas relacionadas, o gestione y finalice las tareas anómalas, y luego ejecute la verificación previa nuevamente.
check_mgr_disabled_for_84
Mensaje de error: MySQL 8.4 no longer supports Group Replication (MGR).
Qué verifica: Si MGR está habilitado en la instancia de origen al actualizar de 8.0 a 8.4. Comprueba si existen miembros en performance_schema.replication_group_members, o si group_replication_start_on_boot está configurado en ON.
Causa: La instancia tiene miembros MGR o está configurada para iniciar automáticamente Group Replication cuando arranca la instancia.
Solución: Ejecute STOP GROUP_REPLICATION; para detener MGR, elimine los parámetros relacionados con Group Replication y reinicie la instancia. Después de confirmar que MGR ya no está habilitado, ejecute la verificación previa nuevamente.