Synchronize a replica set to a replica set or sharded cluster - ApsaraDB for MongoDB

Bases de données source et destination prises en charge

Cette section répertorie les bases de données source et destination prises en charge pour la synchronisation des données d'un replica set MongoDB vers un replica set ou un sharded cluster MongoDB. Cette rubrique illustre la procédure de configuration en utilisant une instance de replica set ApsaraDB for MongoDB comme source et une instance de replica set ou de sharded cluster ApsaraDB for MongoDB comme destination. La procédure est similaire pour les autres sources de données.

Base de données source

Base de données destination

Instance de replica set ApsaraDB for MongoDB

Instance de replica set ou de sharded cluster ApsaraDB for MongoDB

Replica set MongoDB géré par l'utilisateur sur une instance ECS

Replica set ou sharded cluster MongoDB géré par l'utilisateur sur une instance ECS

Replica set MongoDB géré par l'utilisateur connecté via Express Connect, VPN Gateway ou Smart Access Gateway

Replica set ou sharded cluster MongoDB géré par l'utilisateur connecté via Express Connect, VPN Gateway ou Smart Access Gateway

Prérequis

Vous devez avoir créé une instance de replica set source ApsaraDB for MongoDB et une instance destination ApsaraDB for MongoDB (replica set ou sharded cluster). Pour plus d'informations, consultez les rubriques Créer une instance de replica set et Créer une instance de sharded cluster.

Remarque
Pour connaître les versions prises en charge, consultez la rubrique Présentation de la solution de synchronisation.
L'instance destination ApsaraDB for MongoDB doit disposer d'au moins 10 % d'espace de stockage supplémentaire par rapport à l'espace utilisé par l'instance source ApsaraDB for MongoDB.
Si l'instance cible ApsaraDB for MongoDB est un sharded cluster, vous devez créer les bases de données et les collections que vous souhaitez sharder, configurer le sharding des données, activer le balancer et effectuer un pré-sharding dans l'instance cible ApsaraDB for MongoDB en fonction de vos besoins métier. Pour plus d'informations, consultez les rubriques Configurer le sharding des données pour optimiser les performances des shards et Gérer une distribution déséquilibrée des données dans un sharded cluster ApsaraDB for MongoDB.

Remarque
La configuration du sharding des données répartit les données synchronisées sur tous les shards, ce qui maximise les performances du cluster. L'activation du balancer et la réalisation d'un pré-sharding permettent d'éviter le déséquilibre des données.

Limites

