Cette rubrique explique comment synchroniser les données d'un cluster PolarDB for PostgreSQL (Compatible with Oracle) vers Message Queue for Apache Kafka à l'aide de Data Transmission Service (DTS).
Prérequis
Définissez le paramètre wal_level sur logical pour l'instance source PolarDB for PostgreSQL (Compatible with Oracle). Cette opération ajoute les informations requises pour le décodage logique au journal des transactions anticipées (WAL). Pour plus d'informations, consultez la rubrique Configurer les paramètres du cluster.
-
Créez une instance de destination Alibaba Cloud Message Queue for Kafka disposant d'un espace de stockage supérieur à celui utilisé par l'instance source PolarDB for PostgreSQL (Compatible with Oracle).
RemarquePour connaître les versions prises en charge des bases de données source et de destination, consultez la rubrique Solutions de synchronisation.
Créez un topic dans l'instance de destination Alibaba Cloud Message Queue for Kafka afin de recevoir les données synchronisées. Pour plus d'informations, consultez la rubrique Étape 1 : Créer un topic.
Remarques d'utilisation
|
Type |
Description |
|
Limites de la base de données source |
|
|
Autres limites |
|
Facturation
|
Type de synchronisation |
Tarification |
|
Synchronisation du schéma et synchronisation complète des données |
Gratuit. |
|
Synchronisation incrémentielle des données |
Facturé. Pour plus d'informations, consultez la rubrique Présentation de la facturation. |
Opérations SQL pour la synchronisation incrémentielle
|
Type d'opération |
Instruction SQL |
|
DML |
INSERT, UPDATE et DELETE |
|
DDL |
Remarque
La synchronisation DDL n'est pas prise en charge dans les scénarios suivants :
|
Autorisations du compte de base de données
|
Base de données |
Autorisations |
Références |
|
Cluster PolarDB for PostgreSQL (Compatible with Oracle) |
Compte privilégié |
Procédure
-
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
Connectez-vous à la console Data Transmission Service (DTS).
Dans le volet de navigation de gauche, cliquez sur Data Synchronization.
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
RemarqueLes 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.
Connectez-vous à Data Management (DMS).
Dans la barre de menu supérieure, choisissez .
À droite de Data Synchronization Tasks, sélectionnez la région où se trouve l'instance de synchronisation.
Cliquez sur Create Task pour ouvrir la page de configuration de la tâche.
-
Configurez les bases de données source et de destination.
RemarquePour trouver les paramètres de l'instance Message Queue for Apache Kafka de destination, consultez la rubrique Configurer les paramètres d'une instance Message Queue for Apache Kafka.
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 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.
RemarqueDans 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 PolarDB (Compatible with Oracle).
Access Method
Sélectionnez Alibaba Cloud Instance.
Instance Region
Sélectionnez la région où se trouve le cluster PolarDB for PostgreSQL (Compatible with Oracle) source.
Replicate Data Across Alibaba Cloud Accounts
Cet exemple utilise une instance de base de données appartenant au compte Alibaba Cloud actuel. Sélectionnez No.
Instance ID
Sélectionnez l'ID du cluster PolarDB for PostgreSQL (Compatible with Oracle) source.
Database Name
Saisissez le nom de la base de données source dans le cluster PolarDB for PostgreSQL (Compatible with Oracle).
Database Account
Saisissez le compte de base de données du cluster PolarDB for PostgreSQL (Compatible with Oracle) source. Pour plus d'informations sur les autorisations requises, consultez la section Autorisations requises pour les comptes de base de données.
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 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.
RemarqueDans 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 Express Connect, VPN Gateway, or Smart Access Gateway.
RemarqueDans cet exemple, l'instance Message Queue for Apache Kafka est configurée comme un cluster Kafka géré par l'utilisateur pour la synchronisation des données.
Instance Region
Sélectionnez la région où se trouve l'instance Message Queue for Apache Kafka de destination.
Connected VPC
Sélectionnez l'ID du VPC pour l'instance Message Queue for Apache Kafka de destination.
Domain Name or IP
Saisissez une adresse IP à partir de la section Default Endpoint de l'instance Message Queue for Apache Kafka de destination.
Port Number
Saisissez le port de service de l'instance Message Queue for Apache Kafka de destination. La valeur par défaut est 9092.
Database Account
Vous n'avez pas besoin de configurer ce paramètre pour cet exemple.
Database Password
Kafka Version
Sélectionnez la version de votre instance Kafka.
Encryption
En fonction de vos besoins 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 est une couche de service pour vos métadonnées. Il fournit une interface RESTful pour stocker et récupérer des schémas Avro.
-
No : N'utilisez pas Kafka Schema Registry.
-
Yes : Utilisez Kafka Schema Registry. Vous devez saisir l'URL ou l'adresse IP enregistrée pour le schéma Avro dans Kafka Schema Registry dans le champ URL or IP Address of Schema Registry.
-
-
Une fois la configuration terminée, cliquez sur Test Connectivity and Proceed en bas de la page.
RemarqueAssurez-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 gérée par l'utilisateur (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.
-
Configurez les objets de la tâche.
-
Sur la page Configure Objects, configurez les objets à synchroniser.
Parameter
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 prévérification 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 référence pour la synchronisation incrémentielle ultérieure.
RemarqueSi la méthode d'Access Method pour l'instance Kafka de destination 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 prévérification réussit. Si une table du même nom existe, la prévérification échoue et la tâche de synchronisation des données ne démarre pas.
RemarqueSi 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.
AvertissementLa 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 :
-
Lors de 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é.
-
Lors de 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 à synchroniser vers l'instance Kafka en fonction de vos besoins métier.
-
Si vous sélectionnez Canal JSON, consultez Canal JSON pour obtenir les descriptions des paramètres et des exemples.
RemarqueActuellement, vous pouvez sélectionner Canal JSON uniquement dans les régions Chine (Qingdao) et Chine (Pékin).
Si vous sélectionnez DTS Avro, vous devez analyser les données selon la définition du schéma DTS Avro. Pour plus d'informations, consultez la définition du schéma DTS Avro et l'exemple de désérialisation DTS Avro.
-
Si vous sélectionnez Shareplex JSON, consultez Shareplex Json pour obtenir les descriptions des paramètres et des exemples.
Kafka Data Compression Format
Sélectionnez le format de compression pour la compression des messages Kafka en fonction de vos besoins métier.
LZ4 (par défaut) : le taux de compression est faible, mais la vitesse de compression est élevée.
GZIP : le taux de compression est élevé, mais la vitesse de compression est faible.
RemarqueLa consommation CPU est élevée.
Snappy : le taux de compression et la vitesse de compression sont moyens.
Policy for Shipping Data to Kafka Partitions
Sélectionnez une stratégie.
Message acknowledgement mechanism
Sélectionnez un mécanisme d'accusé de réception des messages.
Topic That Stores DDL Information
Sélectionnez le topic utilisé pour stocker les informations DDL dans la liste déroulante.
RemarqueSi non spécifié, les informations DDL sont stockées par défaut dans le topic qui reçoit les 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 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 Case sensitivity policy for destination object names.
Source Objects
Dans la zone Source Objects, cliquez sur un objet à synchroniser, puis cliquez sur
pour le déplacer vers la zone Selected Objects.RemarqueVous pouvez sélectionner des objets à synchroniser au niveau de la table.
Selected Objects
Aucune configuration supplémentaire n'est requise pour cet exemple. Vous pouvez utiliser la fonctionnalité de mappage pour définir le nom du topic, le nombre de partitions dans le topic et la clé de partition pour la table source dans l'instance Kafka de destination. Pour plus d'informations, consultez Mapping information.
Remarque-
Si vous mappez des noms d'objets, d'autres objets dépendant de ces objets peuvent ne pas être synchronisés.
-
Pour sélectionner les opérations SQL pour la synchronisation incrémentielle des données, faites un clic droit sur un objet dans la zone Selected Objects et sélectionnez les opérations SQL souhaitées dans la boîte de dialogue qui s'affiche.
-
-
Cliquez sur Next: Advanced Settings pour configurer les paramètres avancés.
Parameter
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 What is a DTS dedicated cluster?.
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 la durée spécifiée, 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 le temps d'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 commence 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.
ImportantLa 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 la phase 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 est disponible uniquement lorsque Synchronization Types est défini sur Full Data Synchronization.
-
Vous pouvez également ajuster le débit de synchronisation complète après le démarrage de l'instance de synchronisation.
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. Vous n'avez pas besoin d'en sélectionner un pour cet exemple.
Configure ETL
Choisissez d'activer ou non la fonctionnalité extract, transform, and load (ETL). Pour plus d'informations, consultez What is ETL? Valeurs valides :
-
Yes : active la fonctionnalité ETL. Saisissez les instructions de traitement des données dans l'éditeur de code. Pour plus d'informations, consultez Configure ETL in a data migration or data synchronization task.
-
No : désactive la fonctionnalité ETL.
Monitoring and Alerting
Spécifiez 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.
-
No : aucune alerte n'est configurée.
-
Yes : configurez les alertes en définissant un seuil d'alerte et en spécifiant un notification d'alerte. Pour plus d'informations, consultez Configure monitoring and alerting during task configuration.
-
-
-
Enregistrez la tâche et exécutez une prévérification.
Pour afficher les paramètres API pour configurer cette instance, placez le curseur sur 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.
RemarqueAvant le démarrage de la tâche de synchronisation, DTS exécute une prévérification. La tâche ne peut démarrer qu'après la réussite de tous les éléments de prévérification.
Si la prévérification échoue, cliquez sur View Details pour l'élément ayant échoué. Corrigez le problème comme indiqué, puis exécutez à nouveau la prévérification.
-
Si la prévérification 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 prévérification.
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 réexécuter la prévérification. Si vous choisissez de masquer l'élément d'avertissement, cela peut entraîner des problèmes tels que l'incohérence des données et présenter des risques pour votre activité.
-
Achetez une instance.
Lorsque le Success Rate atteint 100 %, cliquez sur Next: Purchase Instance.
-
Sur la page Purchase, sélectionnez la méthode de facturation et les spécifications du lien pour l'instance de synchronisation des 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 s'avère plus économique que le paiement à l'utilisation. Plus la durée d'abonnement est longue, plus la remise est importante.
-
Paiement à l'utilisation : la facturation s'effectue à l'heure. Cette option est adaptée aux besoins ponctuels. Vous pouvez libérer l'instance immédiatement après utilisation pour réduire les coûts.
Configuration du groupe de ressources
Groupe de ressources auquel l'instance appartient. 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écifications du lien
DTS propose des spécifications de synchronisation avec différents niveaux de performance. Les spécifications du lien de synchronisation influent sur le débit de synchronisation. Choisissez une spécification adaptée à votre scénario métier. Pour plus d'informations, consultez Spécifications des liens de synchronisation des données.
Durée d'abonnement
En mode abonnement, sélectionnez la durée et la quantité pour l'instance d'abonnement. Vous pouvez opter pour un abonnement mensuel de 1 à 9 mois, ou un abonnement annuel de 1, 2, 3 ou 5 ans.
RemarqueCette option n'est disponible que lorsque la méthode de facturation est définie sur Subscription.
-
Une fois la configuration terminée, lisez et acceptez les Data Transmission Service (Pay-as-you-go) Service Terms.
-
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.
Dans la section Selected Objects, placez le curseur sur le nom du topic cible au niveau de la table.
Cliquez sur Edit à côté du nom du topic cible.
-
Dans la boîte de dialogue Edit Table, configurez les informations de mappage.
RemarqueLa boîte de dialogue Edit Schema est destinée aux opérations au niveau du schéma et prend en charge moins de paramètres, tandis que la boîte de dialogue Edit Table est conçue pour les opérations au niveau de la 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.
Parameter
Description
Name of target Topic
Le topic de destination vers lequel la table source est synchronisée. Par défaut, il s'agit du Topic que vous sélectionnez dans la section Destination Database lors de l'étape Configurations for Source and Destination Databases.
Important-
Si la base de données de destination est une instance Alibaba Cloud Message Queue for Apache Kafka, le topic spécifié doit déjà exister dans l'instance Kafka de destination. Dans le cas contraire, la tâche de synchronisation des données échoue. Si la destination est un cluster Kafka géré par vos soins et que la tâche est configurée pour la synchronisation du schéma de la base de données et des tables, DTS tente de créer le topic spécifié dans la base de données de destination.
-
Si vous modifiez le paramètre Name of target Topic, DTS écrit les données dans le topic spécifié.
Filter Conditions
Pour plus d'informations, consultez la rubrique Définir des conditions de filtrage.
Number of Partitions
Le nombre de partitions pour les données dans le topic de destination.
Partition Key
Lorsque vous définissez la Policy for Shipping Data to Kafka Partitions sur Ship Data to Separate Partitions Based on Hash Values of Primary Keys, vous devez configurer ce paramètre. Sélectionnez une ou plusieurs colonnes comme clé de partition. DTS utilise ensuite la valeur de hachage de cette clé pour distribuer les lignes entre les partitions du topic. Sans clé de partition configurée, cette politique ne s'applique pas pendant la phase d'écriture incrémentielle.
RemarqueVous ne pouvez sélectionner une Partition Key que dans la boîte de dialogue Edit Table.
Cliquez sur OK.
-
Puis-je modifier le Kafka Data Compression Format ?
Oui. Vous pouvez utiliser la fonctionnalité Modifier les objets de synchronisation pour le modifier.
-
Puis-je modifier le Message acknowledgement mechanism ?
Oui. Vous pouvez utiliser la fonctionnalité Modifier les objets de synchronisation pour le modifier.