Commerce CLI를 사용하여 피드 동기화

magento/saas-export 패키지의 saas:resync 명령을 사용하면 Adobe Commerce SaaS 서비스에 대한 데이터 동기화를 관리할 수 있습니다.

Adobe에서는 saas:resync 명령을 정기적으로 사용하지 않는 것이 좋습니다. 명령 사용에 대한 일반적인 시나리오는 다음과 같습니다.

var/log/saas-export.log 파일에서 동기화 작업을 모니터링합니다.

초기 동기화

명령줄에서 saas:resync을(를) 트리거할 때 카탈로그 크기에 따라 데이터를 업데이트하는 데 몇 분에서 몇 시간이 걸릴 수 있습니다.

초기 동기화의 경우 Adobe에서는 다음 순서로 명령을 실행하는 것이 좋습니다.

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

CLI 명령을 사용하여 동기화

saas:resync 명령은 다양한 동기화 작업을 지원합니다.

사용 가능한 모든 옵션 보기:

bin/magento saas:resync --help

예가 포함된 옵션 설명은 다음 섹션을 참조하십시오.

--by-ids

특정 엔티티를 해당 ID별로 부분적으로 다시 동기화합니다. products, productAttributes, productOverrides, inventoryStockStatus, prices, variants 및 categoryPermissions 피드를 지원합니다.

기본적으로 엔티티는 제품 SKU별로 쉼표로 구분된 목록으로 지정됩니다. 대신 제품 ID를 사용하려면 --id-type=ProductID 옵션을 추가하십시오.

예:

bin/magento saas:resync --feed products --by-ids='ADB102,ADB111,ADB112'

bin/magento saas:resync --feed= products --by-ids='1,2,3' --id-type='productId'

--cleanup-feed

데이터를 다시 인덱싱하여 SaaS로 보내기 전에 피드 인덱서 테이블에서 피드 테이블을 정리합니다. products, productAttributes, productOverrides, inventoryStockStatus, prices, variants 및 categoryPermissions에 대해서만 지원됩니다.

--dry-run 옵션과 함께 사용하는 경우 작업은 모든 항목에 대해 시험 실행 다시 동기화 작업을 수행합니다.

예:

bin/magento saas:resync --feed products --cleanup-feed

--continue-resync

중단된 재동기화 작업을 다시 시작합니다. products, productAttributes 및 productOverrides 피드에서만 지원됩니다.

예:

bin/magento saas:resync --feed productAttributes --continue-resync

--dry-run

SaaS에 피드를 제출하지 않고 피드 테이블에 저장하지 않고 피드 색인 재지정 프로세스를 실행합니다. 이 옵션은 데이터 세트와 관련된 문제를 식별하는 데 유용합니다.

페이로드를 var/log/saas-export.log에 저장하려면 EXPORTER_EXTENDED_LOG=1 환경 변수를 추가하십시오.

예:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run

특정 피드 항목 테스트

확장된 로그 컬렉션과 함께 --by-ids 옵션을 추가하여 특정 피드 항목을 테스트하여 var/log/saas-export.log 파일에서 생성된 페이로드를 확인합니다.

예:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='1,2,3'

모든 피드 항목 테스트

기본적으로 resync --dry-run 작업 중에 제출된 피드에는 새 항목이나 이전에 내보내지 못한 항목만 포함됩니다. 처리할 피드에 모든 항목을 포함하려면 --cleanup-feed 옵션을 사용하십시오.

예

bin/magento saas:resync --feed products --dry-run --cleanup-feed

--feed

필수. 다시 동기화할 피드 엔티티를 지정합니다.

사용 가능한 피드:

예:

bin/magento saas:resync --feed products

--no-reindex

리인덱싱하지 않고 기존 카탈로그 데이터를 Commerce Services에 다시 제출합니다. 제품 관련 피드에 대해서는 지원되지 않습니다.

동작은 내보내기 모드마다 다릅니다.

예:

bin/magento saas:resync --feed productAttributes --no-reindex

--id-type=ProductId

기본적으로 --by-ids 옵션과 함께 saas:resync feed 명령을 사용할 때 지정된 엔터티는 제품 SKU에서 지정됩니다. 제품 ID별로 엔터티를 지정하려면 --id-type=ProductId 옵션을 사용하십시오.

bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'

예:

문제 해결

연결된 Commerce 서비스에 예상 데이터가 표시되지 않으면 데이터 내보내기 오류 로그를 확인하고 환경 변수와 함께 saas:resync 명령을 사용하여 페이로드 및 프로파일러 데이터를 검토하여 문제를 해결하십시오. 로그 검토 및 문제 해결을 참조하세요.