Tous les produits
Search

Ce produit

    PolarDB:Download backup files

    Centre de documentation

    PolarDB:Download backup files

    Dernière mise à jour :Oct 13, 2026

    PolarDB vous permet de télécharger des fichiers de sauvegarde depuis un ensemble de sauvegarde de cluster vers votre machine locale. Cette fonctionnalité est utile pour le stockage à long terme, l'interrogation de données historiques, le transfert de sauvegardes (par exemple vers OSS) et l'audit.

    Remarque

    Vous ne pouvez pas restaurer directement les données de sauvegarde téléchargées dans un cluster PolarDB for MySQL. Vous pouvez restaurer les fichiers de sauvegarde téléchargés dans une base de données MySQL autogérée.

    Date de publication

    24 novembre 2023

    Remarque

    La fonctionnalité de téléchargement de fichiers de sauvegarde est en version Canary et sera déployée progressivement.

    Facturation

    Vous pouvez télécharger des fichiers de sauvegarde via une URL (stockage temporaire dans DBS) ou les transférer vers votre OSS. Les frais varient selon la destination du téléchargement :

    Le téléchargement et la conversion des sauvegardes sont effectués côté service par DBS et ne consomment pas l'espace de stockage du cluster PolarDB. Les données de sauvegarde sont stockées dans un système de sauvegarde indépendant, séparé du stockage local du cluster. Aucun espace de stockage supplémentaire n'est nécessaire.

    Remarque

    • Aucun frais n'est facturé si une tâche de téléchargement échoue.

    • Dans la console PolarDB, accédez à Settings and Management > Backup and Restoration > Backup Download List pour votre cluster afin de consulter le monthly backup conversion volume et le monthly outbound internet traffic.

    Frais de stockage

    • URL : Les fichiers sont temporairement stockés dans le stockage intégré de DBS. Aucun frais de stockage n'est facturé.

    • OSS : Les fichiers sont transférés vers votre compartiment OSS. Pour plus d'informations sur les frais de stockage OSS, consultez Frais de stockage OSS.

    Frais de conversion des ensembles de sauvegarde

    La conversion d'un ensemble de sauvegarde aux formats SQL, CSV, Parquet ou CSV-with-header entraîne des frais de conversion, que la destination soit une URL ou OSS. Aucun quota gratuit n'est disponible pour cette conversion. Le prix est de 0,03125 USD par Go.

    Frais de trafic

    • URL :

      • Téléchargement via un réseau interne : Gratuit.

      • Téléchargement via Internet : Un quota gratuit de 500 Go par cluster et par mois est fourni. Le transfert de données dépassant ce quota gratuit est facturé selon le modèle de paiement à l'utilisation. Les frais sont calculés quotidiennement en fonction du volume de données téléchargé. Pour plus d'informations sur les tarifs, consultez Frais réseau.

      Remarque

      Nous vous recommandons d'acheter un plan de transfert de données par abonnement pour couvrir les frais de trafic réseau liés au téléchargement des sauvegardes via Internet. Plus la capacité du plan de transfert de données est importante, plus la remise est élevée.

    • OSS : Les fichiers sont transférés vers votre compartiment OSS. Pour plus d'informations sur les frais de trafic, consultez Frais de trafic OSS.

    Prérequis

    • Cluster : Cette fonctionnalité est disponible uniquement pour l'édition Settings and Management des clusters Enterprise Edition.

    • Région : Chine (Chengdu), Chine (Guangzhou), Chine (Qingdao), Chine (Beijing), Chine (Shanghai), Chine (Zhangjiakou), Chine (Hangzhou), Chine (Shenzhen), Chine (Hong Kong), Malaisie (Kuala Lumpur), Indonésie (Jakarta), Japon (Tokyo), Singapour, États-Unis (Silicon Valley), États-Unis (Virginie) et Allemagne (Francfort).

      Remarque

      Cette fonctionnalité sera bientôt disponible dans d'autres régions.

    • Autres :

      • L'utilisateur RAM doit disposer des autorisations nécessaires pour télécharger des fichiers de sauvegarde. Pour accorder des autorisations à un utilisateur RAM, consultez Autorisations des utilisateurs RAM.

      • Les données de sauvegarde ne sont pas chiffrées. Vous ne pouvez pas télécharger de fichiers de sauvegarde depuis des clusters PolarDB chiffrés.

      • Une seule tâche de téléchargement (en cours d'exécution ou ayant échoué) est autorisée par cluster ou instance à la fois.

    Limites

    • Le processus de téléchargement exporte la plupart, mais pas la totalité, des structures de table :

      • Éléments pris en charge pour l'exportation : informations sur les colonnes, index de clé primaire, index non primaires, index uniques, informations sur les tables partitionnées, moteurs de table, ainsi que jeux de caractères et collations au niveau de la table ou de la base de données.

      • Éléments non pris en charge pour l'exportation : index d'expression, clés étrangères, colonnes générées, colonnes masquées, vues, fonctions, procédures stockées, variables système et déclencheurs.

    • Les tâches de conversion échoueront si vos données incluent des champs avec les types de données spatiales suivants :

      GEOMETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION

    • Les fichiers exportés n'incluent pas les bases de données système suivantes :

      information_schema, mysql, performance_schema, sys, __recycle_bin__

    • Si vous sélectionnez OSS comme destination de téléchargement, la classe de stockage du compartiment OSS doit être Backup and Restoration. Pour modifier la classe de stockage, consultez Convertir les classes de stockage.

      Remarque

      Vous devez créer manuellement un compartiment OSS. Vous pouvez ignorer cette étape si vous avez déjà créé un compartiment pour stocker les fichiers de sauvegarde.

    • Vous pouvez télécharger des données uniquement à partir d'une sauvegarde de niveau 1. Les données d'une sauvegarde de niveau 2 ne peuvent pas être téléchargées.

    • Si l'archivage des données froides est activé pour le cluster, vous ne pouvez pas télécharger un ensemble de sauvegarde.

    • Si les noms des bases de données ou des tables à télécharger contiennent des barres obliques (/), la tâche de téléchargement échoue.

    Procédure

    (Recommandé) Utiliser la console

    1. Connectez-vous à la console PolarDB. Dans le volet de navigation de gauche, cliquez sur Clusters. Sélectionnez la région où se trouve le cluster, puis cliquez sur l'ID du cluster pour accéder à la page des détails du cluster.

    2. Dans le volet de navigation de gauche, cliquez sur Backup Download List > monthly backup conversion volume.

    3. Sous l'onglet monthly outbound internet traffic, repérez l'ensemble de sauvegarde cible et cliquez sur Cluster Edition dans la colonne Standard.

      Remarque

      • Par défaut, la console affiche les sauvegardes des huit derniers jours. Pour consulter des sauvegardes plus anciennes, vous devez modifier la plage de temps.

      • Si le bouton Clusters n'apparaît pas, vérifiez que la version du produit ou la région de votre cluster respecte les prérequis.

    4. À l'étape Settings and Management, sélectionnez Backup and Restoration ou Data Backups, puis cliquez sur Download Cluster Backup .

      Si vous choisissez By Backup Set, sélectionnez un ensemble de sauvegarde cible dans la liste déroulante Backup Set.

    5. À l'étape Actions, cliquez sur Download Cluster Backup . L'option Point in Time and Backup Set est présélectionnée et ne peut pas être modifiée.

    6. À l'étape Download by Point in Time, sélectionnez la destination et le format de téléchargement, puis finalisez la configuration.

      Important

      • Nous vous recommandons de choisir OSS comme destination de téléchargement pour gagner du temps.

      • Une tâche de téléchargement de sauvegarde ne peut pas être annulée une fois lancée.

      • Les tâches de téléchargement de sauvegarde sont facturées. Pour plus d'informations, consultez la section Facturation.

      (Recommandé) OSS

      Si vous sélectionnez OSS comme destination de téléchargement, les données sont écrites directement dans votre bucket OSS. Vous pouvez supprimer ces données selon vos besoins une fois le téléchargement terminé.

      1. Pour utiliser OSS comme destination de téléchargement, assurez-vous qu'OSS est activé et que vous avez créé un bucket de classe Standard dans la même région que l'instance RDS.

      2. Saisissez le nom de votre bucket OSS et un préfixe de répertoire, par exemple xx/xx.

        Remarque

        • Vous devez créer manuellement un bucket OSS. Si vous avez déjà créé un bucket pour stocker les fichiers de sauvegarde, vous pouvez saisir son nom directement.

        • La classe de stockage du bucket OSS doit être Standard. Pour modifier la classe de stockage, consultez Convertir les classes de stockage.

      3. Sélectionnez un format de téléchargement. Vous pouvez définir le format sur CSV, SQL, Parquet ou CSV-with-header. Choisissez le format adapté à vos besoins métier.

      4. Lisez et acceptez les conditions, puis cliquez sur Download by Backup Set. Vous êtes redirigé vers l'onglet Next. Attendez que la tâche de téléchargement soit terminée.

        Remarque

        • La fonctionnalité de téléchargement de sauvegarde nécessite que DBS soit autorisé à accéder à vos ressources cloud. Lors de la première utilisation, vous devez compléter l'autorisation du service DBS (rôle AliyunDBSDefaultRole) et effectuer la vérification MFA comme indiqué sur la page. Si vous n'avez pas accordé les autorisations d'accès, suivez les instructions de la console pour cliquer sur Instance, Database, and Table > Next. Une fois l'autorisation réussie, vous pouvez revenir à la page de configuration avancée du téléchargement et saisir les informations requises comme décrit dans les étapes précédentes.

        • La conversion de format consomme beaucoup de ressources. Un téléchargement peut échouer si les ressources du serveur sont temporairement indisponibles. Des formats de données spéciaux non pris en charge peuvent également provoquer des échecs de téléchargement. En cas d'échec d'une tâche, nous vous recommandons de relancer la tâche de téléchargement ou de contacter le support technique DBS.

        • Aucun frais n'est facturé pour les tâches ayant échoué.

      5. Après la soumission d'une tâche de téléchargement, celle-ci passe par les états Resource Queuing et Running, puis bascule vers Success ou Failure une fois la conversion terminée. Lorsque le statut de la tâche devient Instance Download, vous pouvez visualiser le fichier de sauvegarde dans le bucket OSS correspondant.

      URL

      Si vous sélectionnez URL comme destination de téléchargement, le système stocke temporairement les données converties dans le stockage intégré de DBS. Aucun frais de stockage n'est facturé pour ce processus.

      Remarque

      Le téléchargement via une URL implique un empaquetage des données, ce qui prend du temps supplémentaire. La durée requise dépend de la taille logique de l'ensemble de sauvegarde. Si l'ensemble de sauvegarde est volumineux (par exemple, supérieur à 1 To), nous vous recommandons de télécharger vers OSS.

      1. Sélectionnez un format de téléchargement. Vous pouvez définir le format sur CSV, SQL, Parquet ou CSV-with-header. Choisissez le format adapté à vos besoins métier.

      2. Lisez et acceptez les conditions, puis cliquez sur Destination and Format. Vous êtes redirigé vers l'onglet Standard. Attendez que la tâche de téléchargement soit terminée.

        Remarque

        • La fonctionnalité de téléchargement de sauvegarde nécessite que DBS soit autorisé à accéder à vos ressources cloud. Lors de la première utilisation, vous devez compléter l'autorisation du service DBS (rôle AliyunDBSDefaultRole) et effectuer la vérification MFA comme indiqué sur la page. Si vous n'avez pas accordé les autorisations d'accès, suivez les instructions de la console pour cliquer sur Complete > Backup Download List. Une fois l'autorisation réussie, vous pouvez revenir à la page de configuration avancée du téléchargement et saisir les informations requises comme décrit dans les étapes précédentes.

        • La conversion de format consomme beaucoup de ressources. Un téléchargement peut échouer si les ressources du serveur sont temporairement indisponibles. Des formats de données spéciaux non pris en charge peuvent également provoquer des échecs de téléchargement. En cas d'échec d'une tâche, nous vous recommandons de relancer la tâche de téléchargement ou de contacter le support technique DBS.

        • Aucun frais n'est facturé pour les tâches ayant échoué.

      3. Visualisez le fichier de sauvegarde : après la soumission d'une tâche de téléchargement, celle-ci passe par les états Resource Queuing et Running, puis bascule vers Success ou Failure une fois la conversion terminée. Si le statut de la tâche de téléchargement est Authorize, le téléchargement est terminé. Dans la colonne Submit, cliquez sur Successful, définissez la Complete, puis cliquez sur Backup Download List. Vous pouvez ensuite utiliser l'URL interne ou publique générée pour télécharger les données de sauvegarde.

        Remarque

        • Vous pouvez obtenir le lien de téléchargement dans les trois jours suivant la fin de la tâche. La période de validité du lien peut être définie entre 5 minutes et 1 jour. La période de validité par défaut est de 2 heures.

        • Les tâches terminées expirent après trois jours, moment auquel le lien de téléchargement expire également. Les données d'une tâche expirée sont automatiquement supprimées après expiration. Si vous avez toujours besoin des données, vous devez lancer une nouvelle tâche de téléchargement pour obtenir un nouveau lien.

        • Enregistrez le lien de téléchargement et gardez-le confidentiel pour éviter toute fuite de données.

        • L'utilisation d'outils de téléchargement tiers peut entraîner un trafic de téléchargement supplémentaire et générer des frais supplémentaires. Utilisez ces outils avec prudence. Pour plus d'informations sur les méthodes de téléchargement recommandées, consultez Commandes de téléchargement.

    Utiliser une API

    1. DescribeDownloadSupport : interroge si votre cluster prend en charge la fonctionnalité de téléchargement de fichiers de sauvegarde.

      Remarque

      Si la réponse de l'API indique que la fonctionnalité n'est pas prise en charge, vérifiez que la version du produit et la région de votre cluster respectent les prérequis.

    2. CreateDownload : crée une tâche de téléchargement de fichier de sauvegarde.

      Remarque

      • La fonctionnalité de téléchargement de sauvegarde nécessite d'accorder à DBS les autorisations AliyunDBSDefaultRole pour accéder à vos ressources cloud. Si vous n'avez pas accordé ces autorisations, vous pouvez d'abord les accorder via la console.

      • Lorsque TargetType (type de destination de téléchargement) est OSS, vous devez d'abord créer manuellement le bucket de destination et vous assurer que sa classe de stockage est Standard.

      • Lorsque TargetType (type de destination de téléchargement) est URL, vous devez enregistrer l'identifiant de tâche (TaskId) renvoyé pour récupérer le lien de téléchargement.

      • Une tâche de téléchargement de sauvegarde ne peut pas être annulée une fois lancée.

      • Les tâches de téléchargement de sauvegarde sont facturées. Pour plus d'informations, consultez la section Facturation.

    3. (Facultatif) DescribeDownloadTask : consultez le statut et d'autres détails des tâches de téléchargement de sauvegarde de votre cluster.

    4. Obtenez le fichier de sauvegarde :

      • Si la destination de téléchargement est OSS, le système écrit les données directement dans votre bucket OSS, où vous pouvez les visualiser.

      • Si la destination de téléchargement est une URL, vous pouvez appeler l'opération DescribeDownloadBackupSetStorageInfo pour obtenir le lien de téléchargement.

        Remarque

        • Vous pouvez obtenir le lien de téléchargement dans les trois jours suivant la fin de la tâche. La période de validité du lien peut être définie entre 5 minutes et 1 jour. La période de validité par défaut est de 2 heures.

        • Les tâches terminées expirent après trois jours, moment auquel le lien de téléchargement expire également. Les données d'une tâche expirée sont automatiquement supprimées après expiration. Si vous avez toujours besoin des données, vous devez lancer une nouvelle tâche de téléchargement pour obtenir un nouveau lien.

        • Enregistrez le lien de téléchargement et gardez-le confidentiel pour éviter toute fuite de données.

        • L'utilisation d'outils de téléchargement tiers peut entraîner un trafic de téléchargement supplémentaire et générer des frais supplémentaires. Utilisez ces outils avec prudence. Pour plus d'informations sur les méthodes de téléchargement recommandées, consultez Commandes de téléchargement.

    FAQ

    Puis-je annuler une tâche de téléchargement de sauvegarde en cours ?

    Non. Il est impossible d'annuler une tâche de téléchargement une fois celle-ci lancée.

    Comment utiliser les fichiers de sauvegarde des données et des journaux téléchargés ?

    Vous pouvez restaurer les fichiers de sauvegarde téléchargés dans une base de données MySQL autogérée.

    Pourquoi l'erreur ERROR 1148 (42000): The used command is not allowed with this MySQL version s'affiche-t-elle lors de la restauration d'un fichier de sauvegarde téléchargé dans une base de données MySQL locale ?

    Exécutez la requête show variables like 'local_infile'; sur votre base de données MySQL. Si le résultat est OFF, exécutez l'instruction suivante pour activer l'importation de fichiers : set global local_infile = 1;. Exécutez ensuite à nouveau le script d'importation.

    Pourquoi la taille de la sauvegarde affichée dans la console diffère-t-elle de la taille réelle du fichier de sauvegarde téléchargé ?

    Les fichiers de sauvegarde téléchargés sont compressés et généralement plus petits que la taille indiquée dans la console. Le taux de compression dépend du type et du contenu des données ; il n'existe pas de valeur fixe. Pour estimer la taille du téléchargement à l'avance, connectez-vous à la console PolarDB, puis accédez à Authorize > Submit > Successful pour votre cluster afin de consulter le monthly backup conversion volume. Vous pouvez restaurer le fichier pour vérifier l'intégrité des données.

    Puis-je restaurer directement un fichier de sauvegarde téléchargé vers un autre cluster PolarDB ?

    Non, vous ne pouvez pas restaurer directement un fichier de sauvegarde téléchargé vers un autre cluster PolarDB . Vous devez d'abord restaurer le fichier de sauvegarde dans une base de données MySQL autogérée, puis utiliser Data Transmission Service (DTS) pour migrer les données de la base de données MySQL autogérée vers PolarDB for MySQL.

    Annexe

    Autorisations des utilisateurs RAM

    Cette fonctionnalité utilise RAM pour gérer les autorisations. Configurez ces dernières afin de contrôler quels utilisateurs RAM peuvent obtenir les liens de téléchargement.

    Accorder l'autorisation de téléchargement aux utilisateurs RAM

    Si vous ne parvenez pas à utiliser la fonctionnalité de téléchargement de sauvegarde (par exemple, si vous ne pouvez pas créer ou interroger des tâches de téléchargement), vérifiez que votre utilisateur RAM dispose des autorisations de gestion pour la reprise après sinistre des données (AliyunDBSFullAccess). Pour plus d'informations sur l'attribution des autorisations, consultez la rubrique Gérer les autorisations des utilisateurs RAM.

    Bloquer les liens de téléchargement pour les utilisateurs RAM

    Si un utilisateur RAM doit disposer des autorisations nécessaires pour utiliser les fonctionnalités de sauvegarde et de restauration, mais qu'il faut l'empêcher d'obtenir les liens de téléchargement des fichiers de sauvegarde, vous pouvez créer une stratégie personnalisée afin de refuser à cet utilisateur l'autorisation d'appeler l'opération API qui récupère les liens de téléchargement. Le script suivant illustre un exemple de stratégie :

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

    Après avoir créé la stratégie personnalisée, attachez cette stratégie à l'utilisateur RAM. Ce dernier sera alors bloqué et ne pourra pas obtenir les liens de téléchargement.

    Autoriser les utilisateurs en lecture seule à télécharger des sauvegardes

    Pour des raisons de sécurité, un utilisateur RAM disposant uniquement des autorisations en lecture seule pour PolarDB (AliyunPolardbReadOnlyAccess) ne peut pas télécharger de fichiers de sauvegarde.

    Dans ce cas, si l'utilisateur RAM a besoin d'autorisations pour télécharger des fichiers de sauvegarde, accordez-lui les autorisations en lecture seule pour la reprise après sinistre des données (AliyunDBSReadOnlyAccess). Une fois cette autorisation accordée, l'utilisateur RAM peut afficher les liens de téléchargement pour les tâches de sauvegarde terminées. Pour plus d'informations sur l'attribution des autorisations, consultez la rubrique Gérer les autorisations des utilisateurs RAM.

    Commandes de téléchargement

    Remarque

    • Si la vitesse de téléchargement est inférieure à 64 Ko/s, le téléchargement risque d'être interrompu. Assurez-vous de disposer d'une connexion réseau stable pendant l'opération.

    • Si vous téléchargez des fichiers de sauvegarde sur un disque monté avec ossfs, vous devrez peut-être ajuster le paramètre multipart_size pour ossfs. Par défaut, ce paramètre prend en charge les fichiers jusqu'à 100 Go. Si un fichier de sauvegarde dépasse 100 Go, le téléchargement échoue. Pour plus d'informations sur ossfs et ses paramètres, consultez les rubriques ossfs et Options de montage.

    • Nous vous recommandons d'utiliser les commandes wget et curl pour télécharger les fichiers de sauvegarde. L'utilisation d'autres outils tiers peut entraîner des téléchargements en double, ce qui signifie que la quantité de données téléchargées est supérieure à la taille du fichier de sauvegarde. Vous serez également facturé pour le transfert de données excédentaire, car le téléchargement utilise le trafic du réseau public.

    wget

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

    Paramètres

    Paramètre

    Description

    nohup

    Garantit que le téléchargement se poursuit même si le terminal est fermé ou si la session est déconnectée. Le processus se termine automatiquement une fois le téléchargement terminé.

    -c

    Active la reprise du téléchargement.

    -t

    Spécifie le nombre de tentatives. Si ce paramètre est défini sur 0, le nombre de tentatives est illimité.

    -O

    Spécifie le chemin de destination et le nom de fichier pour le fichier téléchargé.

    Exemple

    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 &

    Paramètres

    Paramètre

    Description

    nohup

    Garantit que le téléchargement se poursuit même si le terminal est fermé ou si la session est déconnectée. Le processus se termine automatiquement une fois le téléchargement terminé.

    -C -

    Active automatiquement la reprise du téléchargement.

    --retry

    Spécifie le nombre de tentatives. Si ce paramètre est défini sur 10, la commande effectue 10 tentatives.

    -o

    Spécifie le chemin de destination et le nom de fichier pour le fichier téléchargé.

    Exemple

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