데이터 마이그레이션 도구 문제 해결

이 문서에서는 데이터 마이그레이션 도구를 실행할 때 발생할 수 있는 오류에 대한 솔루션을 제공합니다.

Source 문서/필드가 매핑되지 않음 source-documents-fields-not-mapped

오류 메시지

드문 경우지만 메시지에

Destination documents

또는

Destination fields

소스 조각 대신

원인

일부 Adobe Commerce 버전 1 엔티티(대부분의 경우 확장에서 가져옴)가 Adobe Commerce 버전 2 데이터베이스에 없습니다.

이 메시지는 데이터 마이그레이션 도구에서 내부 테스트를 실행하여 테이블과 필드가 source(Adobe Commerce 1)와 destination(Adobe Commerce 2) 데이터베이스 간에 일관되는지 확인하기 때문에 나타납니다.

가능한 해결 방법

데이터베이스 엔터티를 무시하려면 다음과 같이 <ignore> 태그를 map.xml 파일의 엔터티에 추가하십시오.

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

클래스가 레코드에서 매핑되지 않았습니다. class-does-not-exist-but-mentioned

오류 메시지

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

원인

개발자 설명서의 EAV 마이그레이션 단계 동안 Adobe Commerce 2 코드베이스에서 Adobe Commerce 1 코드베이스의 클래스를 찾을 수 없습니다. 대부분의 경우 누락된 클래스는 extension에 속합니다.

가능한 해결 방법

외래 키 제약 조건 실패

오류 메시지 텍스트

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>

원인

parent_table에 child_table의 field_id이(가) 가리키는 데이터베이스 레코드가 없습니다.

가능한 해결 방법

필요하지 않으면 child_table에서 레코드를 삭제합니다.

레코드를 유지하려면 데이터 마이그레이션 도구의 config.xml 을(를) 수정하여 Data Integrity Step을(를) 사용하지 않도록 설정하십시오.

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

원인

URL 다시 쓰기의 Target path은(는) Request path + Store ID의 고유한 쌍으로 지정해야 합니다. 이 오류는 두 개의 서로 다른 Target path 값이 있는 동일한 Request path + Store ID 쌍을 사용하는 두 개의 항목을 보고합니다.

가능한 해결 방법

config.xml 파일에서 auto_resolve_urlrewrite_duplicates 옵션을 사용하도록 설정합니다.

이 구성은 URL 재작성의 충돌하는 레코드에 해시 문자열을 추가하고, 해결 결과를 명령줄 인터페이스에 표시합니다.

엔티티 불일치 mismatch-of-entities

오류 메시지

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

원인

이 오류는 볼륨 확인 단계에서 발생합니다. 즉, 문서의 Adobe Commerce 2 데이터베이스 레코드 수가 Adobe Commerce 1과 동일하지 않습니다.

고객이 마이그레이션하는 동안 주문하면 레코드가 누락됩니다.

가능한 해결 방법

Delta 모드에서 데이터 마이그레이션 도구를 실행하여 증분 변경 내용을 전송하십시오.

Deltalog가 설치되지 않았습니다. deltalog-is-not-installed

오류 메시지

Deltalog for <TABLE_NAME> is not installed

원인

이 오류는 개발자 설명서에서 데이터에 대한 변경 내용을 증분 마이그레이션하는 동안 발생합니다. 즉, 접두사가 m2_cl_*인 Deltalog 테이블을 Adobe Commerce 1 데이터베이스에서 찾을 수 없습니다. 이 도구는 데이터 마이그레이션(개발자 설명서) 중에 이러한 테이블을 설치하고 변경 내용을 추적하고 deltalog 테이블을 채우는 데이터베이스 트리거를 설치합니다.

오류가 발생하는 한 가지 이유는 라이브 스토어 자체가 아니라 라이브 Adobe Commerce 1 스토어의 복사본 ​에서 마이그레이션하려고 하기 때문일 수 있습니다. 마이그레이션된 적이 없는 라이브 Adobe Commerce 1 스토어에서 복사본을 만들 때 복사본에 델타 마이그레이션을 완료하는 데 필요한 트리거와 추가 deltalog 테이블이 포함되어 있지 않으므로 마이그레이션이 실패합니다. 데이터 마이그레이션 툴은 AC1과 AC2의 DB를 비교하여 차이점을 마이그레이션하지 않습니다. 대신, 이 도구는 후속 델타 마이그레이션을 수행하기 위해 첫 번째 마이그레이션 중에 설치된 트리거 및 Deltalog 테이블을 사용합니다. 이러한 경우 라이브 Adobe Commerce 1 DB의 복사본에는 데이터 마이그레이션 도구가 마이그레이션을 수행하는 데 사용하는 트리거 및 카탈로그 테이블이 포함되지 않습니다.

가능한 해결 방법

마이그레이션 문제를 해결하기 위해 Adobe Commerce 1 데이터베이스의 복사본에서 마이그레이션 프로세스를 테스트하는 것이 좋습니다. 사본의 문제를 해결한 후 라이브 Adobe Commerce 1 데이터베이스에서 마이그레이션 프로세스를 다시 시작합니다. 이를 통해 원활한 마이그레이션 프로세스를 보장할 수 있습니다.

관련 읽기

Commerce 구현 플레이북의 데이터베이스 테이블 수정 우수 사례