Dépannage de l’outil de migration de données

Cet article fournit des solutions aux erreurs qui peuvent se produire lors de l’exécution de l’outil de migration des données.

Documents/champs Source non mappés source-documents-fields-not-mapped

Messages d’erreur

Dans de rares cas, le message peut mentionner

Destination documents

ou

Destination fields

plutôt que les sources.

Cause

Certaines entités d’Adobe Commerce version 1 (provenant dans la plupart des cas d’extensions) n’existent pas dans la base de données d’Adobe Commerce version 2.

Ce message s’affiche car l’outil de migration de données exécute des tests internes pour vérifier que les tables et les champs sont cohérents entre les bases de données source (Adobe Commerce 1) et destination (Adobe Commerce 2).

Solutions possibles

Pour ignorer les entités de base de données, ajoutez la balise <ignore> à une entité dans le fichier map.xml, comme ceci :

...
    <source>
        <document_rules>
            ...
            <!-- Ignore `sales_flat_invoice_grid` table -->
            <ignore>
                <document>sales_flat_invoice_grid</document>
            </ignore>
            <!-- Ignore `address_id` field of `sales_flat_order_address` table -->
            <ignore>
                <field>sales_flat_order_address.address_id</field>
            </ignore>
            ...
        </document_rules>
    </source>
    ...

Classe non mappée dans l’enregistrement class-does-not-exist-but-mentioned

Message d’erreur

Class <extension/class_name> is not mapped in record <attribute_id=196>

Cause

Une classe du code base Adobe Commerce 1 est introuvable dans le code base d’Adobe Commerce 2 pendant l’ étape de migration d’EAV de notre documentation destinée aux développeurs. Dans la plupart des cas, la classe manquante appartient à une extension.

Solutions possibles

Échec de la contrainte de clé étrangère

Texte du message d’erreur

Foreign key <KEY_NAME> constraint fails on source database. Orphan records id: <id_1>, <id_2> from <child_table>.<field_id> has no referenced records in <parent_table>

Cause

Il manque des enregistrements de base de données dans le parent_table vers lequel pointe le field_id de child_table.

Solution possible

Supprimez les enregistrements du child_table , si vous n’en avez pas besoin.

Pour conserver les enregistrements, désactivez l’ Data Integrity Step en modifiant les config.xml de l’outil de migration de données .

Doublons dans les réécritures d’URL

There are duplicates in URL rewrites:
Request path: towel.html Store ID: 2 Target path: catalog/product/view/id/10
Request path: towel.html Store ID: 2 Target path: catalog/product/view/id/12

Cause

L’ Target path d’une réécriture d’URL doit être spécifié par une paire unique Request path + Store ID . Cette erreur signale deux entrées qui utilisent la même paire Request path + Store ID avec deux valeurs Target path différentes.

Solution possible

Activez l’option auto_resolve_urlrewrite_duplicates dans votre fichier config.xml.

Cette configuration ajoute une chaîne de hachage aux enregistrements en conflit des réécritures d’URL et affiche le résultat de la résolution dans votre interface de ligne de commande.

Discordance des entités mismatch-of-entities

Message d’erreur

Mismatch of entities in the document: <DOCUMENT> Source: <COUNT_ITEMS_IN_SOURCE_TABLE> Destination: <COUNT_ITEMS_IN_DESTINATION_TABLE>

Cause

L’erreur se produit lors de l’étape Vérification du volume . Cela signifie que le nombre d’enregistrements de la base de données Adobe Commerce 2 du document n’est pas le même que dans Adobe Commerce 1.

Des enregistrements manquants se produisent lorsqu’un client passe une commande lors de la migration.

Solution possible

Exécutez l’outil de migration de données en mode Delta pour transférer les modifications incrémentielles.

Deltalog n’est pas installé deltalog-is-not-installed

Message d’erreur

Deltalog for <TABLE_NAME> is not installed

Cause

Cette erreur se produit lors de la migration incrémentielle (dans notre documentation destinée aux développeurs) des modifications apportées aux données. Cela signifie que les tables de suppression (avec le préfixe m2_cl_*) n’ont pas été trouvées dans la base de données Adobe Commerce 1. L’outil installe ces tables pendant la migration de données (dans notre documentation destinée aux développeurs) ainsi que les déclencheurs de base de données qui effectuent le suivi des modifications et remplissent les tables de suppression.

L’erreur peut être due au fait que vous essayez de migrer à partir d’une copie de votre boutique Adobe Commerce 1 active, et non à partir du magasin en ligne lui-même. Lorsque vous effectuez une copie à partir d’un magasin Adobe Commerce 1 actif qui n’a jamais été migré, la copie ne contient pas les déclencheurs et les tables de suppression supplémentaires nécessaires pour terminer une migration delta, de sorte que la migration échoue. L’outil de migration de données ne fait PAS de comparaisons entre la base de données d’AC1 et d’AC2 pour migrer les différences. Au lieu de cela, l’outil utilise les déclencheurs et les tables de suppression installés lors de la première migration pour effectuer les migrations delta suivantes. Dans ce cas, votre copie de la base de données Adobe Commerce 1 active ne contient pas les déclencheurs et les tables de déverrouillage utilisés par l’outil de migration des données pour effectuer une migration.

Solution possible

Nous vous recommandons de tester le processus de migration à partir d’une copie de votre base de données Adobe Commerce 1 afin de résoudre vos problèmes de migration. Après avoir corrigé les problèmes de la copie, relancez le processus de migration à partir de votre base de données Adobe Commerce 1 active. Cela permettra d’assurer un processus de migration fluide.

Lecture connexe

Bonnes pratiques pour la modification des tables de base de données dans le manuel de mise en oeuvre de Commerce