How to download cluster backup files - PolarDB - Centro de documentación de Alibaba Cloud

PolarDB le permite descargar archivos de copia de seguridad desde un conjunto de copias de seguridad de clúster a su computadora local. Esto es útil para el almacenamiento a largo plazo, la consulta de datos históricos, la transferencia de copias de seguridad (por ejemplo, a OSS) y las auditorías.

Nota

No es posible restaurar directamente los datos de copia de seguridad descargados en un clúster de PolarDB for MySQL. Para ello, restore downloaded backup files to a self-managed MySQL database.

Fecha de lanzamiento

24 de noviembre de 2023

Nota

La función de descarga de archivos de copia de seguridad se encuentra en fase de lanzamiento canary y se implementará de forma gradual.

Facturación

Los archivos de copia de seguridad se pueden descargar mediante una URL (almacenada temporalmente en DBS) o transferirlos a su bucket de OSS. Los cargos varían según el destino de descarga:

Nota

Si una tarea de descarga presenta errores, no se genera ningún cargo.
En la consola de PolarDB, vaya a Settings and Management > Backup and Restoration > Backup Download List de su clúster para consultar el monthly backup conversion volume y el monthly outbound internet traffic.

Cargos de almacenamiento

URL: los archivos se almacenan temporalmente en el almacenamiento integrado de DBS. No se generan cargos por este concepto.
OSS: los archivos se transfieren a su bucket de OSS. Para obtener más información sobre los cargos de almacenamiento de OSS, consulte OSS storage fees.

Cargos por conversión del conjunto de copias de seguridad

Convertir un conjunto de copias de seguridad al formato SQL, CSV, Parquet o CSV-with-header genera cargos de conversión, sin importar si el destino es una URL u OSS. Esta conversión no cuenta con ninguna cuota gratuita. El precio es de 0.03125 USD por GB.

Cargos por tráfico

URL:
- Descarga a través de una red interna: sin costo.
- Descarga a través de Internet: se proporciona una cuota gratuita de 500 GB por clúster al mes. La transferencia de datos que supere esta cuota se factura bajo el modelo pay-as-you-go. Los cargos se calculan diariamente con base en la cantidad de datos descargados. Para conocer los precios, consulte Network fees.
Nota
Se recomienda adquirir un plan de datos de data transfer plan bajo el modelo de suscripción para cubrir los cargos de tráfico de red generados al descargar copias de seguridad por Internet. A mayor capacidad del plan de transferencia de datos, mayor será el descuento.
OSS: los archivos se transfieren a su bucket de OSS. Para obtener información sobre los cargos por tráfico, consulte OSS traffic fees.

Requisitos previos

Clúster: esta función solo está disponible para la edición Cluster Edition de los clústeres Enterprise Edition.
Región: China (Chengdu), China (Guangzhou), China (Qingdao), China (Beijing), China (Shanghai), China (Zhangjiakou), China (Hangzhou), China (Shenzhen), China (Hong Kong), Malaysia (Kuala Lumpur), Indonesia (Jakarta), Japan (Tokyo), Singapore, US (Silicon Valley), US (Virginia) y Germany (Frankfurt).

Nota
Esta función estará disponible en otras regiones próximamente.
Otros:
- El usuario de RAM debe contar con los permisos necesarios para descargar archivos de copia de seguridad. Para otorgar permisos a un usuario de RAM, consulte RAM user permissions.
- Los datos de copia de seguridad no están cifrados. No es posible descargar archivos de copia de seguridad desde clústeres de PolarDB cifrados.
- Solo se permite una tarea de descarga (en ejecución o con errores) por clúster o instancia a la vez.

Límites

