설명서Commerce도구

ACP2E-5009: 콘텐츠 스테이징 마이그레이션이 잘못된 업데이트를 만들고 setup:upgrade 속도를 줄입니다.

마지막 업데이트: 2026년 10월 23일

작성 대상:

  • Experienced
  • 관리자
  • 개발자

ACP2E-5009 패치는 Magento Open Source 범주 및 제품 날짜를 Adobe Commerce의 컨텐츠 스테이징 예약 업데이트로 마이그레이션하는 데이터 패치가 범주에 대해 빈 예약 업데이트를 만들고, 이전 실행에서 빈 날짜 값이 남아 있는 경우 모든 제품 날짜를 건너뛰고, 많은 범주 및 저장소 보기가 있는 카탈로그에서 setup:upgrade을(를) 매우 느리게 만드는 문제를 해결했습니다. 이 패치는 Quality Patches Tool (QPT) 1.1.84가 설치되어 있을 때 사용할 수 있습니다. 패치 ID는 ACP2E-5009입니다. 이 문제는 Adobe Commerce 2.4.10에서 수정됩니다.

영향을 받는 제품 및 버전

Adobe Commerce 버전에 대한 패치가 만들어졌습니다.

  • Adobe Commerce(모든 배포 방법) 2.4.8-p3

Adobe Commerce 버전과 호환:

  • Adobe Commerce(모든 배포 방법) 2.4.5 - 2.4.9
NOTE
새 Quality Patches Tool 릴리스가 있는 다른 버전에 패치를 적용할 수 있습니다. 패치가 Adobe Commerce 버전과 호환되는지 확인하려면 magento/quality-patches 패키지를 최신 버전으로 업데이트하고 Quality Patches Tool에서 호환성을 확인합니다. 패치 검색 페이지. 패치 ID를 검색 키워드로 사용하여 패치를 찾습니다.

문제

Magento Open Source 범주 및 제품 날짜를 Adobe Commerce의 컨텐츠 스테이징 예약 업데이트로 마이그레이션하는 데이터 패치는 범주에 대한 빈 예약 업데이트를 만들고, 이전 실행에서 빈 날짜 값이 남아 있는 경우 모든 제품 날짜를 건너뛰며, 많은 범주 및 스토어 보기가 있는 카탈로그에서 setup:upgrade을(를) 매우 느리게 만듭니다.

필수 구성 요소:

Magento Open Source을 Adobe Commerce으로 업그레이드합니다.

NOTE
Magento Open Source에는 컨텐츠 스테이징이 없으므로 Adobe Commerce이 Magento Open Source 데이터베이스에 설치되면 MigrateCatalogProducts 데이터 패치가 범주 및 제품 날짜를 컨텐츠 스테이징 예약 업데이트로 변환합니다.

Adobe Commerce에서 데이터 패치를 다시 실행하려면 patch_list 테이블에서 데이터 패치를 제거하십시오.

DELETE FROM patch_list WHERE patch_name = 'Magento\\CatalogStaging\\Setup\\Patch\\Data\\MigrateCatalogProducts';

재현 단계:

Magento Open Source에서 마이그레이션:

  1. Magento Open Source에서 여러 범주의 Schedule Design Update 섹션에서 Schedule Update From 및 To​을(를) 설정합니다. To​을(를) 비워 두고 과거 날짜와 미래 날짜를 모두 사용하십시오.
  2. 여러 제품에서 Advanced Pricing​에 Special Price From 및 To​이(가) 있는 Special Price​을(를) 설정하고, 과거 날짜와 미래 날짜를 모두 사용하여 Set Product as New From 및 To​을(를) 설정하십시오.
  3. 이 Magento Open Source 데이터베이스에 Adobe Commerce을 설치하고 bin/magento setup:upgrade을(를) 실행합니다.
  4. Content > Content Staging > Dashboard(으)로 이동하여 범주 및 제품에 대해 만들어진 예약된 업데이트를 확인합니다. 범주 및 제품을 열고 Scheduled Changes 상자를 선택합니다.
  5. 데이터 패치를 다시 실행하십시오. patch_list 테이블에서 데이터 패치를 제거하고( 필수 구성 요소 참조) bin/magento setup:upgrade을(를) 실행한 다음 var/log/exception.log을(를) 확인하십시오.

성능:

  1. Adobe Commerce에서 180개의 스토어 보기 및 8,000개의 카테고리를 만듭니다.
  2. time bin/magento setup:upgrade을(를) 실행하고 경과 시간을 기록합니다.
  3. patch_list 테이블에서 데이터 패치를 제거하고(필수 구성 요소 참조) time bin/magento setup:upgrade을(를) 다시 실행합니다.

예상 결과:

Magento Open Source에서 마이그레이션:

  1. 날짜가 Schedule Design Update​인 각 범주에는 동일한 날짜의 범주가 포함된 예정된 업데이트가 있습니다.
  2. 날짜가 Special Price 또는 Set Product as New​인 각 제품에는 동일한 값과 날짜로 예약된 업데이트가 있습니다.
  3. 날짜가 없는 카테고리 및 제품에는 예정된 업데이트가 없습니다.
  4. 데이터 패치가 다시 실행되면 빈 제품 날짜 값이 무시되고 오류가 기록되지 않습니다.

성능:
두 번째 setup:upgrade 실행이 빠르게 완료됩니다. 데이터 패치는 예약된 디자인 날짜 없이 범주를 건너뜁니다.

실제 결과:

Magento Open Source에서 마이그레이션:

  1. 범주에 대해 만들어진 예약된 업데이트에는 범주가 포함되지 않습니다.
  2. 데이터 패치가 다시 실행되면 이전 실행에서 남은 첫 번째 빈 제품 날짜 값에서 중지되고 제품 날짜가 마이그레이션되지 않습니다.

성능:

  1. 두 번째 setup:upgrade 실행은 첫 번째 실행의 14초와 비교하여 약 47분이 소요됩니다.
  2. 데이터 패치는 모든 스토어 보기에 대해 모든 카테고리를 로드하고(180개 스토어 보기 및 8,000개 카테고리에 대해 약 140만 카테고리 로드) 변경 내용을 적용하지 않습니다. 대규모 카탈로그에 배포하는 데 몇 시간이 걸릴 수 있습니다.

패치 적용

개별 패치를 적용하려면 배포 방법에 따라 다음 링크를 사용합니다.

관련 읽기

Quality Patches Tool에 대한 자세한 내용은 다음을 참조하세요.

recommendation-more-help
commerce-operations-help-tools