Type	Description
Limites de la base de données source	Exigence en matière de bande passante : le serveur hébergeant votre base de données source doit disposer d'une bande passante sortante suffisante. Dans le cas contraire, la vitesse de synchronisation peut être affectée. Les collections à synchroniser doivent posséder une clé primaire ou une contrainte UNIQUE, et les valeurs des champs doivent être uniques. Dans le cas contraire, des données en double peuvent apparaître dans la base de données destination. Les noms de champs dans les données ne doivent pas contenir le caractère « . » (point) ; sinon, des incohérences de données peuvent survenir. Si vous effectuez une synchronisation au niveau des collections et que vous devez modifier des objets (par exemple, renommer des collections), une tâche de synchronisation prend en charge jusqu'à 1 000 collections. Si vous dépassez cette limite, la tâche échoue avec une erreur après sa soumission. Pour résoudre ce problème, divisez les collections en lots et configurez plusieurs tâches. Vous pouvez également configurer une tâche de synchronisation complète de la base de données. Un document unique dans votre base de données source ne peut pas dépasser 16 Mo. Dans le cas contraire, la tâche échoue. Votre base de données source ne peut pas être Azure Cosmos DB for MongoDB ou Amazon DocumentDB (cluster élastique). Votre base de données source doit activer l'Oplog et conserver l'Oplog pendant au moins sept jours. Vous pouvez également activer Change Streams et vous assurer que DTS peut s'abonner aux modifications de données des sept derniers jours via Change Streams. Dans le cas contraire, DTS peut ne pas parvenir à capturer les modifications de données, ce qui entraîne l'échec de la tâche. Dans les cas extrêmes, cela peut provoquer une incohérence ou une perte de données. Ces problèmes ne sont pas couverts par l'accord de niveau de service (SLA) de DTS. Important Nous vous recommandons d'utiliser l'Oplog pour capturer les modifications de données. Seules les versions MongoDB 4.0 et ultérieures prennent en charge Change Streams. Change Streams ne prend pas en charge la synchronisation bidirectionnelle. Si votre base de données source est Amazon DocumentDB (cluster non élastique), activez manuellement Change Streams. Lors de la configuration de la tâche, définissez Migration Method sur ChangeStream et définissez Architecture sur Sharded Cluster. Si les collections à synchroniser contiennent des index TTL, des incohérences de données ou une latence peuvent survenir. Limites des opérations sur la base de données source : Pendant la synchronisation du schéma et la synchronisation complète des données, ne modifiez pas le schéma des bases de données ou des collections (y compris les mises à jour de données de type tableau). Dans le cas contraire, la tâche de synchronisation peut échouer ou provoquer une incohérence des données entre les bases de données source et destination. Si vous effectuez uniquement une synchronisation complète des données, n'écrivez pas de nouvelles données dans l'instance source. Dans le cas contraire, une incohérence des données peut survenir entre les bases de données source et destination.
Autres limites	Si l'instance destination utilise une architecture de sharded cluster : Supprimez les documents orphelins. Dans le cas contraire, les performances de synchronisation peuvent en souffrir. Si des documents avec des valeurs `_id` conflictuelles apparaissent pendant la synchronisation, une incohérence des données ou un échec de la tâche peut survenir. Avant de démarrer la tâche, ajoutez la clé de shard utilisée par la destination aux données de la source. Si vous ne pouvez pas ajouter la clé de shard à la source, consultez la rubrique Synchroniser depuis MongoDB (sans clé de shard) vers MongoDB (architecture de sharded cluster). Après le démarrage de la tâche, les instructions INSERT pour les données à synchroniser doivent inclure la clé de shard. Les instructions UPDATE ne peuvent pas modifier la clé de shard. Si l'instance destination utilise une architecture ReplicaSet : Lorsque Access Method est défini sur Express Connect, VPN Gateway, or Smart Access Gateway ou Cloud Enterprise Network (CEN), vous devez saisir l'adresse et le port du nœud principal pour Domain Name or IP et Port Number, ou configurer une adresse de connexion haute disponibilité. Pour plus d'informations sur les adresses de connexion haute disponibilité, consultez la rubrique Créer une instance avec une base de données source ou destination MongoDB haute disponibilité. Lorsque Access Method est défini sur Self-managed Database on ECS, saisissez le port du nœud principal dans Port Number. Nous vous recommandons d'utiliser la même version de MongoDB pour les bases de données source et destination. Utilisez plutôt une version supérieure pour la destination afin de garantir la compatibilité. La synchronisation d'une version supérieure vers une version inférieure peut entraîner des problèmes de compatibilité. DTS ne prend pas en charge la connexion aux bases de données MongoDB à l'aide d'adresses SRV. DTS ne prend pas en charge la synchronisation des données des bases de données admin, config et local. Si la collection destination possède un index unique ou si sa propriété `capped` est définie sur `true`, la relecture simultanée n'est pas prise en charge lors de la synchronisation incrémentielle. Seules les écritures monothread sont autorisées. Cela peut augmenter la latence de la tâche. Les informations de transaction ne sont pas conservées. Les transactions dans la base de données source deviennent des enregistrements individuels dans la base de données destination. Lorsque DTS écrit des données dans la collection destination, si un conflit de clé primaire ou de clé unique se produit, DTS ignore l'instruction d'écriture et conserve les données existantes dans la collection destination. Si votre version source de MongoDB est antérieure à la 3,6 et que votre version destination de MongoDB est la 3.6 ou une version ultérieure, des différences dans les plans d'exécution peuvent entraîner un ordre incohérent des champs dans les données synchronisées. Les relations champ-valeur restent inchangées. Si votre application utilise des requêtes de correspondance de texte sur des structures imbriquées, évaluez l'impact de l'ordre incohérent des champs. Évaluez les performances des bases de données source et destination avant la synchronisation. Exécutez la synchronisation pendant les heures creuses. Dans le cas contraire, l'initialisation complète des données consomme des ressources de lecture et d'écriture, augmentant ainsi la charge de la base de données. L'initialisation complète exécute des opérations INSERT de manière concurrente. Cela crée de la fragmentation dans la collection de la base de données destination. Après l'initialisation complète, l'espace de la collection dans l'instance destination est plus grand que dans l'instance source. N'écrivez pas de données dans la base de données destination autrement que via DTS pendant la synchronisation. Dans le cas contraire, une incohérence des données peut survenir entre les bases de données source et destination. Par exemple, si vous utilisez DMS pour effectuer des opérations DDL en ligne pendant que d'autres données sont écrites dans la base de données destination, une perte de données peut survenir. Étant donné que DTS écrit les données de manière concurrente, l'espace de stockage utilisé par la destination est supérieur de 5 % à 10 % à celui de la source. Pour obtenir le nombre de documents dans la destination MongoDB, utilisez la syntaxe `db.$table_name.aggregate([{ $count:"myCount"}])`. Assurez-vous que la destination MongoDB ne possède pas la même clé primaire (par défaut _id) que la source. Dans le cas contraire, une perte de données peut survenir. Si la destination possède la même clé primaire, supprimez les données associées dans la destination sans affecter votre activité (supprimez les documents ayant la même valeur _id dans la destination). En cas d'échec d'une tâche, l'équipe d'assistance 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 la 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. Si votre base de données destination est un sharded cluster MongoDB, assurez-vous que le comportement de votre application respecte les exigences de MongoDB pour les collections shardées après le basculement du trafic vers cette base de données. Si la base de données source est MongoDB 5.0 ou une version ultérieure et que la version de la base de données destination est antérieure à 5,0, vous ne pouvez pas synchroniser les collections `capped collection`s. Si vous tentez de les synchroniser, la tâche échoue ou une incohérence des données survient entre les bases de données source et destination. En effet, à partir de MongoDB 5.0, le comportement des collections `capped collection`s a changé pour permettre des opérations telles que la suppression explicite et l'augmentation de la taille des documents lors des mises à jour, et les versions antérieures du noyau de la base de données ne peuvent pas prendre en charge ces nouvelles fonctionnalités. DTS ne prend pas en charge la synchronisation des collections de séries temporelles introduites dans MongoDB 5.0 et versions ultérieures. La synchronisation des données contenant un encodage non UTF-8 n'est pas prise en charge, ce qui peut entraîner une incohérence des données.
Cas particuliers	Si votre base de données source est un MongoDB géré par l'utilisateur : Si un basculement primaire/secondaire se produit dans la base de données source pendant la synchronisation, la tâche échoue. DTS calcule la latence en comparant l'horodatage du dernier document synchronisé avec l'horodatage actuel. Si la base de données source ne subit aucune mise à jour pendant une longue période, les informations de latence peuvent être inexactes. Si la latence semble trop élevée, exécutez une opération de mise à jour dans la base de données source pour actualiser les informations de latence. Remarque Si vous sélectionnez la synchronisation complète de la base de données, créez une table de heartbeat. Mettez à jour ou écrivez dans cette table chaque seconde.

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.