El proceso de descarga exporta la mayoría de las estructuras de tablas, pero no todas:
- Elementos compatibles con la exportación: información de columnas, índices de clave primaria, índices que no son de clave primaria, índices únicos, información de tablas particionadas, motores de tablas, así como conjuntos de caracteres e intercalaciones a nivel de tabla o de base de datos.
- Elementos no compatibles con la exportación: índices de expresión, claves externas, columnas generadas, columnas ocultas, vistas, funciones, procedimientos almacenados, variables del sistema y triggers.
Las tareas de conversión presentarán errores si los datos incluyen campos con los siguientes tipos de datos espaciales:

GEOMETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION
Los archivos exportados no incluyen las siguientes bases de datos del sistema:

information_schema, mysql, performance_schema, sys, __recycle_bin__
Si selecciona OSS como destino de descarga, la clase de almacenamiento del bucket de OSS debe ser Standard. Para cambiar la clase de almacenamiento, consulte Convert storage classes.

Nota
Es necesario manually create un bucket de OSS. Si ya creó un bucket para almacenar archivos de copia de seguridad, omita este paso.
Solo es posible descargar datos de una level-1 backup. Los datos de una level-2 backup no se pueden descargar.
Si cold data archiving está habilitado para el clúster, no es posible descargar un conjunto de copias de seguridad.
Si los nombres de las bases de datos o tablas que se van a descargar contienen barras diagonales (/), la tarea de descarga presentará errores.

Procedimiento

(Recomendado) Uso de la consola

Inicie sesión en la consola de PolarDB. En el panel de navegación izquierdo, haga clic en Clusters. Seleccione la región donde se encuentra el clúster y, a continuación, haga clic en el ID del clúster para ir a la página de detalles.
En el panel de navegación izquierdo, haga clic en Settings and Management > Backup and Restoration.
En la pestaña Data Backups, busque el conjunto de copias de seguridad deseado y haga clic en Download Cluster Backup en la columna Actions.
Nota
- De forma predeterminada, la consola muestra las copias de seguridad de los últimos ocho días. Para consultar copias de seguridad anteriores, modifique el rango de tiempo.
- Si no se muestra el botón Download Cluster Backup , compruebe que la versión del producto o la región de su clúster cumplan con los prerequisites.
En el paso Point in Time and Backup Set, seleccione Download by Point in Time o Download by Backup Set y, a continuación, haga clic en Next.

Si selecciona By Backup Set, elija el conjunto de copias de seguridad deseado en la lista desplegable Backup Set.
En el paso Instance, Database, and Table, haga clic en Next. La opción Instance Download viene preseleccionada y no se puede modificar.
En el paso Destination and Format, seleccione el destino y el formato de descarga, y complete la configuración.
Importante
- Se recomienda seleccionar OSS como destino de descarga para ahorrar tiempo.
- Una tarea de descarga de copia de seguridad no se puede cancelar una vez iniciada.
- Las tareas de descarga de copias de seguridad generan cargos. Para obtener más información, consulte Billing.
(Recomendado) OSS

Si selecciona OSS como destino de descarga, los datos se escriben directamente en su bucket de OSS. Una vez completada la descarga, elimine los datos cuando lo necesite.
1. Introduzca el nombre de su bucket de OSS y un prefijo de directorio, como xx/xx.
  Nota
  
  Es necesario manually create un bucket de OSS. Si ya creó un bucket para almacenar archivos de copia de seguridad, introduzca su nombre directamente.
  
  La clase de almacenamiento del bucket de OSS debe ser Standard. Para cambiar la clase de almacenamiento, consulte Convert storage classes.
2. Seleccione un formato de descarga. Puede establecer el formato de descarga en CSV, SQL, Parquet o CSV-with-header. Elija el formato según sus necesidades de negocio.
3. Lea y acepte los términos, y luego haga clic en Complete. El sistema lo redirigirá a la pestaña Backup Download List. Espere a que finalice la tarea de descarga.
  Nota
  
  La función de descarga de copias de seguridad requiere que DBS tenga autorización para acceder a sus recursos en la nube. Si aún no ha otorgado los permisos de acceso, siga las indicaciones de la consola: haga clic en Authorize > Submit. Una vez completada la autorización, regrese a la página de configuración de descarga avanzada e introduzca la información requerida tal como se indica en los pasos anteriores.
  
  La conversión de formatos consume muchos recursos. Una descarga podría presentar errores si los recursos del servidor no están disponibles temporalmente. Los formatos de datos especiales no compatibles también provocan fallos en la descarga. Si una tarea presenta errores, se recomienda reintentarla o ponerse en contacto con el soporte técnico de DBS.
  
  Las tareas con errores no generan cargos.
