SaaS Data Export에 대한 시나리오 문제 해결
이 페이지에서는 SaaS Data Export 작업을 수행할 때 일반적으로 잘못된 구성 또는 동기화 결과 해석으로 인해 발생할 수 있는 동작을 설명합니다. 아래 설명을 사용하여 근본 원인을 식별하고 적절한 해결 방법을 적용하십시오.
Commerce 서비스에서 구성 가능 또는 번들 제품 누락 configurable-bundle-missing
문제: 구성 가능한 또는 번들 제품의 상태가 Adobe Commerce이지만 상점 앞에서 반환되지 않거나 Commerce SaaS 서비스에서 사용 안 함 상태로 표시됩니다.**
원인: 복합 제품의 유효 상태는 상위 제품 상태뿐만 아니라 하위 제품의 상태에 따라 다릅니다. Commerce SaaS 서비스는 다음과 같은 계산된 상태를 반영합니다.
- 구성 가능한 제품 - 하나 이상의 제품 변형을 사용하도록 설정해야 합니다.
- 제품 번들 - 각 필수 번들 옵션에 대해 하나 이상의 제품을 활성화해야 합니다.
이러한 조건이 충족되지 않으면 상위 제품이 자신의 상태가 사용 가능(으)로 설정되어 있어도 사용하지 않는 것으로 처리됩니다.
솔루션:
- 구성 가능한 제품의 경우, 하나 이상의 관련 단순 제품 변형이 활성화되어 있고 올바른 웹 사이트 및 스토어 보기에 할당되어 있는지 확인하십시오.
- 번들 제품의 경우 각 필수 번들 옵션에 하나 이상의 활성화된 하위 제품이 있는지 확인합니다. 모든 장애가 있는 소아가 있는 필수 옵션을 사용하면 전체 번들이 장애인으로 취급됩니다.
- 적절한 하위 제품을 활성화한 후 다시 동기화를 트리거하거나 예약된 다음 동기화를 기다린 다음 Commerce SaaS 서비스에서 업데이트된 상태를 확인합니다.
카탈로그 가격 규칙 활성화 후 가격이 업데이트되지 않음 prices-not-updated
문제: 업데이트 예약 기능을 사용하여 카탈로그 가격 규칙을 활성화한 후 가격이 업데이트되지 않습니다. 예약된 업데이트가 적용된 후 commerce-data-export.log에 prices 피드에 대한 synced: 0이(가) 표시됩니다.
원인: 카탈로그 가격 규칙에 예약된 업데이트를 사용할 때 크론 그룹 간에 경합 조건이 발생할 수 있습니다. catalog_data_exporter_product_prices 인덱서는 해당 종속인 catalogrule_product 인덱스의 다시 작성을 완료하기 전에 실행될 수 있습니다. 그 결과 가격 익스포터가 오래된 데이터를 읽고 변경 사항을 내보냅니다.
솔루션:
이 문제에 대한 즉각적인 수정 사항은 해결 방법입니다. 경쟁 조건을 제거하기 위해 순차적으로 실행되도록 두 cron 그룹을 모두 구성합니다.
-
Stores > Configuration > Advanced > System > Cron (Scheduled Tasks)(으)로 이동합니다.
-
두 항목에 대해 Use Separate Process을(를) No(으)로 설정:
- 그룹에 대한 크론 구성 옵션: index
- 그룹에 대한 크론 구성 옵션: staging
-
저장한 후 구성 캐시를 플러시합니다.
Adobe Commerce과(와) 연결된 서비스 간의 카탈로그 데이터 불일치 catalog-data-discrepancy
문제: 연결된 Commerce 서비스에 표시된 제품 데이터(예: Live Search 또는 Product Recommendations)가 Adobe Commerce의 카탈로그 데이터와 일치하지 않습니다. 예를 들어, 제품 이름, 가격 또는 설명이 상점 앞에 오래되거나 올바르지 않은 것으로 나타납니다.
원인: 재동기화가 트리거된 후 데이터를 업데이트하고 UI 구성 요소에 반영되기까지 최대 한 시간이 걸릴 수 있습니다. 불일치가 해당 창 이상으로 지속되면 마지막 동기화에서 항목을 선택하지 않았거나 피드 데이터가 이미 최신 상태로 표시되었기 때문에 동기화에서 변경 사항을 감지하지 못했을 수 있습니다.
솔루션:
- Commerce 상점에서 검색 결과를 엽니다. 그런 다음 해당 제품을 선택하여 세부 보기를 엽니다.
- JSON 출력을 복사하고 Commerce 카탈로그에 있는 것과 일치하는지 확인합니다.
- 콘텐츠가 일치하지 않으면 공백 또는 마침표 추가와 같이, 카탈로그의 제품에 대한 부분 편집을 수행하여 변경 사항을 감지하도록 합니다.
- 재동기화를 기다리거나 CLI 또는 관리자의 Data Feed Sync Status 페이지에서 수동 재동기화를 트리거하십시오.
Product Recommendations의 카탈로그 데이터 문제 해결에 대한 자세한 내용은 Commerce 기술 자료에서 제품 권장 사항 모듈 문제 해결을 참조하세요.
데이터 동기화가 일정에 따라 실행되고 있지 않음 sync-not-on-schedule
문제: 데이터 동기화가 일정에 따라 실행되지 않거나 Adobe Commerce의 제품 변경 사항에도 불구하고 동기화되는 항목이 없습니다.
원인: 크론 작업이 실행되지 않거나 인덱서가 Update by Schedule 모드에서 구성되지 않은 것이 가장 일반적인 원인입니다.
솔루션:
- cron 작업이 실행 중인지 확인.
- 카탈로그 특성, Product, Product Overrides 및 Product Variant 피드의 인덱서가 Update by Schedule(으)로 설정되어 있는지 확인하십시오. Commerce 관리자 또는 CLI를 사용하여 Index Management에서 확인하십시오.
bin/magento indexer:show-mode | grep -i feed.
카탈로그 동기화가 실패 상태입니다. catalog-sync-failed
문제: 카탈로그 동기화가 Data Feed Sync Status 페이지에서 실패 상태를 표시합니다.
원인: 데이터 수집 또는 제출 단계에서 복구할 수 없는 오류가 발생했습니다. 일반적인 원인에는 API 인증 문제, 네트워크 오류 또는 데이터 유효성 검사 오류가 포함됩니다.
솔루션:
-
오류에 대한 자세한 내용은 데이터 내보내기 오류 로그를 검토하십시오. 로그 형식 및 확장 로깅 옵션에 대해서는 로그 검토 및 문제 해결을 참조하십시오.
- 데이터를 수집하는 동안 오류가 발생한 경우
var/log/commerce-data-export-errors.log. - 데이터를 제출하는 동안 오류가 발생한 경우
var/log/saas-export-errors.log.
- 데이터를 수집하는 동안 오류가 발생한 경우
-
오류가 구성 또는 타사 확장과 관련이 없는 경우 관련 로그 항목을 사용하여 지원 티켓을 제출하십시오.
로그에 “작업 건너뜀 - 프로세스 잠김” 메시지가 표시됨 process-locked
문제: commerce-data-export.log 파일에 다음과 유사한 항목이 있습니다.
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
원인: 이는 오류가 아닌 예상된 동작입니다. 이 메시지는 전체 색인 재지정 또는 saas:resync이(가) 이미 진행 중인 상태에서 크론 트리거된 부분 동기화를 실행하려고 할 때 나타납니다. SaaS Data Export 확장은 피드 잠금 메커니즘을 사용하여 충돌하는 동시 동기화 작업을 방지합니다.
솔루션:
별도의 작업이 필요하지 않습니다. 실행 중인 프로세스가 완료되고 잠금이 해제되면 다음 cron 실행에서 보류 중인 모든 변경 사항을 선택하고 동기화합니다. 잠금 메커니즘의 작동 방식에 대한 자세한 내용은 SaaS 데이터 내보내기를 위한 피드 잠금 메커니즘을 참조하십시오.