Topologies de synchronisation prises en charge

Synchronisation unidirectionnelle un-à-un
Synchronisation unidirectionnelle un-à-plusieurs
Synchronisation unidirectionnelle plusieurs-à-un
Synchronisation unidirectionnelle en cascade

Pour plus de détails sur ces topologies de synchronisation et leurs considérations, consultez la rubrique Topologies de synchronisation.

Types de synchronisation

Type	Description
Synchronisation du schéma	Réplique les schémas des objets sélectionnés de l'instance source ApsaraDB for MongoDB vers l'instance destination ApsaraDB for MongoDB.
Synchronisation complète des données	Réplique toutes les données historiques des objets sélectionnés de l'instance source ApsaraDB for MongoDB vers l'instance destination ApsaraDB for MongoDB. Remarque La synchronisation complète des données est prise en charge aux niveaux de la base de données et de la collection.
Synchronisation incrémentielle des données	Réplique les modifications en cours de l'instance source ApsaraDB for MongoDB vers l'instance destination ApsaraDB for MongoDB une fois la synchronisation complète des données terminée. Oplog La synchronisation incrémentielle des données ne réplique pas les bases de données créées après le démarrage de la tâche. Les modifications suivantes sont répliquées : CREATE COLLECTION et CREATE INDEX DROP DATABASE, DROP COLLECTION et DROP INDEX RENAME COLLECTION Remarque L'opération RENAME COLLECTION n'est pas répliquée si l'option `dropTarget` est définie sur `true`. Insertions, mises à jour et suppressions de documents au sein d'une collection. Remarque Pour les mises à jour de documents, seules les opérations utilisant la commande `$set` sont répliquées. Change stream Les modifications suivantes sont répliquées : DROP DATABASE et DROP COLLECTION RENAME COLLECTION Remarque L'opération RENAME COLLECTION n'est pas répliquée si l'option `dropTarget` est définie sur `true`. Insertions, mises à jour et suppressions de documents au sein d'une collection. Remarque Pour les mises à jour de documents, seules les opérations utilisant la commande `$set` sont répliquées.

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
1. Connectez-vous à la console Data Transmission Service (DTS).
2. Dans le volet de navigation de gauche, cliquez sur Data SynchronizationData 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 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 TasksData Synchronization Tasks, sélectionnez la région où se trouve l'instance de synchronisation.
Cliquez sur Create TaskCreate Task pour ouvrir la page de configuration de la tâche.

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