4. Cuando el estado de la tarea cambie a Successful, podrá consultar el archivo de copia de seguridad en el bucket de OSS correspondiente.
URL

Si selecciona URL como destino de descarga, el sistema almacena temporalmente los datos convertidos en el almacenamiento integrado de DBS. Este proceso no genera cargos de almacenamiento.

Nota
La descarga desde una URL implica empaquetar los datos, lo cual requiere tiempo adicional. Este tiempo depende del tamaño lógico del conjunto de copias de seguridad. Si el conjunto es grande (por ejemplo, superior a 1 TB), se recomienda descargarlo a OSS.
1. Seleccione un formato de descarga. Puede establecer el formato de descarga en CSV, SQL, Parquet o CSV-with-header. Elija el formato según sus necesidades de negocio.
2. Lea y acepte los términos, y luego haga clic en Complete. El sistema lo redirigirá a la pestaña Backup Download List. Espere a que finalice la tarea de descarga.
  Nota
  
  La función de descarga de copias de seguridad requiere que DBS tenga autorización para acceder a sus recursos en la nube. Si aún no ha otorgado los permisos de acceso, siga las indicaciones de la consola: haga clic en Authorize > Submit. Una vez completada la autorización, regrese a la página de configuración de descarga avanzada e introduzca la información requerida tal como se indica en los pasos anteriores.
  
  La conversión de formatos consume muchos recursos. Una descarga podría presentar errores si los recursos del servidor no están disponibles temporalmente. Los formatos de datos especiales no compatibles también provocan fallos en la descarga. Si una tarea presenta errores, se recomienda reintentarla o ponerse en contacto con el soporte técnico de DBS.
  
  Las tareas con errores no generan cargos.
3. Consulte el archivo de copia de seguridad: si el estado de la tarea de descarga es Successful, la descarga finalizó. En la columna Download Destination, haga clic en Generate URL, establezca el Validity Period y, a continuación, haga clic en Generate URL. Después, utilice la URL interna o pública generada para descargar los datos de la copia de seguridad.
  Nota
  
  El enlace de descarga se puede obtener dentro de los tres días posteriores a la finalización de la tarea. El periodo de validez del enlace se puede configurar de 5 minutos a 1 día. De forma predeterminada, la validez es de 2 horas.
  
  Las tareas completadas caducan después de tres días, momento en el que el enlace de descarga también caduca. Los datos de una tarea caducada se eliminan automáticamente tras su vencimiento. Si aún necesita los datos, inicie una nueva tarea de descarga para obtener un nuevo enlace.
  
  Guarde el enlace de descarga y manténgalo confidencial para evitar filtraciones de datos.
  
  El uso de herramientas de descarga de terceros podría generar tráfico adicional y provocar cargos extra. Utilice estas herramientas con precaución. Para conocer los métodos de descarga recomendados, consulte Download commands.

Uso de una API

DescribeDownloadSupport: consulta si su clúster admite la función de descarga de archivos de copia de seguridad.

