Tous les produits
Search
Centre de documentation

Data Transmission Service:AnalyticDB for PostgreSQL vers Message Queue for Kafka

Dernière mise à jour :Oct 12, 2026

Vous pouvez utiliser DTS pour diffuser en continu les données des instances AnalyticDB for PostgreSQL vers Message Queue for Apache Kafka.

Remarque

Cette fonctionnalité est en version bêta. Pour l'utiliser, veuillez Submit a ticket afin de demander l'accès.

Périmètre

  • Vous devez créer un topic dans l'instance Message Queue for Apache Kafka cible pour recevoir les données synchronisées. Pour plus d'informations, consultez la rubrique Étape 1 : Créer un topic.

  • L'instance Message Queue for Apache Kafka cible doit disposer d'un espace de stockage supérieur à celui utilisé par l'instance source AnalyticDB for PostgreSQL.

Remarques sur l'utilisation

Restrictions liées à la source

Type

Limits

Before synchronization

  • Bandwidth requirements: To ensure synchronization speed, make sure the outbound bandwidth of the source database server is at least 100 Mb/s.

  • Kernel version: The kernel version of the source AnalyticDB for PostgreSQL instance must be 7.2.1.4 or later.

  • Parameter settings:

    • Logical replication: Enable logical replication. Set the wal_level parameter to logical.

    • High-availability settings: If the source instance is a High-availability Edition, set the hot_standby, hot_standby_feedback, and sync_replication_slots parameters to on to prevent synchronization interruptions during a primary/standby switchover.

  • Account permissions: The synchronization account must have read permissions on the objects to be synchronized and the REPLICATION permission. To grant this permission, run the command: ALTER USER your_user WITH REPLICATION;.

  • Impact of long-running transactions: During incremental synchronization, uncommitted long-running transactions in the source database can cause the write-ahead log (WAL) to accumulate and fill up the disk space.

  • Object limits:

    • Naming conventions: The name of the database to be synchronized cannot contain a hyphen (-), such as dts-testdata.

    • Primary key or UNIQUE constraint: Tables to be synchronized must have a primary key or a UNIQUE constraint. The values in the constrained fields must be unique. Otherwise, duplicate data may appear in the destination database.

    • Partitioned tables: The structure of partitioned tables cannot be synchronized. After a partitioned table is synchronized, its partition information is lost. The table is created as a non-partitioned table in the destination database by default.

    • Number of databases per task: A single sync task can synchronize only one database. To synchronize multiple databases, create a separate sync task for each database.

    • Task configuration scale: To edit more than 5 000 tables in a task, such as for column name mapping, create multiple tasks in batches or configure synchronization for the entire database. This helps avoid request errors when you submit the task.

    • Unsupported object types: DTS does not support synchronizing tables that inherit across schemas, temporary tables, internal system triggers, some functions (C-language and internal functions for PROCEDURE and FUNCTION), and extensions (EXTENSION).

    • Supported object types: DTS supports synchronizing primary keys, UNIQUE constraints, CHECK constraints, and some custom data types (COMPOSITE, ENUM, and RANGE).

During synchronization

  • DDL operation limits: During the schema synchronization and full synchronization phases, do not perform DDL operations that change the database or table structure. Otherwise, the data synchronization task fails.

    Remarque

    During the full synchronization phase, DTS queries the source database. This creates a metadata lock, which can block DDL operations on the source database.

  • DDL synchronization support: DTS does not currently support synchronizing DDL operations from the source database. After a DTS task starts, new tables created in the source and their subsequent data changes are not synchronized to the destination. If needed, create a new sync task.

  • Connection information changes: While the task is running, do not change the connection address or zone of the AnalyticDB for PostgreSQL instance. Otherwise, the sync task fails.

Restrictions liées à la destination

Type

Limits

Before synchronization

  • Performance impact assessment: Full synchronization consumes read and write resources on both the source and destination databases, which can increase the database load. Run sync tasks during off-peak hours, for example, when the CPU load is below 30 %.

  • Single message size: Kafka limits the size of a single message to 10 MB. If a single row of data from the source database exceeds this limit after transformation, the task is interrupted. When you configure the task, filter out columns that contain large objects. If the task is already running, modify the synchronization objects. Remove the table, then add it back and filter out the columns with large objects to prevent them from being synchronized.

