Tous les produits
Search
Centre de documentation

Data Transmission Service:Migrer PolarDB-X 1,0 vers DataHub

Dernière mise à jour :Sep 17, 2026

Utilisez Data Transmission Service (DTS) pour migrer les données d'une instance PolarDB-X 1,0 vers un projet DataHub.

Prérequis

  • Vous avez créé une instance source PolarDB-X 1,0. Pour plus d'informations, consultez la rubrique Créer une instance PolarDB-X 1,0.

    Remarque

    L'instance PolarDB-X 1,0 doit utiliser ApsaraDB RDS for MySQL comme type de stockage. Cela inclut les instances RDS personnalisées en privé et celles achetées séparément. PolarDB for MySQL n'est pas pris en charge.

  • Vous avez activé DataHub et créé un projet pour recevoir les données migrées. Pour plus d'informations, consultez les rubriques Démarrage rapide (exemple de synchronisation) et Gérer les projets.

Limitations

Type

Description

Limitations de la base de données source

  • Si vous migrez des objets au niveau de la table et que vous devez les modifier, par exemple en mappant les noms de colonnes, une seule tâche de migration de données prend en charge un maximum de 1 000 tables. Si vous dépassez cette limite, la soumission de la tâche échoue. Dans ce cas, répartissez les tables sur plusieurs tâches de migration de données ou configurez une tâche pour migrer la base de données entière.

  • Pour la migration incrémentielle, les exigences suivantes s'appliquent aux journaux binaires :

    • Le journal binaire doit être activé et le paramètre binlog_row_image doit être défini sur full. Sinon, la prévérification échoue et la tâche de migration de données ne peut pas démarrer.

    • Si votre tâche inclut une migration incrémentielle, DTS exige que la base de données source conserve son journal binaire local pendant au moins 24 heures. Nous recommandons une période de rétention de 7 jours. Si la période de rétention est insuffisante, DTS peut ne pas parvenir à obtenir le journal binaire. Cela peut entraîner l'échec de la tâche et, dans les cas extrêmes, provoquer une incohérence ou une perte de données. Le SLA ne couvre pas les problèmes causés par une période de rétention du journal binaire inférieure à la durée requise.

  • DTS ne prend pas en charge la migration de données depuis les instances en lecture seule PolarDB-X 1,0.

  • Restrictions opérationnelles sur la base de données source :

    • Pendant la migration des données, n'effectuez pas d'opérations telles que le scaling vertical (montée ou descente en puissance), la migration de tables à fort trafic, la modification des clés de sharding ou l'exécution de modifications DDL ; cela entraînerait l'échec de la migration des données.

      Remarque

      Pendant la phase de migration complète des données, DTS interroge la base de données source ; cela génère des verrous de métadonnées, qui peuvent entraver l'exécution des opérations DDL sur la base de données source.

    • Pendant la migration complète et incrémentielle, DTS désactive temporairement les vérifications de contraintes et les opérations en cascade de clés étrangères au niveau de la session. Si des mises à jour ou des suppressions en cascade se produisent dans la base de données source pendant l'exécution de la tâche, une incohérence des données peut en résulter.

    • Si vous effectuez uniquement une migration complète des données, n'écrivez pas de nouvelles données dans la base de données source. Sinon, une incohérence des données surviendra entre les bases de données source et de destination. Pour maintenir la cohérence des données en temps réel, sélectionnez la migration du schéma, la migration complète des données et la migration incrémentielle des données.

  • L'instance source PolarDB-X 1,0 doit être en version 5.2 ou ultérieure.

  • Pendant l'exécution d'une tâche de migration DTS, les tables de diffusion (broadcast tables) dans l'instance source PolarDB-X 1,0 ne prennent pas en charge les modifications de leur type de table en cours de processus (par exemple, la conversion d'une table de diffusion en table unique ou en table shardée). Si vous devez modifier le type de table, arrêtez d'abord la tâche de migration et reconfigurez-la une fois la modification terminée.