Nota
Si la respuesta de la API indica que la función no es compatible, compruebe que la versión del producto y la región de su clúster cumplan con los prerequisites.
CreateDownload: crea una tarea de descarga de archivos de copia de seguridad.
Nota
- La función de descarga de copias de seguridad requiere otorgar a DBS los permisos AliyunDBSDefaultRole para acceder a sus recursos en la nube. Si aún no los ha otorgado, hágalo primero desde la consola.
- Cuando TargetType (tipo de destino de descarga) es OSS, primero debe manually create el bucket de destino y asegurarse de que su clase de almacenamiento sea Standard.
- Cuando TargetType (tipo de destino de descarga) es URL, guarde el valor TaskId (ID de tarea) devuelto para recuperar el enlace de descarga.
- Una tarea de descarga de copia de seguridad no se puede cancelar una vez iniciada.
- Las tareas de descarga de copias de seguridad generan cargos. Para obtener más información, consulte Billing.
(Opcional) DescribeDownloadTask: consulte el estado y otros detalles de las tareas de descarga de copias de seguridad de su clúster.
Obtenga el archivo de copia de seguridad:
- Si el destino de descarga es OSS, el sistema escribe los datos directamente en su bucket de OSS, donde podrá consultarlos.
- Si el destino de descarga es una URL, llame a la operación DescribeDownloadBackupSetStorageInfo para obtener el enlace de descarga.
  Nota
  - El enlace de descarga se puede obtener dentro de los tres días posteriores a la finalización de la tarea. El periodo de validez del enlace se puede configurar de 5 minutos a 1 día. De forma predeterminada, la validez es de 2 horas.
  - Las tareas completadas caducan después de tres días, momento en el que el enlace de descarga también caduca. Los datos de una tarea caducada se eliminan automáticamente tras su vencimiento. Si aún necesita los datos, inicie una nueva tarea de descarga para obtener un nuevo enlace.
  - Guarde el enlace de descarga y manténgalo confidencial para evitar filtraciones de datos.
  - El uso de herramientas de descarga de terceros podría generar tráfico adicional y provocar cargos extra. Utilice estas herramientas con precaución. Para conocer los métodos de descarga recomendados, consulte Download commands.

Preguntas frecuentes

¿Es posible cancelar una tarea de descarga de copia de seguridad en curso?

No. Una tarea de descarga de copia de seguridad no se puede cancelar una vez iniciada.

¿Cómo utilizo los archivos descargados de copia de seguridad de datos y de registros?

Para ello, restore the downloaded backup files to a self-managed MySQL database.

¿Por qué recibo el error **ERROR 1148 (42000): The used command is not allowed with this MySQL version** al restaurar un archivo de copia de seguridad descargado en una base de datos MySQL local?

Ejecute la consulta show variables like 'local_infile'; en su base de datos MySQL. Si el resultado es OFF, ejecute la siguiente instrucción para habilitar la importación de archivos: set global local_infile = 1;. Después, vuelva a ejecutar el script de importación.

¿Por qué el tamaño de la copia de seguridad que aparece en la consola difiere del tamaño real del archivo descargado?

Los archivos de copia de seguridad descargados están comprimidos y suelen ser más pequeños que el tamaño mostrado en la consola. Restaure el archivo para comprobar si los datos están completos.

¿Puedo restaurar directamente un archivo de copia de seguridad descargado en otro clúster de PolarDB?

No, no es posible restaurar directamente un archivo de copia de seguridad descargado en otro clúster de PolarDB. Primero debe restore the backup file to a self-managed MySQL database y luego utilizar Data Transmission Service (DTS) para migrate data from the self-managed MySQL database to PolarDB for MySQL.

Apéndice

Permisos de usuarios de RAM

Esta función utiliza RAM para gestionar los permisos. Configure estos permisos para controlar qué usuarios de RAM pueden obtener enlaces de descarga.

Otorgar permisos de descarga a usuarios de RAM

Si no logra usar la función de descarga de copias de seguridad (por ejemplo, no puede crear ni consultar tareas de descarga), compruebe si su usuario de RAM cuenta con los permisos de gestión para la recuperación ante desastres de datos (AliyunDBSFullAccess). Para obtener más información sobre cómo otorgar permisos, consulte Manage RAM user permissions.

Bloquear enlaces de descarga para usuarios de RAM