Avertissement

Après avoir sélectionné les instances source et de destination, lisez attentivement les limites affichées en haut de la page. Si vous ne respectez pas ces limites, la tâche peut échouer ou des incohérences de données peuvent survenir.

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 MongoDB.
	Connection Type	Sélectionnez Alibaba Cloud Instance.
	Instance Region	Sélectionnez la région où se trouve l'instance ApsaraDB for MongoDB 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.
	Architecture	Sélectionnez Replica Set.
	Migration Method	Sélectionnez une méthode de synchronisation incrémentielle des données en fonction de vos besoins. Oplog (recommandé) : Cette option est disponible si Oplog est activé pour la base de données source. Remarque Oplog est activé par défaut pour les bases de données MongoDB gérées par l'utilisateur et les instances ApsaraDB for MongoDB. Cette méthode offre une latence plus faible pour les tâches de synchronisation incrémentielle car les journaux sont récupérés plus rapidement. Nous vous recommandons de sélectionner Oplog. ChangeStream : Cette option est disponible si Change Streams sont activés pour la base de données source. Remarque Si la base de données source est une instance Amazon DocumentDB (cluster non élastique), vous ne pouvez sélectionner que ChangeStream. Si vous définissez Architecture de la base de données source sur Sharded Cluster, vous n'avez pas besoin de spécifier Shard account et Shard password.
	Instance ID	Sélectionnez l'ID de l'instance ApsaraDB for MongoDB source.
	Authentication Database	Saisissez le nom de la base de données associé au compte de l'instance ApsaraDB for MongoDB source. La valeur par défaut est `admin`.
	Database Account	Saisissez le compte de la base de données ApsaraDB for MongoDB source. Le compte doit disposer d'une autorisation de lecture sur les bases de données à synchroniser, la base de données `config`, la base de données `admin` et la base de données `local`. Remarque Si vous utilisez ChangeStream comme méthode de synchronisation incrémentielle, le compte de la base de données source nécessite des autorisations de lecture Change Streams à l'échelle de l'instance (telles que `readAnyDatabase`). Si la source est une instance ApsaraDB for MongoDB avec un compte personnalisé, vous devez également accorder au compte une autorisation de lecture sur la base de données `admin`. Pour plus de détails, consultez Autorisations du compte root spécifié lors de la création de l'instance.
	Database Password	Saisissez le mot de passe correspondant au compte de la base de données.
	Encryption	DTS prend en charge trois méthodes de connexion : Non-encrypted, SSL-encrypted et Mongo Atlas SSL. Les options de Encryption varient en fonction de la Access Method et de l'Architecture sélectionnées. Les options affichées dans la console font foi. Remarque Une base de données MongoDB dont l'Architecture est Sharded Cluster et dont la Migration Method est Oplog ne prend pas en charge SSL-encrypted. Si la source est une base de données MongoDB gérée par l'utilisateur (Access Method n'est pas Alibaba Cloud Instance) avec une architecture Replica Set, et si vous sélectionnez SSL-encrypted, DTS vous permet également de télécharger un certificat CA pour vérifier la connexion.
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 MongoDB.
	Connection Type	Sélectionnez Alibaba Cloud Instance.
	Instance Region	Sélectionnez la région où se trouve l'instance ApsaraDB for MongoDB de destination.
	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.
	Architecture	Sélectionnez le type d'architecture de l'instance ApsaraDB for MongoDB de destination.
	Instance ID	Sélectionnez l'ID de l'instance ApsaraDB for MongoDB de destination.
	Authentication Database	Saisissez le nom de la base de données associé au compte de l'instance ApsaraDB for MongoDB de destination. La valeur par défaut est `admin`.
	Database Account	Saisissez le compte de la base de données ApsaraDB for MongoDB de destination. Le compte doit disposer de l'autorisation dbAdminAnyDatabase, de l'autorisation readWrite sur la base de données de destination et de l'autorisation de lecture sur la base de données local.
	Database Password	Saisissez le mot de passe correspondant au compte de la base de données.
	Encryption	DTS prend en charge trois méthodes de connexion : Non-encrypted, SSL-encrypted et Mongo Atlas SSL. Les options de Encryption varient en fonction de la Access Method et de l'Architecture sélectionnées. Les options affichées dans la console font foi. Remarque Les bases de données MongoDB avec une Architecture de type Sharded Cluster ne prennent pas en charge SSL-encrypted. Si la destination est une base de données MongoDB gérée par l'utilisateur (Access Method n'est pas Alibaba Cloud Instance) avec un Replica Set, et si vous sélectionnez SSL-encrypted, DTS vous permet également de télécharger un certificat CA pour vérifier la connexion.

Une fois la configuration terminée, cliquez sur Test Connectivity and ProceedTest 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. Cela peut être fait automatiquement ou manuellement. Pour plus d'informations, consultez 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 Access MethodAccess Method n'est pas Alibaba Cloud InstanceAlibaba Cloud Instance), vous devez également cliquer sur Test ConnectivityTest Connectivity dans la boîte de dialogue CIDR Blocks of DTS ServersCIDR Blocks of DTS Servers.

