데이터 마이그레이션

시작하기 전에 다음 단계를 수행하여 준비하십시오.

  1. 응용 프로그램 서버에 파일 시스템 소유자(으)로 로그인합니다.
  2. 응용 프로그램 설치 디렉터리를 변경하거나 시스템 PATH에 추가되었는지 확인하십시오.

자세한 내용은 첫 번째 단계 섹션을 참조하십시오.

데이터 마이그레이션 명령 실행

데이터 마이그레이션을 시작하려면 다음을 실행합니다.

bin/magento migrate:data [-r|--reset] [-a|--auto] {<path to config.xml>}

위치:

  • [-a|--auto]은(는) 무결성 검사 오류가 발생할 때 마이그레이션이 중지되지 않도록 하는 선택적 인수입니다.

  • [-r|--reset]은(는) 처음부터 마이그레이션을 시작하는 선택적 인수입니다. 이 인수는 마이그레이션 테스트에 사용할 수 있습니다.

  • {<path to config.xml>}은(는) config.xml에 대한 절대 파일 시스템 경로입니다. 이 인수는 필수입니다.

이 단계에서 Data Migration Tool은(는) Magento 1 데이터베이스에 마이그레이션 테이블에 대한 추가 테이블 및 트리거를 만듭니다. 증분/델타 마이그레이션 단계에서 사용됩니다. 추가 테이블에는 최종 마이그레이션 실행 후 변경된 레코드에 대한 정보가 들어 있습니다. 데이터베이스 트리거는 이러한 추가 테이블을 채우는 데 사용되므로 특정 테이블에서 새 작업이 수행되는 경우(레코드가 추가/수정/제거됨) 이러한 데이터베이스 트리거는 이 작업에 대한 정보를 추가 테이블에 저장합니다. 델타 마이그레이션 프로세스를 실행하면 Data Migration Tool에서 이 테이블에 처리되지 않은 레코드가 있는지 확인하고 필요한 콘텐츠를 Magento 2 데이터베이스로 마이그레이션합니다.

각 새 테이블에는 다음이 포함되어 있습니다.

  • m2_cl 접두사
  • INSERT, UPDATE, DELETE 이벤트 트리거입니다.

예를 들어 sales_flat_order에 대해 Data Migration Tool이(가) 다음을 만듭니다.

  • m2_cl_sales_flat_order 테이블:

    code language-sql
    CREATE TABLE `m2_cl_sales_flat_order` (
      `entity_id` int(11) NOT NULL COMMENT 'Entity_id',
      `operation` text COMMENT 'Operation',
      `processed` tinyint(1) NOT NULL DEFAULT '0' COMMENT 'Processed',
      PRIMARY KEY (`entity_id`)
    ) COMMENT='m2_cl_sales_flat_order';
    
  • trg_sales_flat_order_after_insert, trg_sales_flat_order_after_update, trg_sales_flat_order_after_delete 트리거:

    code language-sql
    DELIMITER ;;
    CREATE TRIGGER `trg_sales_flat_order_after_insert` AFTER INSERT ON `sales_flat_order`
      FOR EACH ROW
      BEGIN
       INSERT INTO m2_cl_sales_flat_order (`entity_id`, `operation`) VALUES (NEW.entity_id, 'INSERT')ON DUPLICATE KEY UPDATE operation = 'INSERT';
      END
    ;;
    
    DELIMITER ;;
    CREATE TRIGGER `trg_sales_flat_order_after_update` AFTER UPDATE ON `sales_flat_order`
      FOR EACH ROW
      BEGIN
       INSERT INTO m2_cl_sales_flat_order (`entity_id`, `operation`) VALUES (NEW.entity_id, 'UPDATE') ON DUPLICATE KEY UPDATE operation = 'UPDATE';
      END
    ;;
    
    DELIMITER ;;
    CREATE TRIGGER `trg_sales_flat_order_after_delete` AFTER DELETE ON `sales_flat_order`
      FOR EACH ROW
      BEGIN
       INSERT INTO m2_cl_sales_flat_order (`entity_id`, `operation`) VALUES (OLD.entity_id, 'DELETE')ON DUPLICATE KEY UPDATE operation = 'DELETE';
      END
    ;;
    
NOTE
Data Migration Tool이(가) 실행될 때 현재 진행 상황을 저장합니다. 오류 또는 사용자 개입으로 인해 실행이 중지되면 도구는 마지막으로 알려진 양호한 상태에서 진행을 다시 시작합니다. Data Migration Tool을(를) 처음부터 강제로 실행하려면 --reset 인수를 사용합니다. 이 경우 이전에 마이그레이션된 데이터가 중복되지 않도록 Magento 2 데이터베이스 덤프를 복원하는 것이 좋습니다.

가능한 일관성 오류

실행하는 동안 Data Migration Tool에서 Magento 1과 Magento 2 데이터베이스 간의 불일치를 보고하고 다음과 같은 메시지를 표시할 수 있습니다.

  • Source documents are missing: <EXTENSION_TABLE_1>,<EXTENSION_TABLE_2>,...<EXTENSION_TABLE_N>
  • Destination documents are missing: <EXTENSION_TABLE_1>,<EXTENSION_TABLE_2>,...<EXTENSION_TABLE_N>
  • Source documents are not mapped: <EXTENSION_TABLE_1>,<EXTENSION_TABLE_2>,...<EXTENSION_TABLE_N>
  • Destination documents are not mapped: <EXTENSION_TABLE_1>,<EXTENSION_TABLE_2>,...<EXTENSION_TABLE_N>
  • Source fields are missing. Document: <EXTENSION_TABLE>. Fields: <FIELD_1>,<FIELD_2>...<FIELD_N>
  • Destination fields are missing. Document: <EXTENSION_TABLE>. Fields: <FIELD_1>,<FIELD_2>...<FIELD_N>
  • Source fields are not mapped. Document: <EXTENSION_TABLE>. Fields: <FIELD_1>,<FIELD_2>...<FIELD_N>
  • Destination fields are not mapped. Document: <EXTENSION_TABLE>. Fields: <FIELD_1>,<FIELD_2>...<FIELD_N>
  • Mismatch of data types. Source document: <EXTENSION_TABLE>. Fields: <FIELD_1>,<FIELD_2>...<FIELD_N>
  • Mismatch of data types. Destination document: <EXTENSION_TABLE>. Fields: <FIELD_1>,<FIELD_2>...<FIELD_N>
  • Incompatibility in data. Source document: <EXTENSION_TABLE>. Field: <FIELD>. Error: <ERROR_MESSAGE>
  • Incompatibility in data. Destination document: <EXTENSION_TABLE>. Field: <FIELD>. Error: <ERROR_MESSAGE>

자세한 내용 및 권장 사항은 이 안내서의 문제 해결 섹션을 참조하십시오.

다음 마이그레이션 단계

변경 사항 마이그레이션

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3