Si un usuario de RAM necesita permisos para usar las funciones de copia de seguridad y restauración, pero no debe obtener enlaces de descarga de archivos de copia de seguridad, create a custom policy para denegarle el permiso de llamar a la operación de la API que recupera dichos enlaces. El siguiente script es un ejemplo de directiva:

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "dbs:DescribeDownloadBackupSetStorageInfo",
            "Resource": "*"
        }
    ]
}

Después de crear la directiva personalizada, attach la directiva al usuario de RAM. Con esto, el usuario de RAM quedará bloqueado para obtener enlaces de descarga.

Permitir que los usuarios de solo lectura descarguen copias de seguridad

Por motivos de seguridad, un usuario de RAM que solo tiene permisos de solo lectura para PolarDB (AliyunPolardbReadOnlyAccess) no puede descargar archivos de copia de seguridad.

En este caso, si el usuario de RAM necesita permisos para descargar archivos de copia de seguridad, otórguele permisos de solo lectura para la recuperación ante desastres de datos (AliyunDBSReadOnlyAccess). Una vez otorgado este permiso, el usuario de RAM podrá consultar los enlaces de descarga de las tareas de copia de seguridad completadas. Para obtener más información sobre cómo otorgar permisos, consulte Manage RAM user permissions.

Comandos de descarga

Nota

Si la velocidad de descarga es inferior a 64 KB/s, la descarga podría interrumpirse. Asegúrese de contar con una conexión de red estable durante el proceso.
Si descarga archivos de copia de seguridad en un disco montado con ossfs, es posible que deba ajustar el parámetro multipart_size de ossfs. De forma predeterminada, este parámetro admite archivos de hasta 100 GB de tamaño. Si un archivo de copia de seguridad supera los 100 GB, la descarga presentará errores. Para obtener más información sobre ossfs y sus parámetros, consulte ossfs y Mount options.
Se recomienda utilizar los comandos wget y curl para descargar archivos de copia de seguridad. Si usa otras herramientas de terceros, podrían producirse descargas duplicadas, lo que significa que la cantidad de datos descargados será mayor que el tamaño del archivo de copia de seguridad. Además, se le cobrará por la transferencia de datos excedente, ya que la descarga utiliza tráfico de red pública.

wget

nohup wget -c -t 0 "backup_file_download_URL" -O /path/to/destination_filename > /path/to/download.log &

Parámetros

Parámetro	Descripción
nohup	Garantiza que la descarga continúe incluso si se cierra la terminal o se desconecta la sesión. El proceso finaliza automáticamente cuando termina la descarga.
-c	Habilita la descarga reanudable.
-t	Especifica el número de reintentos. Si este parámetro se establece en 0, el número de reintentos es ilimitado.
-O	Especifica la ruta de destino y el nombre del archivo descargado.

Ejemplo

nohup wget -c -t 0 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -O /backup/examplebackup.tar.gz > /tmp/download.log &

curl

nohup curl -C - --retry 10 "backup_file_download_URL" -o custom_filename > /path/to/download.log &

Parámetros

Parámetro	Descripción
nohup	Garantiza que la descarga continúe incluso si se cierra la terminal o se desconecta la sesión. El proceso finaliza automáticamente cuando termina la descarga.
-C -	Habilita automáticamente la descarga reanudable.
--retry	Especifica el número de reintentos. Si este parámetro se establece en 10, el comando reintenta 10 veces.
-o	Especifica la ruta de destino y el nombre del archivo descargado.

Ejemplo

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &

Fecha de lanzamiento

Facturación

Cargos de almacenamiento

Cargos por conversión del conjunto de copias de seguridad

Cargos por tráfico

Requisitos previos

Límites

Procedimiento

(Recomendado) Uso de la consola

(Recomendado) OSS

URL

Uso de una API

Preguntas frecuentes

Apéndice

Permisos de usuarios de RAM

Otorgar permisos de descarga a usuarios de RAM

Bloquear enlaces de descarga para usuarios de RAM

Permitir que los usuarios de solo lectura descarguen copias de seguridad

Comandos de descarga

wget

curl