目录同步

NOTE
“目录同步”功能板现在是“数据管理功能板”。 此改版后的功能板现在支持 Product RecommendationsLive Search、和 Catalog Service. 客户可以通过更新到其中一项服务的最新版本来获取数据管理功能板。 欲知更多信息,请参阅 数据管理功能板 文档。 对于尚未升级但仍拥有目录同步功能板的用户,此当前主题仍然适用。

Adobe Commerce使用索引器将目录数据编译到表中。 该进程由自动触发 事件 例如产品价格或库存水平改变。

目录同步服务将产品数据从 Adobe Commerce 实例到 Commerce Services 平台,持续保持数据最新。 例如, Product Recommendations 需要当前的目录信息才能准确地返回具有正确名称、定价和可用性的推荐。 使用 目录同步 仪表板来观察和管理同步过程或 命令行界面 触发目录同步并重新索引产品数据以供使用: Commerce Services.

访问目录同步仪表板

要访问“目录同步”仪表板,请选择 系统 > 数据传输 > 目录同步.

使用 目录同步 功能板您可以:

  • 查看同步状态(进行中成功失败)
  • 查看同步的产品总数
  • 搜索同步的产品以查看其当前状态
  • 按名称、SKU等搜索存储目录。
  • 在JSON中查看同步的产品详细信息,以帮助诊断同步差异
  • 重新启动同步过程

上次同步

报告同步状态:

  • 成功 — 显示同步成功的日期和时间以及更新的产品数
  • 失败 — 显示尝试同步的日期和时间
  • 进行中 — 显示上次成功同步的日期和时间

目录同步过程每小时自动运行一次。 如果您在店面中没有看到预期的产品,或者这些产品没有反映您最近所做的更改,您可以解决 目录同步问题.

产品已同步

显示从您的 Commerce 目录。 初次同步后,只应同步已更改的产品。

重新同步 resync

如果在进行每小时计划同步之前必须启动目录的重新同步,则可以强制进行重新同步。

NOTE
强制重新同步会触发整个产品目录的重新同步,这会增加硬件资源的负载。
  1. 目录同步 仪表板,选择 设置.

    目录同步设置 页面。

  2. 重新同步数据 部分,单击 Resync.

    Commerce 在下一个计划同步窗口同步您的目录。 根据目录的大小,此操作可能需要较长时间。

已同步的目录产品

已同步的目录产品 表格显示了以下信息。

字段
描述
ID
产品的唯一标识符
名称
产品的店面名称
类型
标识产品类型,例如简单、可配置或可下载
上次导出
上次成功从目录中导出产品的日期
上次修改时间
上次在目录中修改产品的日期
SKU
显示产品的库存单位
价格
产品的价格
可见性
产品的可见性设置,如 Commerce 目录

解决目录同步问题 resolvesync

触发数据重新同步时,可能需要长达一小时的时间才能更新数据并反映在UI组件(如推荐单元)中。 如果您仍然看到店面上的目录和数据之间存在差异,或者如果目录同步失败,请参阅以下内容:

数据差异

  1. 在搜索结果中显示相关产品的详细视图。
  2. 复制JSON输出,并验证内容是否与您在 Commerce 目录。
  3. 如果内容不匹配,请对目录中的产品进行细微更改,例如添加空格或句点。
  4. 等待重新同步或 触发手动重新同步.

同步未运行

如果同步未按计划运行或未同步任何内容,请参阅此 知识库 文章。

同步失败

如果目录同步的状态为 失败,提交 支持服务单.

命令行界面 resynccmdline

saas:resync 命令是 magento/saas-export 包,并且随以下任一选项提供现成可用的 Commerce Services 产品,例如 Product RecommendationsLive Search.

NOTE
首次运行数据同步时,请运行 productattributes 首先馈送,然后馈送 productoverrides,然后运行 products 信息源。

命令选项:

bin/magento saas:resync --feed <feed name> [no-reindex|cleanup-feed]

下表描述了 saas:resync 参数和描述。

参数
描述
必需?
feed
指定要重新同步的实体,如 products
no-reindex
将现有目录数据重新提交到 Commerce Services 而不重新索引。 如果未指定此参数,该命令会在同步数据之前运行完整的重新索引。
cleanup-feed
在同步之前清理馈送索引器表。

馈送名称可以是以下名称之一:

  • products — 目录中的产品
  • productattributes — 产品属性,例如 activitygendertopsbottoms,等等
  • variants — 可配置产品的产品变体,如颜色和大小
  • prices — 产品价格
  • scopesCustomerGroup — 客户组
  • scopesWebsite — 有商店视图的网站
  • categories — 目录中的类别
  • categoryPermissions — 每个类别的权限
  • productoverrides — 特定于客户的定价和目录可见性规则,如基于类别权限的那些规则

根据具体情况 Commerce服务 已安装,则可能有不同的源集可用于 saas:resync 命令。

不建议运行 saas:resync 定期执行命令。 在以下两种情况下,您可能需要手动运行命令:

初始同步

当您触发 saas:resync 从命令行中,更新数据可能需要几分钟到几小时的时间,具体取决于您的目录大小。

对于初始同步,建议按以下顺序运行命令:

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

故障排除

如果您在中看不到预期的数据 Commerce Service,检查在从同步期间是否出现问题 Adobe Commerce 实例到 Commerce Service 平台。

中有两个日志文件 var/log/ 目录:

  • commerce-data-export-errors.log — 如果期间发生错误 收集 阶段
  • saas-export-errors.log — 如果期间发生错误 传输 阶段

检查馈送有效负荷

查看已发送给的信息源有效负载可能会很有用 Commerce Service. 可以通过传递环境变量来完成此操作 EXPORTER_EXTENDED_LOG=1. 此 no-reindex 标志表示仅发送当前收集的数据。

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed=products --no-reindex

有效负载位于 var/log/saas-export.log.

在馈送索引表中保留有效负载

起始日期 magento/module-data-exporter:103.0.0 某些信息源:产品信息源、价格信息源,在索引表中仅保留最低要求数据。

不建议在生产环境中保留索引表中的有效负荷数据,但在开发人员实例中可能很有用。 这是通过传递 PERSIST_EXPORTED_FEED=1 环境变量:

PERSIST_EXPORTED_FEED=1 bin/magento saas:resync --feed=products

侧写

如果特定信息源的重新索引过程耗时过长,请运行Profiler以收集可能对支持团队有用的其他数据。 要执行此操作,请传递 EXPORTER_PROFILER=1环境变量:

EXPORTER_PROFILER=1 bin/magento indexer:reindex catalog_data_exporter_products

Profiler数据存储在 var/log/commerce-data-export.log 格式为:

<Provider class name>, <# of processed entities>, <execution time im ms>, <memory consumption in Mb>

提交支持请求

如果您看到与配置或第三方扩展无关的错误,请提交 支持服务单 尽可能多的信息。

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e