ApsaraDB RDS:Restore an RDS MySQL physical backup to a self-managed database

• P: ¿Por qué ocurre un error al descargar un archivo de datos?

  R: Cuando utilice el comando wget -c 'https://****.bak.rds.aliyuncs.com/****_xb.qp?****' -O test_xb.qp, encierre la dirección de descarga entre comillas simples (') para ayudar al programa a identificar correctamente la dirección y evitar errores.

Cuando ejecute el siguiente comando de descompresión, reemplace test_xb.qp con el nombre de su archivo de copia de seguridad y /var/mysql_bkdata/ con la ruta de descompresión de copia de seguridad que creó.

### MySQL 8.0
qpress -do  test_xb.qp | /u01/xtrabackup80/bin/xbstream -x -v -C /var/mysql_bkdata/

### MySQL 5.5/5.6/5.7
qpress -do  test_xb.qp | xbstream -x -v -C /var/mysql_bkdata/

Cuando ejecute el siguiente comando de descompresión, reemplace test_qp.xb con el nombre de su archivo de copia de seguridad y /var/mysql_bkdata/ con la ruta de descompresión que creó.

## Step 1: Unpack the file
cat test_qp.xb | xbstream -x -v -C /var/mysql_bkdata/

## Step 2: Decompress the file
### MySQL 5.5/5.6/5.7
innobackupex --decompress --remove-original /var/mysql_bkdata/

### MySQL 8.0
/u01/xtrabackup80/bin/xtrabackup --decompress --remove-original --target-dir=/var/mysql_bkdata/

Cuando ejecute el siguiente comando de descompresión, reemplace test.tar.gz con el nombre de su archivo de copia de seguridad y /var/mysql_bkdata/ con la ruta de descompresión de copia de seguridad que creó.

tar -izxvf test.tar.gz -C /var/mysql_bkdata/

Cuando ejecute el siguiente comando de descompresión, reemplace test.xb.gz con el nombre de su archivo de copia de seguridad y /var/mysql_bkdata/ con la ruta de descompresión que creó.

### MySQL 8.0
gzip -d -c test.xb.gz | /u01/xtrabackup80/bin/xbstream -x -v -C /var/mysql_bkdata/

### MySQL 5.5/5.6/5.7
gzip -d -c test.xb.gz | xbstream -x -v -C /var/mysql_bkdata/

• P: ¿Qué debo hacer si ocurre un error al descomprimir un archivo de copia de seguridad descargado?

  R: Revise los siguientes puntos para solucionar el error:

  Confirme que el archivo descargado sea un archivo de copia de seguridad física.

  Confirme que el archivo comprimido guardado tenga el sufijo de nombre de archivo correcto (el sufijo debe ser el de la URL, como xb.qp, .tar.gz, .xb.gz o _qp.xb).

  Utilice el comando de descompresión adecuado para el formato de archivo.

  Errores comunes:

  • Al ejecutar el comando de descompresión, se reporta el error sh: qpress: command not found.

    Solución: Consulte Prerequisites para asegurarse de que la herramienta qpress esté instalada en su servidor de base de datos autogestionada.

  • Al descomprimir un paquete xbstream con la extensión _qp.xb, ocurre el error innobackupex not found.

    Solución: Consulte Prerequisites para asegurarse de que Percona XtraBackup esté instalado en su servidor de base de datos autogestionada.

  • Se reporta el error can't change to dir to xx( errorcode:no such file or directory) cuando utiliza el comando cat para desempaquetar un archivo de paquete xbstream con sufijo _qp.xb.

    Solución: Este error indica un nombre de archivo o una ruta incorrectos. Verifique el nombre del archivo y la ruta en su comando.

• P: El sistema devuelve el error xtrabackup: Unknown error 3613. ¿Cómo puedo resolverlo?

  R: Actualice Percona XtraBackup a la versión más reciente e inténtelo de nuevo.

• P: El sistema devuelve el error Original data directory /var/mysql_newdata is not empty!. ¿Qué debo hacer?

  R: Utilice el comando sudo rm -rf /var/mysql_newdata/* para borrar los archivos de la carpeta y luego reintente la operación de restauración.

• P: El sistema devuelve el error InnodDB: Encryption information in datafile: ./xxx.ibd can't be decrypted, please check if a keyring plugin is loaded and initialized successfully.. ¿Qué debo hacer?

  Compruebe si TDE está habilitado para su instancia:

  • Si TDE está habilitado, busque tablas cifradas. Como se describe en Prerequisites, descifre las tablas cifradas siguiendo las instrucciones en Configure Transparent Data Encryption (TDE) y luego siga las instrucciones de este tema para restaurar los datos.

  • Si TDE no está habilitado, asegúrese de tener instalada la versión correcta de Percona XtraBackup como se describe en Prerequisites.

• P: Un archivo de copia de seguridad descargado contiene datos cifrados con TDE, lo que provoca un error en la restauración. ¿Cuál es la solución?

  R: No es posible restaurar datos desde un archivo de copia de seguridad cifrado descargado. Las tablas cifradas en una instancia de RDS causan errores de restauración. Como se describe en Prerequisites, descifre las tablas siguiendo las instrucciones en Configure Transparent Data Encryption (TDE), cree una nueva copia de seguridad y luego restaure los datos nuevamente.

• P: ¿Cómo resuelvo el error innobackupex: File 'undo001' not found (Errcode: 2 - No Such file or directory) que ocurre durante una restauración?

  R: El archivo undo es un archivo del sistema que varía según la versión de la base de datos. Compruebe si su base de datos autogestionada tiene la misma versión que la base de datos ApsaraDB RDS for MySQL.

• P: ¿Qué causa el error mysqld: [ERROR] Failed to open required defaults file: /etc/my.cnf en un sistema operativo Ubuntu y cómo puedo resolverlo?

  R: Este error es causado por el programa de seguridad AppArmor de Ubuntu. Utilice los comandos apt install -y apparmor-utils y aa-complain /usr/sbin/mysqld para modificar la configuración de AppArmor.

• P: Una vez completada la restauración, ¿qué debe hacer si una base de datos autogestionada no se inicia o si encuentra el error error 1105 Unknown error durante su uso?

  R: Ejecute las siguientes sentencias SQL para cambiar el motor de almacenamiento de la base de datos:

  USE mysql;
  ALTER TABLE proc engine=myisam;
  ALTER TABLE event engine=myisam;
  ALTER TABLE func engine=myisam;

  Nota

  Si recibe el error ERROR 1067 (42000): Invalid default value for 'modified', ejecute primero la sentencia SET SQL_MODE='ALLOW_INVALID_DATES';.

• P: ¿Cuál es la contraseña de root después de restaurar la base de datos?

  R: El método para obtener la contraseña de root varía según la versión:

  • Si su instancia ejecuta MySQL 5.7 u 8.0, la contraseña de root es la misma que la de su base de datos autogestionada.

  • Si su instancia ejecuta MySQL 5.5 o 5.6, debe restablecer la contraseña de root antes de poder usar la base de datos. Para más información, consulte la documentación oficial.

• P: El error InnodDB: Assertion failure in thread 140xxx in file page0zip.ic xxx ocurre durante el inicio. ¿Cómo puedo resolverlo?

  R: Este error puede deberse a espacio insuficiente en disco. Intente expandir el disco de su servidor de base de datos autogestionada y vuelva a intentarlo.

• P: ¿Cómo resuelvo los siguientes errores que ocurren durante el inicio: [ERROR] Failed to open the relay log xxx, [ERROR] Slave: Failed to initialize the master info xxx o [ERROR] Failed to create or recover replication info repositories.?

  R: Estos errores ocurren porque la instancia de RDS está configurada para alta disponibilidad (HA), pero la base de datos autogestionada local no utiliza nodos primarios y secundarios. Puede ignorar estos errores de forma segura, ya que no afectan el inicio.

• P: ¿Cómo puedo resolver el error [ERROR] Data Dictionary initialization failed que ocurre durante el inicio?

  R: Este error puede deberse a un sistema operativo incompatible. El sistema operativo subyacente de ApsaraDB RDS es Linux. Se recomienda utilizar un sistema operativo basado en Linux para restaurar la base de datos, ya que usar un sistema operativo diferente puede causar problemas de compatibilidad de versiones.

• P: El comando sudo systemctl start mysqld no logra iniciar el servicio local de MySQL. ¿Qué debo hacer?

  R: Esto puede deberse a que SELinux está en modo Enforcing en Linux. Ejecute el comando getenforce para comprobar el estado actual de SELinux.

  • Si se trata de un entorno de desarrollo o pruebas, se recomienda cambiar el modo de SELinux a modo Permissive. Luego, intente iniciar MySQL mediante sudo systemctl start mysqld.

  • Para entornos de producción, se recomienda revisar los registros de SELinux para determinar la razón específica del fallo de inicio y luego corregir la política de SELinux con base en esa información.

• P: Después de la restauración, ¿por qué los valores de tiempo en mis datos no coinciden con la hora local y cómo lo corrijo?

  R: Si la zona horaria de la base de datos autogestionada es diferente a la de la instancia de RDS, debe modificar el parámetro time_zone de la base de datos autogestionada para que coincida con el de la instancia de RDS. Si el parámetro time_zone de la instancia de RDS está establecido en system, compruebe la región donde se encuentra la instancia de RDS y establezca el parámetro time_zone de la base de datos autogestionada en la zona horaria de dicha región.

• P: Recibo el error Access denied for user 'XXX' al conectarme a una base de datos autogestionada. ¿Cómo puedo resolverlo?

  R: Verifique que esté utilizando la cuenta y contraseña correctas de la instancia original de ApsaraDB RDS for MySQL.

• P: Olvidé mi contraseña al conectarme a la base de datos autogestionada. ¿Qué debo hacer?

  R: Si olvidó su cuenta o contraseña, inicie el proceso de MySQL con el parámetro --skip-grant-tables. Esta acción omite las verificaciones de permisos al inicio, lo que le permite iniciar sesión en la base de datos sin cuenta ni contraseña. Tenga en cuenta que usar el parámetro --skip-grant-tables representa un riesgo de seguridad. Debe cambiar su cuenta y contraseña inmediatamente después de iniciar sesión.

• P: Después de conectarme a la base de datos autogestionada, solo puedo ver bases de datos del sistema o algunas de las bases de datos. ¿Cómo manejo esto?

  R: Reinicie la base de datos y luego conéctese utilizando la cuenta root o una cuenta con privilegios elevados de la instancia original de RDS para consultar las bases de datos.