Configurez les objets de la tâche.

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 référence pour la synchronisation incrémentielle ultérieure. Remarque Pour plus d'informations, consultez la section Étapes de la tâche.
Processing Mode of Conflicting Tables	Precheck and Report Errors : Vérifie la présence d'une collection portant le même nom dans la base de données de destination. Si une collection homonyme est trouvée, une erreur est signalée et la tâche de synchronisation des données ne démarre pas. Sinon, la vérification préalable réussit. Remarque Si vous ne pouvez pas supprimer ou renommer la collection homonyme dans la base de données de destination, vous pouvez modifier le nom de la collection dans la base de données de destination. Pour plus d'informations, consultez la rubrique Définir le nom d'un objet de synchronisation dans l'instance de destination. Ignore Errors and Proceed : Ignore la vérification des collections 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 mettre votre activité en péril. Par exemple : Si 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, l'enregistrement de la base de données de destination est conservé. L'enregistrement de la base de données source n'est pas synchronisé vers la base de données de destination. Cela peut entraîner l'échec de l'initialisation des données, la synchronisation partielle des données ou l'échec total de la synchronisation.
Synchronization Topology	Sélectionnez One-way Synchronization.
Capitalization of Object Names in Destination Instance	Vous pouvez configurer la politique de sensibilité à la casse pour les noms anglais des objets de base de données et de collection synchronisés vers l'instance de destination. Vous pouvez sélectionner la DTS default policy, qui est l'option par défaut, ou utiliser les politiques par défaut de la base de données source ou de destination. Pour plus d'informations, consultez la rubrique 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 DATABASE ou COLLECTION.
Selected Objects	Pour définir le nom d'un objet de synchronisation dans l'instance de destination ou spécifier quel objet reçoit les données, faites un clic droit sur l'objet de synchronisation dans la zone Selected Objects et modifiez-le. Pour plus d'informations, consultez la rubrique Mapper les noms de tables et de colonnes. Pour supprimer un objet de synchronisation, cliquez dessus dans la zone Selected Objects, puis cliquez sur pour le déplacer vers la zone Source Objects. Remarque Pour sélectionner des opérations incrémentielles au niveau de la base de données ou de la collection, faites un clic droit sur l'objet souhaité dans la zone Selected Objects et effectuez vos sélections dans la boîte de dialogue qui s'affiche. Pour filtrer les données (pris en charge lors de la synchronisation complète mais pas lors de la synchronisation incrémentielle), faites un clic droit sur la collection souhaitée dans la zone Selected Objects et configurez les paramètres dans la boîte de dialogue qui s'affiche. Pour obtenir des instructions, consultez la rubrique Configurer les conditions de filtrage. Si vous utilisez la fonctionnalité de mappage de noms d'objets pour spécifier une base de données ou une collection destinataire des données, la synchronisation peut échouer pour d'autres objets dépendant de l'objet mappé.

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 la rubrique Qu'est-ce qu'un cluster dédié DTS ?.
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 tente immédiatement de rétablir la connexion. La durée de nouvelle tentative par défaut est de 720 minutes. Vous pouvez également spécifier une durée personnalisée comprise entre 10 et 1 440 minutes. Nous vous recommandons de définir la durée à 30 minutes ou plus. Si DTS parvient à se reconnecter à 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) partageant la même source ou la même destination, et que vous définissez le temps de nouvelle tentative réseau à 30 minutes pour l'instance A et à 60 minutes pour l'instance B, la durée la plus courte, soit 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 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 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 une fois l'instance de synchronisation en cours d'exécution.
Only one data type for primary key _id in a table of the data to be synchronized	Spécifiez si les types de données de la clé primaire `_id` sont uniques au sein de chaque collection à synchroniser. Important Sélectionnez une option en fonction de vos données réelles. Une sélection incorrecte peut entraîner une perte de données. Ce paramètre est disponible uniquement si Synchronization Types inclut Full Data Synchronization. Yes : Les types de données sont uniques. Pendant la phase de synchronisation complète, DTS n'analyse pas les types de données des clés primaires dans les données source. Pour chaque collection, DTS synchronise uniquement les données correspondant à un type de données de clé primaire. No : Les types de données ne sont pas uniques. Pendant la phase de synchronisation complète, DTS analyse les types de données des clés primaires dans les données source et synchronise toutes les données.
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. Dans cet exemple, aucune sélection n'est nécessaire.
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 : Yes : Active la fonctionnalité ETL. Saisissez les instructions de traitement des données dans l'éditeur de code. Pour plus d'informations, consultez la rubrique Configurer l'ETL dans une tâche de migration ou de synchronisation des données. No : Désactive la fonctionnalité ETL.
Monitoring and Alerting	Spécifiez si vous souhaitez configurer des alertes. En cas d'échec de la synchronisation 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 la rubrique Configurer la surveillance et les alertes lors de la configuration de la tâche.

