使用Commerce CLI同步摘要

Last update: Wed Apr 16 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

管理員

magento/saas-export封裝中的saas:resync命令可讓您管理Adobe Commerce SaaS服務的資料同步處理。

Adobe不建議定期使用saas:resync命令。使用指令的典型情況如下：

初始同步
變更SaaS資料空間ID後，將資料同步處理至新資料空間
疑難排解

監視var/log/saas-export.log檔案中的同步作業。

初始同步

NOTE

啟用「即時搜尋」或「產品推薦」時，初始同步會自動執行。不需要手動指令。

當您從命令列觸發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命令支援各種同步作業：

透過SKU進行部分同步
繼續已中斷的同步
驗證資料而不同步

檢視所有可用選項：

bin/magento saas:resync --help

如需選項說明及範例，請參閱下列章節。

NOTE

如需管理匯出處理的進階選項，請參閱自訂匯出處理。

`--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選項搭配使用，該作業會針對所有專案執行試執行重新同步作業。

IMPORTANT

僅在環境清理後使用，或搭配--dry-run選項使用。如果用於其他情況，清理操作會導致資料遺失和資料同步問題，其中必須刪除的Adobe Commerce專案將不會從SaaS資料空間刪除。

範例：

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

`--continue-resync`

繼續執行中斷的重新同步作業。僅支援products、productAttributes和productOverrides摘要。

範例：

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

`--dry-run`

執行摘要重新索引程式，而不將摘要提交至SaaS且不儲存至摘要表格。此選項對於識別資料集的任何問題很有用。

新增EXPORTER_EXTENDED_LOG=1環境變數以將裝載儲存至var/log/saas-export.log。

範例：

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`

必填。指定要重新同步的摘要實體。

可用的摘要：

categories
categoryPermissions
inventoryStockStatus
orders
prices
products
productAttributes
productOverrides
scopesWebsite
scopesCustomerGroup
variants

範例：

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-type=ProductId選項，依產品ID指定實體。

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

範例：

疑難排解

如果您在連線的Commerce服務中未看到預期的資料，請檢查資料匯出錯誤記錄檔，並使用saas:resync命令搭配環境變數來檢閱裝載和效能分析工具資料，以疑難排解問題。檢視檢閱記錄檔及疑難排解。

recommendation-more-help

84c95778-e795-4ef1-8b7e-54d73e45e22d