# 从 Salesforce Commerce Cloud 实体中读取
<a name="salesforce-commerce-cloud-reading-from-entities"></a>

 **先决条件** 
+  要从中读取内容的 Salesforce Commerce Cloud 对象。请参阅下面的支持的实体表，查看可用的实体。

 **支持的实体** 


| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \$1 | 支持分区 | 
| --- | --- | --- | --- | --- | --- | 
| 分配 | 支持 | 是 | 是 | 是 | 是 | 
| 市场活动 | 支持 | 是 | 是 | 是 | 是 | 
| 目录 | 支持 | 是 | 是 | 是 | 是 | 
| 类别 | 支持 | 是 | 是 | 是 | 是 | 
| 优惠券 | 支持 | 是 | 是 | 是 | 是 | 
| 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]( https://developer.salesforce.com/docs/commerce/commerce-api/references/assignments) 
+  Campaigns：[https://developer.salesforce.com/docs/commerce/commerce-api/references/campaigns](https://developer.salesforce.com/docs/commerce/commerce-api/references/campaigns) 
+  Catalogs：[https://developer.salesforce.com/docs/commerce/commerce-api/references/catalogs](https://developer.salesforce.com/docs/commerce/commerce-api/references/catalogs) 
+  Categories：[https://developer.salesforce.com/docs/commerce/commerce-api/references/catalogs?meta=searchCategories](https://developer.salesforce.com/docs/commerce/commerce-api/references/catalogs?meta=searchCategories) 
+  Gift Certificates：[https://developer.salesforce.com/docs/commerce/commerce-api/references/gift-certificates](https://developer.salesforce.com/docs/commerce/commerce-api/references/gift-certificates) 
+  Products：[https://developer.salesforce.com/docs/commerce/commerce-api/references/products](https://developer.salesforce.com/docs/commerce/commerce-api/references/products) 
+  Promotions：[https://developer.salesforce.com/docs/commerce/commerce-api/references/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](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"
     }
)
```