使用 Apache Iceberg 连接器摄取 B2C Commerce 域数据
设置 Apache Iceberg 文件联合连接以将 B2C Commerce 域数据(包括产品、订单、客户概况以及产品和客户概况的自定义属性) Data 360引入 。
所需的 Edition
| 可用于:B2C Commerce |
| 所需的用户权限 | |
|---|---|
| 要创建连接,请执行以下操作: | 系统管理员配置文件或 Data Cloud Architect 权限集 |
在设置 Apache Iceberg 连接之前,请完成以下先决条件步骤:
- Configure Catalog and Order Feeds for Commerce Cloud Einstein Deployment(为 Commerce Cloud Einstein 部署配置目录和订单源)
- 配置已注册购物者资料的导出
使用 Apache Iceberg 文件联合连接器,可以将所有 B2C Commerce 域数据摄取到 Data 360中。这包括:
- 产品(商品产品、主产品、套装)
- 产品目录和分类
- 销售订单和订单明细
- 客户概况
- 产品和客户资料的自定义属性
设置连接后,必须手动将源对象映射到数据模型对象 (DMO)。有关可用源对象及其映射的信息,请参阅 B2C Commerce 域数据映射。有关源表架构的详细信息,请参阅 B2C Commerce Lakehouse 架构参考。
- 在 Data 360 中,单击“ 设置 ”,然后选择“ Data Cloud 设置”。
- 在“外部集成”下,选择 “其他连接器”。
- 点击新建。
- 在“源”选项卡上,选择“ Apache Iceberg 文件联合 ”,然后单击 “下一步”。
- 输入连接名称和连接 API 名称。
-
输入身份验证详细信息。
B2C Commerce 数据存储的REST目录支持存储凭证自动售卖,因此请选择“存储类型”作为 CATALOG_PROVIDED。
对于REST目录,在 “客户端访问令牌 ”字段中,输入 Base64 编码值
{tenant_id}:{account_manager_client_id}:{account_manager_client_secret}。要获取这些值:
- tenant_id:租户 ID 是 B2C Commerce 组织 ID 的一部分。组织 ID 的格式为
f_ecom_{tenant_id}。例如,如果组织 ID 为f_ecom_zzzz_001,则租户 ID 为zzzz_001。 - account_manager_client_id:在 Account Manager 中创建 API 客户端时生成的客户端 ID。
- account_manager_client_secret:在 Account Manager 中创建 API 客户端时设置的密码。
Account Manager 客户端必须具有 Salesforce Commerce API 角色。分配此角色后,请使用实例筛选器查找并添加您的生产 B2C Commerce 实例。
有关创建 Account Manager API 客户端的信息,请参阅 在 B2C Commerce 中添加 API 客户端。在执行该主题中的步骤为 Iceberg 连接器设置 API 客户端时,请执行步骤 9(使用实例筛选器分配 Salesforce Commerce API 角色),因为这是 Iceberg 连接器所必需的。请勿执行步骤 10 和 11(默认范围和 OpenID Connect 设置),因为它们不适用于此连接器。
- tenant_id:租户 ID 是 B2C Commerce 组织 ID 的一部分。组织 ID 的格式为
-
输入连接详细信息。
对于 Catalog Endpoint ,输入 Apache Iceberg REST 目录的 Data Cloud 可访问 HTTPS URL:
https://iceberg-catalog.analytics.commercecloud.salesforce.com将可选的 “仓库 ”字段留空。
- 若要查看配置,请单击 “测试连接”。
-
点击保存。
接受连接器详细信息后,将创建连接并将其列在“连接器”下。现在,您可以创建数据流并将 B2C Commerce 数据映射到 DMO。
设置连接后,为要摄取的 B2C Commerce 对象创建数据流。有关创建数据流以及将源对象映射到 DMO 的信息,请参阅 创建 Apache Iceberg 文件联合数据流。
- B2C Commerce 域数据映射
使用 Apache Iceberg 连接器摄取 B2C Commerce 域数据时,必须手动将这些源对象映射到 中的数据模型对象 (DMO)。 Data 360 - B2C Commerce Lakehouse 架构参考
B2C Commerce Data Lakehouse 将产品目录、客户和销售订单数据存储在使用ccdl_前缀的实体表中。