Cliquez sur Next: Data Validation pour configurer une tâche de validation des données.

Si vous souhaitez utiliser la fonctionnalité de validation des données, consultez la rubrique Configurer la validation des données pour obtenir des instructions de configuration.

Enregistrez la tâche et exécutez une vérification préalable.
- Pour afficher les paramètres API de configuration de cette instance, placez le curseur sur le bouton Next: Save Task Settings and Precheck et cliquez sur Preview OpenAPI parameters dans l'infobulle.
- Une fois que vous avez consulté 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 sont validés.
- Si la vérification préalable échoue, cliquez sur View Details pour l'élément ayant échoué. Corrigez le problème comme indiqué, puis relancez 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 relancez la vérification préalable.
  
  Pour les éléments de vérification pouvant ê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é.

Achetez l'instance.

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

Sur la page Purchase, sélectionnez la méthode de facturation et les spécifications de 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 est plus rentable que le paiement à l'utilisation. Plus la durée d'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 réaliser des économies.
	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 la rubrique Qu'est-ce que Resource Management ?.
	Spécifications de lien	DTS propose des spécifications de synchronisation avec différents niveaux de performance. Les spécifications du lien de synchronisation affectent le débit de synchronisation. Vous pouvez choisir une spécification en fonction de votre scénario métier. Pour plus d'informations, consultez la rubrique 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 choisir un abonnement mensuel de 1 à 9 mois, ou un abonnement annuel de 1, 2, 3 ou 5 ans. Remarque Cette option est disponible uniquement lorsque la méthode de facturation est Subscription.

