Herramienta de migración de datos

Este artículo proporciona soluciones para los errores que pueden producirse al ejecutar la herramienta de migración de datos.

Documentos/campos de Source no asignados source-documents-fields-not-mapped

Mensajes de error

En casos excepcionales, el mensaje puede mencionar

Destination documents

o

Destination fields

en lugar de los de origen.

Causa

Algunas entidades de la versión 1 de Adobe Commerce (en la mayoría de los casos, procedentes de extensiones) no existen en la base de datos de la versión 2 de Adobe Commerce.

Este mensaje aparece porque la herramienta de migración de datos ejecuta pruebas internas para comprobar que las tablas y los campos son coherentes entre las bases de datos source (Adobe Commerce 1) y destination (Adobe Commerce 2).

Posibles soluciones

Para omitir entidades de base de datos, agregue la etiqueta <ignore> a una entidad del archivo map.xml de la siguiente manera:

...
    <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>
    ...

La clase no está asignada en el registro class-does-not-exist-but-mentioned

Mensaje de error

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

Causa

No se pudo encontrar una clase del código base de Adobe Commerce 1 en el código base de Adobe Commerce 2 durante el paso de migración EAV en nuestra documentación para desarrolladores. En la mayoría de los casos, la clase que falta pertenece a una extensión.

Posibles soluciones

Error de restricción de clave externa

Texto del mensaje de error

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>

Causa

Faltan registros de base de datos en el parent_table al que señala el field_id del child_table.

Posible solución

Elimine los registros de child_table si no los necesita.

Para conservar los registros, deshabilite Data Integrity Step modificando config.xml de la herramienta de migración de datos

Duplicados en reescrituras de 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

Causa

Target path en una reescritura de URL debe estar especificado por un par único de Request path + Store ID Este error informa de dos entradas que utilizan el mismo par Request path + Store ID con dos valores Target path diferentes.

Posible solución

Habilite la opción auto_resolve_urlrewrite_duplicates en el archivo config.xml.

Esta configuración agrega una cadena hash a los registros en conflicto de las reescrituras de URL y muestra el resultado de la resolución en la interfaz de línea de comandos.

Discrepancia de entidades mismatch-of-entities

Mensaje de error

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

Causa

El error se produce durante el paso de comprobación de volumen. Significa que el recuento de registros de la base de datos Adobe Commerce 2 del documento no es el mismo que en Adobe Commerce 1.

Los registros que faltan se producen cuando un cliente realiza un pedido durante la migración.

Posible solución

Ejecute la herramienta de migración de datos en el modo Delta para transferir los cambios incrementales.

Deltalog no está instalado deltalog-is-not-installed

Mensaje de error

Deltalog for <TABLE_NAME> is not installed

Causa

Este error se produce durante la migración incremental (en nuestra documentación para desarrolladores) de cambios en los datos. Significa que no se encontraron tablas deltalog (con prefijo m2_cl_*) en la base de datos de Adobe Commerce 1. La herramienta instala estas tablas durante la migración de datos (en nuestra documentación para desarrolladores), así como los déclencheur de la base de datos que realizan un seguimiento de los cambios y rellenan las tablas de cuadros de diálogo.

Una de las razones del error podría ser que está intentando migrar desde una copia de su tienda Adobe Commerce 1 activa, no desde la propia tienda Live. Cuando se realiza una copia desde un almacén de Adobe Commerce 1 activo que nunca se ha migrado, la copia no contiene los déclencheur ni las tablas de deltalog adicionales necesarias para completar una migración de delta, por lo que la migración falla. La herramienta de migración de datos NO realiza comparaciones entre las bases de datos de AC1 y AC2 para migrar las diferencias. En su lugar, la herramienta utiliza los déclencheur y las tablas de deltalog instalados durante la primera migración para realizar migraciones delta posteriores. En tal caso, la copia de la base de datos de Adobe Commerce 1 activa no contendrá los déclencheur ni las tablas de cuadros de diálogo de deltalog que la herramienta de migración de datos utiliza para realizar una migración.

Posible solución

Se recomienda probar el proceso de migración desde una copia de la base de datos de Adobe Commerce 1 para solucionar los problemas de migración. Después de corregir los problemas en la copia, inicie el proceso de migración de nuevo desde la base de datos de Adobe Commerce 1 activa. Esto ayudará a garantizar un proceso de migración sin problemas.

Lectura relacionada

Prácticas recomendadas para modificar tablas de base de datos en el libro de estrategias de implementación de Commerce