During synchronization

  • Destination cluster scaling: If the destination Kafka cluster is scaled out or in while the task is running, such as by adding or removing broker nodes, you must restart the DTS sync task for the changes to take effect.

  • External data writes: To ensure data consistency, do not write data from outside the DTS task to the destination Kafka cluster during synchronization. This can cause data inconsistency or task failure.

  • Storage space growth: During full synchronization, DTS performs concurrent write operations, which can cause data fragmentation at the destination. After synchronization, the storage space used at the destination might be larger than at the source.

  • Task restart behavior: For tasks that include both full and incremental synchronization, restarting the task might re-run the full synchronization phase.

  • Instance failure:

    • Recovery mechanism: DTS helpdesk will try to recover the instance within 8 hours. During recovery, the instance might be restarted or the DTS task parameters might be adjusted. Your database parameters will not be modified.

    • Data overwrite risk: After you switch your business to the destination database, promptly stop or release sync tasks that are no longer needed. This prevents accidental data overwrites in the destination database caused by automatic recovery.

Supported synchronization SQL

INSERT, UPDATE, and DELETE.

Supported synchronization objects

  • Basic objects: SCHEMA, TABLE

    Remarque

    Includes PRIMARY KEY, UNIQUE KEY, DATATYPE (built-in data types), and DEFAULT CONSTRAINT.

  • Other objects: VIEW, INDEX, PROCEDURE, FUNCTION, RULE, SEQUENCE, AGGREGATE, OPERATOR, and DOMAIN.

Tarification

Synchronization type

Fees

Synchronisation du schéma et synchronisation complète

Gratuit.

Synchronisation incrémentielle

Des frais s'appliquent. Consultez la rubrique billing overview.