Autres limitations

  • La migration du schéma, la migration complète et la migration incrémentielle sont prises en charge.

  • La longueur maximale d'un seul champ String dans DataHub cible est de 2 Mo.

  • DTS s'appuie sur la continuité des transactions XA au sein de l'instance source PolarDB-X 1,0 pour garantir la cohérence des données pour les tâches de migration incrémentielle. Si cette continuité est interrompue — par exemple, lors d'un basculement du module de capture des données incrémentielles — les transactions XA non validées peuvent être perdues.

  • Avant de migrer les données, évaluez les performances des bases de données source et cible. Nous vous recommandons également d'effectuer la migration des données pendant les heures creuses. Sinon, la charge de la base de données pourrait augmenter.

  • DTS tente de reprendre une tâche ayant échoué dans un délai de sept jours. Par conséquent, avant le basculement vers l'instance cible, vous devez terminer ou libérer la tâche. Vous pouvez également révoquer les autorisations d'écriture du compte utilisé par DTS pour accéder à l'instance cible à l'aide de la commande revoke. Cela empêche les données source d'écraser les données de l'instance cible si la tâche reprend automatiquement.

  • En cas d'échec d'une tâche, l'équipe support de DTS tentera de la restaurer dans un délai de huit heures. Lors de la restauration, elle peut redémarrer la tâche ou ajuster ses paramètres.

    Remarque

    Seuls les paramètres de tâche DTS sont modifiés, et non les paramètres de la base de données. Les paramètres susceptibles d'être ajustés incluent ceux répertoriés dans la rubrique Modifier les paramètres de l'instance.

Considérations supplémentaires

DTS met régulièrement à jour la table dts_health_check.ha_health_check dans la base de données source pour faire avancer la position du journal binaire.

Facturation

Type de migration

Frais de configuration de l'instance

Frais de trafic Internet

Migration du schéma

Gratuit.

Gratuit.

Migration incrémentielle

Des frais s'appliquent. Pour plus d'informations, consultez la rubrique Présentation de la facturation.

Types de migration

  • Migration du schéma

    DTS migre les définitions de schéma des objets de la base de données source vers la base de données de destination.

  • Migration incrémentielle

    DTS migre les modifications de données incrémentielles de la source vers la base de données de destination, permettant une migration fluide sans temps d'arrêt.

Opérations SQL prises en charge

Type d'opération

Instructions SQL

DML

INSERT, UPDATE, DELETE

Autorisations de compte

Base de données

Migration du schéma

Migration incrémentielle

Instance PolarDB-X 1,0

Autorisation SELECT

Autorisations de lecture et d'écriture pour les objets de migration.

Remarque

Pour savoir comment accorder des autorisations, consultez la rubrique Gérer les comptes.

Mappages de types de données

Pour plus d'informations, consultez la rubrique Mappages de types de données pour la migration de schéma.