Une fois la configuration terminée, lisez et sélectionnez 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.

FAQ

Pourquoi observez-vous une latence des tâches et des incohérences de données même en l'absence d'écritures applicatives ?

Cause : Ce problème résulte d'un conflit entre le mécanisme de suppression automatique d'un index TTL sur une collection MongoDB et le mécanisme de synchronisation des données de DTS. Cette situation peut entraîner une latence des tâches et des incohérences de données lors de votre tâche de synchronisation ou de migration.

Réduction de l'efficacité due aux suppressions redondantes : Lorsque l'index TTL source supprime les données expirées, il inscrit un enregistrement DELETE dans l'Oplog. DTS rejoue cette opération DELETE sur la destination. Si l'index TTL de destination a déjà supprimé ces mêmes données, MongoDB renvoie un nombre de lignes affectées inattendu, ce qui déclenche la gestion des exceptions et ralentit la migration.

Incohérence des données liée à la suppression asynchrone par TTL : Les index TTL ne suppriment pas les données en temps réel. Il est possible que des données expirées existent toujours sur la source alors qu'elles ont déjà été supprimées sur la destination, provoquant ainsi une incohérence.

Exemple :

L'Oplog MongoDB ou ChangeStream n'enregistre que les champs mis à jour pour une opération UPDATE, et non le document complet. Si une opération UPDATE ne trouve pas les données cibles sur la destination, DTS ignore l'opération.

Moment

Instance source

Instance de destination

1

Le service insère des données

2

DTS synchronise l'opération INSERT

3

Les données ont expiré mais n'ont pas encore été supprimées par l'index TTL

4

Le service met à jour les données (par exemple, modifie le champ de l'index TTL pour changer l'heure d'expiration)

5

L'index TTL supprime les données

6

DTS synchronise l'opération UPDATE, mais les données sont introuvables. L'opération est ignorée.

Par conséquent, ce document est absent de l'instance MongoDB de destination.

Solution : Pour résoudre ce problème, modifiez temporairement la durée d'expiration de l'index TTL sur la cible pendant la tâche de synchronisation ou de migration. Cette approche garantit à la fois l'efficacité de la synchronisation et la cohérence des données. Pour obtenir la procédure détaillée, consultez Bonnes pratiques pour la synchronisation ou la migration de collections avec des index TTL depuis une source MongoDB.

Bases de données source et destination prises en charge

Prérequis

Limites

Facturation

Topologies de synchronisation prises en charge

Types de synchronisation

Oplog

Change stream

Procédure

Depuis la console DTS

Depuis la console DMS

FAQ