从 Salesforce Commerce Cloud 实体中读取
先决条件
-
要从中读取内容的 Salesforce Commerce Cloud 对象。请参阅下面的支持的实体表,查看可用的实体。
支持的实体
| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select * | 支持分区 |
|---|---|---|---|---|---|
| 分配 | 支持 | 是 | 是 | 是 | 是 |
| 市场活动 | 支持 | 是 | 是 | 是 | 是 |
| 目录 | 支持 | 是 | 是 | 是 | 是 |
| 类别 | 支持 | 是 | 是 | 是 | 是 |
| 优惠券 | 支持 | 是 | 是 | 是 | 是 |
| Gift Certificates | 支持 | 是 | 是 | 是 | 是 |
| 产品 | 支持 | 是 | 是 | 是 | 是 |
| Promotions | 支持 | 是 | 是 | 是 | 是 |
| Source Code Groups | 支持 | 是 | 是 | 是 | 是 |
示例
salesforce_commerce_cloud_read = glueContext.create_dynamic_frame.from_options( connection_type="SalesforceCommerceCloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "campaign", "API_VERSION": "v1" } )
Salesforce Commerce Cloud 实体和字段详细信息
实体列表:
-
Assignments:https://developer.salesforce.com/docs/commerce/commerce-api/references/assignments
-
Campaigns:https://developer.salesforce.com/docs/commerce/commerce-api/references/campaigns
-
Catalogs:https://developer.salesforce.com/docs/commerce/commerce-api/references/catalogs
-
Gift Certificates:https://developer.salesforce.com/docs/commerce/commerce-api/references/gift-certificates
-
Products:https://developer.salesforce.com/docs/commerce/commerce-api/references/products
-
Promotions:https://developer.salesforce.com/docs/commerce/commerce-api/references/promotions
-
Source Code Groups:https://developer.salesforce.com/docs/commerce/commerce-api/references/source-code-groups
对查询进行分区
如果您想在 Spark 中利用并发,可以提供附加 Spark 选项 PARTITION_FIELD、LOWER_BOUND、UPPER_BOUND 和 NUM_PARTITIONS。使用这些参数,原始查询将被拆分为 NUM_PARTITIONS 个子查询,这些子查询可以由 Spark 任务同时执行。
-
PARTITION_FIELD:用于对查询进行分区的字段的名称。 -
LOWER_BOUND:所选分区字段的包含下限值。对于日期,我们接受 Spark SQL 查询中使用的 Spark 日期格式。有效值示例:
"2024-02-06"。 -
UPPER_BOUND:所选分区字段的排除上限值。 -
NUM_PARTITIONS:分区的数量。
基于实体的分区字段支持详细信息如下表中所示:
| 实体 | 分区字段 | DataType |
|---|---|---|
| 市场活动 | lastModified | 日期时间 |
| 市场活动 | startDate | 日期时间 |
| 市场活动 | endDate | 日期时间 |
| 目录 | creationDate | 日期时间 |
| 类别 | creatiionDate | 日期时间 |
| Gift Certificates | merchantId | 字符串 |
| Gift Certificates | creatiionDate | 日期时间 |
| 产品 | creatiionDate | 日期时间 |
| 产品 | lastModified | 日期时间 |
| Source Code Groups | creationDate | 日期时间 |
| Source Code Groups | startTime | 日期时间 |
| Source Code Groups | endTime | 日期时间 |
示例
salesforceCommerceCloud_read = glueContext.create_dynamic_frame.from_options( connection_type="SalesforceCommerceCloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "coupons", "API_VERSION": "v1", "PARTITION_FIELD": "creationDate", "LOWER_BOUND": "2020-05-01T20:55:02.000Z", "UPPER_BOUND": "2024-07-11T20:55:02.000Z", "NUM_PARTITIONS": "10" } )