Procédure

  1. Accédez à la page de liste des tâches de migration pour la région de destination en utilisant l'une des méthodes suivantes.

    Depuis la console DTS

    1. Connectez-vous à la console Data Transmission Service (DTS).

    2. Dans le volet de navigation de gauche, cliquez sur Data Migration.

    3. Dans le coin supérieur gauche de la page, sélectionnez la région où se trouve l'instance de migration.

    Depuis la console DMS

    Remarque

    Les opérations réelles peuvent varier selon le mode et la disposition de la console DMS. Pour plus d'informations, consultez les rubriques Console en mode simple et Personnaliser la disposition et le style de la console DMS.

    1. Connectez-vous à la console Data Management (DMS).

    2. Dans la barre de menu supérieure, choisissez Data + AI > Data Transmission (DTS) > Data Migration.

    3. À droite de Data Migration Tasks, sélectionnez la région où se trouve l'instance de migration.

  2. Cliquez sur Create Task pour accéder à la page de configuration de la tâche.

  3. Configurez les bases de données source et de destination.

    Avertissement

    Après avoir sélectionné les instances source et de destination, lisez les Limits en haut de la page pour vous assurer que la tâche de migration s'exécute avec succès.

    Catégorie

    Paramètre

    Description

    Paramètres de base

    Task Name

    DTS génère automatiquement un nom de tâche. Nous vous recommandons de spécifier un nom descriptif pour une identification facile. Le nom n'a pas besoin d'être unique.

    Source Database

    Select Existing Connection

    • Pour utiliser une instance de base de données qui a été ajoutée au système (créée ou enregistrée), sélectionnez l'instance de base de données souhaitée dans la liste déroulante. Les informations de la base de données ci-dessous seront configurées automatiquement.

      Remarque

      Dans la console DMS, ce paramètre est nommé Select a DMS database instance..

    • Si vous n'avez pas enregistré l'instance de base de données auprès du système, ou si vous n'avez pas besoin d'utiliser une instance enregistrée, configurez manuellement les informations de la base de données ci-dessous.

    Database Type

    Sélectionnez PolarDB-X 1.0.

    Access Method

    Sélectionnez Alibaba Cloud Instance.

    Instance Region

    Sélectionnez la région où se trouve l'instance source PolarDB-X 1,0.

    Replicate Data Across Alibaba Cloud Accounts

    Cet exemple utilise une migration au sein du même compte. Sélectionnez No.

    Instance ID

    Sélectionnez l'ID de l'instance source PolarDB-X 1,0.

    Database Account

    Saisissez le compte de base de données pour l'instance source PolarDB-X 1,0. Pour les exigences en matière d'autorisations, consultez la section Autorisations de compte.

    Database Password

    Saisissez le mot de passe du compte de base de données.

    Destination Database

    Select Existing Connection

    • Pour utiliser une instance de base de données qui a été ajoutée au système (créée ou enregistrée), sélectionnez l'instance de base de données souhaitée dans la liste déroulante. Les informations de la base de données ci-dessous seront configurées automatiquement.

      Remarque

      Dans la console DMS, ce paramètre est nommé Select a DMS database instance..

    • Si vous n'avez pas enregistré l'instance de base de données auprès du système, ou si vous n'avez pas besoin d'utiliser une instance enregistrée, configurez manuellement les informations de la base de données ci-dessous.

    Database Type

    Sélectionnez DataHub.

    Access Method

    Sélectionnez Alibaba Cloud Instance.

    Instance Region

    Sélectionnez la région où se trouve le projet DataHub de destination.

    Project

    Sélectionnez l'ID du projet DataHub de destination.

  4. Une fois la configuration terminée, cliquez sur Test Connectivity and Proceed en bas de la page.

    Remarque

    Assurez-vous que les plages d'adresses IP du service DTS sont ajoutées automatiquement ou manuellement aux paramètres de sécurité des bases de données source et de destination pour autoriser l'accès depuis les serveurs DTS. Pour plus d'informations, consultez la rubrique Ajouter les adresses IP des serveurs DTS à une liste blanche.

  5. Configurez les objets de la tâche.

    1. Sur la page Configure Objects, configurez les objets que vous souhaitez migrer.

      Paramètre

      Description

      Migration Types

      Lorsque vous migrez des données de PolarDB-X 1,0 vers DataHub, seuls les types Schema Migration et Incremental Data Migration sont pris en charge. Sélectionnez les types de migration selon vos besoins.

      Remarque
      • Si vous sélectionnez Schema Migration, les clés étrangères de la base de données source sont également migrées.

      • Pour garantir la cohérence des données, n'écrivez pas de nouvelles données dans l'instance source pendant la migration si vous ne sélectionnez pas Incremental Data Migration.

      Processing Mode for Existing Destination Tables

      • Precheck and Report Errors : Vérifie si une table portant le même nom existe dans la base de données de destination. Si aucune table de ce type n'existe, la prévérification est réussie. Si une table portant le même nom existe, la prévérification signale une erreur et la tâche de migration ne démarre pas.

        Remarque

        Si vous ne pouvez pas facilement supprimer ou renommer la table dans la base de données de destination, vous pouvez modifier son nom dans la base de données de destination. Pour plus d'informations, consultez la rubrique Mappage des noms de schéma, de table et de colonne.

      • Ignore Errors and Proceed : Ignore la vérification des tables portant le même nom dans la base de données de destination.

        Avertissement

        La sélection de l'option Ignore Errors and Proceed peut entraîner une incohérence des données et poser des risques pour votre activité, tels que :

        • Si les structures de table sont identiques et que les enregistrements partagent une clé primaire :

          Pendant la migration incrémentielle, Data Transmission Service (DTS) écrase l'enregistrement dans la base de données de destination avec l'enregistrement de la base de données source.

        • Si les structures de table sont différentes, seules certaines colonnes de données peuvent être migrées, ou la migration peut échouer. Agissez avec prudence.

      Naming Rules of Additional Columns

      DTS ajoute des colonnes supplémentaires aux tables de destination lors de la migration vers DataHub. Si ces noms de colonnes entrent en conflit avec des colonnes existantes, la migration échoue. Sélectionnez New Rule ou Previous Rule selon vos besoins.

      Avertissement

      Avant de sélectionner une règle, évaluez si des conflits de noms peuvent survenir entre les colonnes supplémentaires et vos colonnes existantes. Pour plus d'informations sur les règles et les définitions, consultez la rubrique Noms et définitions des colonnes supplémentaires.

      Capitalization of Object Names in Destination Instance

      Configurez la politique de mise en majuscules/minuscules pour les noms de base de données, de tables et de colonnes dans l'instance de destination. La politique DTS est utilisée par défaut. Vous pouvez également correspondre à la politique par défaut de la base de données source ou de destination. Pour plus d'informations, consultez la rubrique Mise en majuscules/minuscules des noms d'objets dans l'instance de destination.

      Source Objects

      Dans la zone Source Objects, cliquez sur les objets à migrer, puis cliquez sur Right arrow pour les déplacer vers la zone Selected Objects.

      Remarque

      Sélectionnez les objets à migrer au niveau de la table. Si vous sélectionnez une base de données entière, toutes les modifications consistant à ajouter ou supprimer des tables dans cette base de données ne seront pas migrées vers la destination.

      Selected Objects

      Remarque
      • L'utilisation de la fonctionnalité de mappage des noms d'objets peut entraîner l'échec de la migration des objets dépendants.

      • Pour filtrer les données à l'aide d'une clause WHERE, faites un clic droit sur une table dans la zone Selected Objects et spécifiez la condition de filtre dans la boîte de dialogue qui s'affiche. Pour plus d'informations, consultez la rubrique Définir des conditions de filtre.

      • Pour sélectionner les opérations SQL à migrer au niveau de la base de données ou de la table, faites un clic droit sur un objet dans la zone Selected Objects et choisissez les opérations souhaitées.

    2. Cliquez sur Next: Advanced Settings pour configurer les paramètres avancés.

      Paramètre

      Description

      Dedicated Cluster for Task Scheduling

      Par défaut, DTS planifie les tâches sur un cluster partagé. Vous n'avez pas besoin d'en sélectionner un. Si vous souhaitez des tâches plus stables, vous pouvez acheter un cluster dédié pour exécuter les tâches de migration DTS.

      Retry Time for Failed Connections

      Après le démarrage de la tâche de migration, si la connexion à la base de données source ou de destination échoue, DTS signale une erreur et commence immédiatement à retenter la connexion. La durée de nouvelle tentative par défaut est de 720 minutes. Vous pouvez personnaliser la durée de nouvelle tentative à une valeur comprise entre 10 et 1 440 minutes. Nous vous recommandons de définir la durée à plus de 30 minutes. Si DTS se reconnecte aux bases de données source et de destination dans la durée spécifiée, la tâche de migration reprend automatiquement. Sinon, la tâche échoue.

      Remarque
      • Pour plusieurs instances DTS partageant la même source ou la même destination, la durée de nouvelle tentative réseau est déterminée par le paramètre de la dernière tâche créée.

      • Étant donné que vous êtes facturé pour la tâche pendant la période de nouvelle tentative de connexion, nous vous recommandons de personnaliser la durée de nouvelle tentative en fonction de vos besoins commerciaux, ou de libérer l'instance DTS dès que possible après la libération des instances de base de données source et de destination.

      Retry Time for Other Issues

      Après le démarrage de la tâche de migration, si un problème autre qu'un problème de connectivité, tel qu'une exception d'exécution DDL ou DML, se produit dans la base de données source ou de destination, DTS signale une erreur et commence immédiatement à retenter l'opération. La durée de nouvelle tentative par défaut est de 10 minutes. Vous pouvez personnaliser la durée de nouvelle tentative à une valeur comprise entre 1 et 1 440 minutes. Nous vous recommandons de définir la durée à plus de 10 minutes. Si les opérations associées réussissent dans la durée de nouvelle tentative spécifiée, la tâche de migration reprend automatiquement. Sinon, la tâche échoue.

      Important

      La valeur de Retry Time for Other Issues doit être inférieure à la valeur de Retry Time for Failed Connections.

      Enable Throttling for Incremental Data Migration

      Si nécessaire, vous pouvez également choisir de définir des limites de vitesse pour la tâche de migration incrémentielle. Vous pouvez définir RPS of Incremental Data Migration et Data migration speed for incremental migration (MB/s) pour réduire la charge sur la base de données de destination.

      Remarque
      • Cet élément de configuration est disponible uniquement si vous sélectionnez Incremental Data Migration pour Migration Types.

      • Vous pouvez également ajuster la vitesse de migration incrémentielle une fois que l'instance de migration est en cours d'exécution.

      Environment Tag

      Sélectionnez un tag d'environnement pour identifier l'instance. Non requis pour ce tutoriel.

      Configure ETL

      Choisissez d'activer ou non la fonctionnalité extract, transform, and load (ETL). Pour plus d'informations, consultez la rubrique Qu'est-ce que l'ETL ? Valeurs valides :

      Monitoring and Alerting

      Sélectionnez si vous souhaitez définir des alertes et recevoir des notifications d'alerte en fonction de vos besoins commerciaux.

      • No : Ne définit pas d'alerte.

      • Yes : Configurez les alertes en définissant un seuil d'alerte et un notifications d'alerte. Si une migration échoue ou si la latence dépasse le seuil, le système envoie une notification d'alerte.

  6. Enregistrez la tâche et exécutez une prévérification.

    • Pour afficher les paramètres de configuration de cette instance lors de l'appel de l'opération API, placez le pointeur sur le bouton Next: Save Task Settings and Precheck et cliquez sur Preview OpenAPI parameters dans la bulle qui apparaît.

    • Si vous n'avez pas besoin d'afficher ou si vous avez terminé l'affichage des paramètres API, cliquez sur Next: Save Task Settings and Precheck en bas de la page.

    Remarque
    • Avant le démarrage de la tâche de migration, DTS effectue une prévérification. La tâche ne démarre qu'après avoir réussi la prévérification.

    • Si la prévérification échoue, cliquez sur View Details à côté de l'élément de vérification ayant échoué, corrigez le problème en suivant les instructions, puis relancez la prévérification.

    • Si un avertissement est signalé lors de la prévérification :

      • Pour les éléments de vérification qui ne peuvent pas être ignorés, cliquez sur View Details à côté de l'élément ayant échoué, corrigez le problème en suivant les instructions, puis relancez la prévérification.

      • Pour les éléments de vérification qui peuvent être ignorés, vous pouvez cliquer sur Confirm Alert Details, Ignore, OK, et Precheck Again pour ignorer l'élément d'avertissement et relancer la prévérification. Si vous choisissez d'ignorer un avertissement, cela peut entraîner des problèmes tels qu'une incohérence des données et poser des risques pour votre activité.

  7. Achetez l'instance de migration.

    1. Lorsque le Success Rate est de 100 %, cliquez sur Next: Purchase Instance.

    2. Sur la page Purchase, sélectionnez la spécification de lien pour l'instance de migration de données. Pour plus d'informations, consultez le tableau suivant.

      Catégorie

      Paramètre

      Description

      New Instance Class

      Resource Group Settings

      Sélectionnez le groupe de ressources auquel appartient l'instance. La valeur par défaut est le groupe de ressources par défaut. Pour plus d'informations, consultez la rubrique Qu'est-ce que la gestion des ressources ?

      Instance Class

      DTS propose des spécifications de migration avec différents niveaux de performance. La spécification de lien affecte la vitesse de migration. Vous pouvez sélectionner une spécification en fonction de votre scénario commercial. Pour plus d'informations, consultez la rubrique Spécifications de lien de migration de données.

    3. Une fois la configuration terminée, lisez et acceptez les Data Transmission Service (Pay-as-you-go) Service Terms.

    4. Cliquez sur Buy and Start. Dans la boîte de dialogue OK qui s'affiche, cliquez sur OK.

      Vous pouvez consulter la progression de la tâche de migration sur la page de liste Data Migration Tasks.

      Remarque
      • Si la tâche de migration n'inclut pas de migration incrémentielle, elle s'arrête automatiquement une fois la migration complète terminée. Une fois la tâche arrêtée, son Status passe à Completed.

      • Si la tâche de migration inclut une migration incrémentielle, elle ne s'arrête pas automatiquement. La tâche de migration incrémentielle continue de s'exécuter. Pendant l'exécution de la tâche de migration incrémentielle, le Status de la tâche est Running.