Procédure

  1. Accédez à la page de liste des tâches de synchronisation de la région de destination. Vous pouvez utiliser l'une des deux méthodes suivantes :

    Depuis la console DTS

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

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

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

    Depuis la console DMS

    Remarque

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

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

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

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

  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.

    Catégorie

    Paramètre

    Description

    N/A

    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 est ajoutée au système (nouvellement créée ou enregistrée), sélectionnez l'instance de base de données dans la liste déroulante. Les informations de la base de données sont configurées automatiquement.

      Remarque

      Dans la console DMS, cet élément de configuration est nommé Select a DMS database instance..

    • Si vous n'avez pas ajouté l'instance de base de données au système, ou si vous n'avez pas besoin d'utiliser une instance déjà ajoutée, configurez manuellement les informations de base de données suivantes.

    Database Type

    Sélectionnez AnalyticDB for PostgreSQL.

    Access Method

    Sélectionnez Alibaba Cloud Instance.

    Instance Region

    Sélectionnez la région de l'instance AnalyticDB for PostgreSQL source.

    Replicate Data Across Alibaba Cloud Accounts

    Dans cet exemple, les données sont synchronisées au sein du même compte Alibaba Cloud. Sélectionnez No.

    Instance ID

    Sélectionnez l'ID de l'instance AnalyticDB for PostgreSQL source.

    Database Name

    Saisissez le nom de la base de données source à synchroniser.

    Database Account

    Saisissez le compte de base de données de l'instance AnalyticDB for PostgreSQL source. Le compte doit disposer des autorisations de lecture sur les objets à synchroniser.

    Database Password

    Saisissez le mot de passe correspondant au compte de base de données.

    Destination Database

    Select Existing Connection

    • Pour utiliser une instance de base de données qui est ajoutée au système (nouvellement créée ou enregistrée), sélectionnez l'instance de base de données dans la liste déroulante. Les informations de la base de données sont configurées automatiquement.

      Remarque

      Dans la console DMS, cet élément de configuration est nommé Select a DMS database instance..

    • Si vous n'avez pas ajouté l'instance de base de données au système, ou si vous n'avez pas besoin d'utiliser une instance déjà ajoutée, configurez manuellement les informations de base de données suivantes.

    Database Type

    Sélectionnez Kafka.

    Access Method

    Sélectionnez Alibaba Cloud Instance.

    Instance Region

    Sélectionnez la région de l'instance Message Queue for Apache Kafka cible.

    Kafka Instance ID

    Sélectionnez l'ID de l'instance Message Queue for Apache Kafka cible.

    Encryption

    En fonction de vos exigences métier et de sécurité, sélectionnez Non-encrypted ou SCRAM-SHA-256.

    Topic

    Sélectionnez le topic qui recevra les données synchronisées.

    Use Kafka Schema Registry

    Kafka Schema Registry fournit une interface REST pour stocker et récupérer les schémas Avro.

    • No : N'utilise pas Kafka Schema Registry.

    • Yes : Utilise Kafka Schema Registry. Vous devez saisir l'URL ou l'adresse IP où le schéma Avro est enregistré dans Kafka Schema Registry.

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

    Remarque
    • Assurez-vous que les plages CIDR des adresses IP des serveurs DTS sont ajoutées aux paramètres de sécurité des bases de données source et de destination pour autoriser l'accès depuis les serveurs DTS. Cette opération peut être effectuée automatiquement ou manuellement. Pour plus d'informations, consultez la rubrique Ajouter les plages CIDR des adresses IP des serveurs DTS à une liste d'autorisation.

    • Si la base de données source ou de destination est une base de données autogérée (où la méthode Access Method n'est pas Alibaba Cloud Instance), vous devez également cliquer sur Test Connectivity dans la boîte de dialogue CIDR Blocks of DTS Servers.

  5. Configurez les objets de la tâche.

    1. Sur la page Configure Objects, configurez les objets à synchroniser.

      Paramètre

      Description

      Synchronization Types

      Incremental Data Synchronization est sélectionné. Par défaut, vous devez également sélectionner Schema Synchronization et Full Data Synchronization. Une fois la vérification préalable terminée, DTS effectue une synchronisation complète des données des objets sélectionnés depuis l'instance source vers le cluster de destination. Cela sert de données de base pour la synchronisation incrémentielle ultérieure.

      Remarque

      Lorsque la Access Method de l'instance Kafka cible est définie sur Alibaba Cloud Instance, la Schema Synchronization n'est pas prise en charge.

      Processing Mode of Conflicting 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 du même nom n'existe, la vérification préalable réussit. Si une table du même nom existe, la vérification préalable échoue et la tâche de synchronisation des données ne démarre pas.

        Remarque

        Si vous ne pouvez pas supprimer ou renommer la table portant le même nom dans la base de données de destination, vous pouvez la mapper vers un nom de table différent. Pour plus d'informations, consultez Map table and column names.

      • Ignore Errors and Proceed : ignore la vérification des noms de tables en double 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 mettre votre activité à risque. Par exemple :

        • Si les schémas de table sont identiques et qu'un enregistrement de la base de données de destination possède la même valeur de clé primaire ou de clé unique qu'un enregistrement de la base de données source :

          • Pendant la synchronisation complète, DTS conserve l'enregistrement dans le cluster de destination. L'enregistrement correspondant de la base de données source n'est pas synchronisé.

          • Pendant la synchronisation incrémentielle, l'enregistrement de la base de données source écrase l'enregistrement de la base de données de destination.

        • Si les schémas de table sont différents, la synchronisation initiale des données peut échouer. Cela peut entraîner la synchronisation partielle des données de colonne ou un échec complet de la synchronisation. Procédez avec prudence.

      Data Format in Kafka

      Sélectionnez le format de stockage des données synchronisées vers l'instance Kafka.

      Kafka Data Compression Format

      Sélectionnez un format de compression pour les messages Kafka.

      • LZ4 (par défaut) : faible taux de compression, vitesse de compression élevée.

      • GZIP : taux de compression élevé, vitesse de compression faible.

        Remarque

        Ce format entraîne une forte consommation de CPU.

      • Snappy : taux de compression moyen, vitesse de compression moyenne.

      Policy for Shipping Data to Kafka Partitions

      Sélectionnez une stratégie en fonction de vos besoins métier.

      Message acknowledgement mechanism

      Sélectionnez un mécanisme d'accusé de réception des messages en fonction de vos besoins métier.

      Topic That Stores DDL Information

      Sélectionnez le topic pour le stockage des informations DDL.

      Remarque

      Si vous ne sélectionnez aucun topic, les informations DDL sont stockées par défaut dans le topic de réception des données.

      Capitalization of Object Names in Destination Instance

      Vous pouvez configurer la politique de sensibilité à la casse pour les noms d'objets de base de données, de tables et de colonnes qui sont synchronisés vers l'instance de destination. Par défaut, la DTS default policy est sélectionnée. Vous pouvez également choisir d'utiliser les politiques par défaut des bases de données source et de destination. Pour plus d'informations, consultez la politique de sensibilité à la casse pour les noms d'objets de destination.

      Source Objects

      Dans la zone Source Objects, cliquez sur un objet à synchroniser, puis cliquez sur 向右 pour le déplacer vers la zone Selected Objects.

      Remarque

      Vous pouvez sélectionner des objets au niveau de la table.

      Selected Objects

      Aucune configuration supplémentaire n'est requise. Vous pouvez utiliser la fonctionnalité de mappage pour définir le nom du topic, le nombre de partitions du topic ou les noms de colonnes pour la table source dans l'instance Kafka cible.

      Informations sur les objets Kafka

      1. Dans la zone Selected Objects, survolez le nom du topic cible (au niveau de la table).

      2. Cliquez sur Edit à côté du nom du topic.

      3. Dans la boîte de dialogue Edit Table, configurez les informations de mappage.

        Remarque
        • Au niveau du schéma, utilisez la boîte de dialogue Edit Schema, qui comporte moins de paramètres. Au niveau de la table, utilisez la boîte de dialogue Edit Table.

        • Si vous ne synchronisez pas un schéma entier, vous ne pouvez pas modifier les paramètres Name of target Topic et Number of Partitions dans la boîte de dialogue Edit Schema.Destination Database Name

        Paramètre

        Description

        Name of target Topic

        Le nom du topic de destination vers lequel la table source est synchronisée. La valeur par défaut est le Topic sélectionné dans la section Destination Database de l'étape Configurations for Source and Destination Databases.

        Important
        • Pour une instance Alibaba Cloud Message Queue for Apache Kafka, le topic doit déjà exister. Sinon, la tâche de synchronisation des données échoue. Si la cible est un cluster Kafka géré par l'utilisateur et que la tâche de synchronisation inclut la synchronisation du schéma, DTS tente de créer le topic que vous spécifiez.

        • Si vous modifiez le Name of target Topic, DTS écrit les données dans le nouveau topic.

        Filter Conditions

        Pour plus d'informations, consultez Définir les conditions de filtrage.

        Number of Partitions

        Le nombre de partitions à utiliser lors de l'écriture des données dans le topic cible.

        Column

        Spécifie les noms de colonnes pour les données écrites dans le topic cible.

      Remarque
      • Pour sélectionner les opérations SQL à synchroniser au niveau du schéma ou de la table, faites un clic droit sur l'objet dans le volet Selected Objects et sélectionnez les opérations SQL souhaitées dans la boîte de dialogue qui s'affiche.

      • Si vous utilisez la fonctionnalité de mappage des noms d'objets, les autres objets qui dépendent de l'objet mappé peuvent ne pas être synchronisés.

    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é et vous n'avez pas besoin de sélectionner un cluster. Pour des performances plus stables, vous pouvez acheter un cluster dédié pour exécuter les tâches de synchronisation DTS. Pour plus d'informations, consultez Qu'est-ce qu'un cluster dédié DTS ?.

      Enable Encryption of Data In-Transit?

      Le chiffrement des données en transit peut affecter les performances de synchronisation. Activez cette fonctionnalité en fonction de vos exigences de sécurité.

      • No (par défaut)

      • Yes

      Retry Time for Failed Connections

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

      Remarque
      • Si vous disposez de plusieurs instances DTS (par exemple, l'instance A et l'instance B) qui partagent la même source ou la même destination, et que vous définissez la durée de nouvelle tentative réseau à 30 minutes pour l'instance A et à 60 minutes pour l'instance B, la durée la plus courte de 30 minutes est utilisée pour les deux.

      • Étant donné que DTS facture l'exécution de 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 métier 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 synchronisation, si d'autres problèmes non liés à la connectivité surviennent avec la base de données source ou de destination (tels que des exceptions d'exécution DDL ou DML), DTS signale une erreur et lance immédiatement des opérations de nouvelle tentative continues. La durée de nouvelle tentative par défaut est de 10 minutes. Vous pouvez également personnaliser la durée de nouvelle tentative dans la plage de 1 à 1 440 minutes. Nous vous recommandons de la définir à 10 minutes ou plus. Si les opérations pertinentes aboutissent dans la durée de nouvelle tentative définie, la tâche de synchronisation reprend automatiquement. Sinon, la tâche échoue.

      Important

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

      Enable Throttling for Full Data Synchronization

      Pendant l'étape de synchronisation complète, DTS consomme des ressources de lecture et d'écriture des bases de données source et de destination, ce qui peut augmenter la charge de la base de données. Pour réduire la charge sur les bases de données source et de destination, vous pouvez définir une limite de débit pour la tâche de synchronisation complète en configurant les paramètres Queries per second (QPS) to the source database, RPS of Full Data Migration et Data migration speed for full migration (MB/s).

      Remarque
      • Cet élément de configuration n'est disponible que lorsque Synchronization Types est défini sur Full Data Synchronization.

      • Vous pouvez également ajuster le débit de synchronisation complète une fois que l'instance de synchronisation est en cours d'exécution.

      Enable Throttling for Incremental Data Synchronization

      Vous pouvez également définir une limite de débit pour la tâche de synchronisation incrémentielle. Pour soulager la pression sur la base de données de destination, définissez les paramètres RPS of Incremental Data Synchronization et Data synchronization speed for incremental synchronization (MB/s).

      Environment Tag

      Vous pouvez sélectionner un tag d'environnement pour identifier l'instance selon vos besoins. Aucune sélection n'est nécessaire pour cet exemple.

      Scene Label

      Vous pouvez sélectionner un tag de scénario pour identifier l'instance selon vos besoins. Les tags de scénario n'affectent pas le fonctionnement normal de la tâche. Aucune sélection n'est nécessaire pour cet exemple.

      Configure ETL

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

      Monitoring and Alerting

      Indiquez si vous souhaitez configurer des alertes. Si la synchronisation échoue ou si la latence dépasse le seuil spécifié, une notification est envoyée à un contact d'alerte.

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

    • Pour afficher les paramètres API de configuration de cette instance, survolez le bouton Next: Save Task Settings and Precheck et cliquez sur Preview OpenAPI parameters dans la bulle.

    • Une fois que vous avez terminé de consulter les 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 synchronisation, DTS exécute une vérification préalable. La tâche ne peut démarrer que si tous les éléments de vérification préalable réussissent.

    • Si la vérification préalable échoue, cliquez sur View Details pour l'élément ayant échoué. Corrigez le problème comme indiqué, puis exécutez à nouveau la vérification préalable.

    • Si la vérification préalable renvoie un avertissement :

      • Si un élément de vérification échoue et ne peut pas être ignoré, cliquez sur View Details à côté de l'élément. Suivez les instructions pour corriger le problème, puis exécutez à nouveau la vérification préalable.

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

  7. Achetez l'instance.

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

    2. Sur la page Purchase, sélectionnez la méthode de facturation et les spécifications de lien pour l'instance de synchronisation de données. Le tableau suivant décrit ces paramètres en détail.

      Catégorie

      Paramètre

      Description

      New Instance Class

      Méthode de facturation

      • Abonnement : vous payez lors de la création de l'instance. Cette option convient aux besoins à long terme et est plus rentable que le paiement à l'utilisation. Plus la durée de l'abonnement est longue, plus la remise est importante.

      • Paiement à l'utilisation : vous êtes facturé à l'heure. Cette option convient aux besoins à court terme. Vous pouvez libérer l'instance immédiatement après utilisation pour économiser des coûts.

      Configuration du groupe de ressources

      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 Qu'est-ce que Resource Management ?.

      Spécification de lien

      DTS propose des spécifications de synchronisation avec différents niveaux de performance. La spécification de lien de synchronisation affecte le débit de synchronisation. Vous pouvez choisir une spécification en fonction de votre scénario métier. Pour plus d'informations, consultez les spécifications de lien de synchronisation de données.

      Durée de l'abonnement

      En mode abonnement, sélectionnez la durée et la quantité pour l'instance d'abonnement. Vous pouvez choisir un abonnement mensuel de 1 à 9 mois, ou un abonnement annuel de 1, 2, 3 ou 5 ans.

      Remarque

      Cette option n'est disponible que lorsque la méthode de facturation est Subscription.

    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, cliquez sur OK.

      Vous pouvez consulter la progression de la tâche sur la page Data Synchronization.

  8. FAQ