# 从 HubSpot 实体中读取
<a name="hubspot-reading-from-entities"></a>

**先决条件**

您要从中读取内容的 HubSpot 对象。您将需要联系人或任务等对象名称。下表显示了同步源支持的实体。

## 同步源支持的实体
<a name="sync-table"></a>


| 实体 | API 版本 | 可以筛选 | 支持限制 | 支持排序依据 | 支持选择\* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | --- | 
| 市场活动 | v1 | 否 | 是 | 否 | 是 | 否 | 
| 公司 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 联系人 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 联系人列表 | v1 | 否 | 是 | 否 | 是 | 否 | 
| 交易 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| CRM 管道（交易管道） | v1 | 否 | 否 | 否 | 是 | 否 | 
| 电子邮件事件 | v1 | 否 | 是 | 否 | 是 | 否 | 
| Calls | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 备注 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 电子邮件 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 会议 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 任务 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 邮政邮件 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 自定义对象 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 表单 | v2 | 否 | 否 | 否 | 是 | 否 | 
| 所有者 | v3 | 否 | 是 | 否 | 是 | 否 | 
| 产品 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 工单 | v3 | 支持 | 是 | 是 | 是 | 是 | 
| 工作流 | v3 | 否 | 否 | 否 | 是 | 否 | 
| Associations | v4 | 是 | 否 | 否 | 是 | 否 | 
| 关联标签 | v4 | 否 | 否 | 否 | 是 | 否 | 

**示例：**

```
hubspot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="hubspot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "contact",
        "API_VERSION": "v3"
    }
```

## 异步源支持的实体
<a name="async-table"></a>


| 实体 | API 版本 | 可以筛选 | 支持限制 | 支持排序依据 | 支持选择\* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | --- | 
| 公司 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 联系人 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 交易 | v3 | 是 | 否 | 是 | 是 | 否 | 
| Calls | v3 | 是 | 否 | 是 | 是 | 否 | 
| 备注 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 电子邮件 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 会议 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 任务 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 邮政邮件 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 自定义对象 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 产品 | v3 | 是 | 否 | 是 | 是 | 否 | 
| 工单 | v3 | 是 | 否 | 是 | 是 | 否 | 

**示例：**

```
hubspot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="hubspot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "contact",
        "API_VERSION": "v3",
        "TRANSFER_MODE": "ASYNC"
    }
```

**HubSpot 实体和字段详细信息**：

**HubSpot API v4**：



- **关联标签**
  - **API 版本:** v4
  - **字段:** category / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** typeId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** label / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **Associations**
  - **字段:** from / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** "="
  - **字段:** 到 / **数据类型:** 列表 / **支持的运算符:** 不适用



**注意**  
对于 `Associations` 对象，要获取两个对象之间的关联，您需要在创建 AWS Glue 作业时通过强制筛选器提供“from Id”（第一个对象的 ID）。在这种情况下，如果要获取多个 from ID 的关联，则必须在 `where` 子句中提供多个 ID。例如：要获取联系人 ID“1”和“151”的 `Associations`，您需要提供筛选器 `where id=1 AND id=151`。

**HubSpot API v3**：



- **所有者**
  - **字段:** firstName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** lastName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用
  - **字段:** archived / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** teams / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** userId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** 电子邮件 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 日期时间 / **支持的运算符:** 不适用

- **工作流**
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** id / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 已启用 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** insertedAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** contactListIds / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** personaTagIds / **数据类型:** 列表 / **支持的运算符:** 不适用



对于以下实体，HubSpot 提供用于动态获取元数据的端点，以便在每个实体的数据类型级别捕获运算符支持。

**注意**  
`DML_STATUS` 是在运行时添加到每条记录上的虚拟字段，用于在同步模式下确定字段状态（CREATED/UPDATED）。异步模式下不支持 `CONTAINS/LIKE` 运算符。



- **联系人**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **公司**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **交易**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **工单**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **产品**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **自定义对象**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **Call**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **电子邮件**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **会议**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **注意**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **Task**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用

- **邮政邮件**
  - **数据类型:** 整数 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 长整型 / **支持的运算符:** "=, \!=, <, >, >=, <="
  - **数据类型:** 字符串 / **支持的运算符:** "=, \!=, LIKE"
  - **数据类型:** 日期 / **支持的运算符:** 不适用
  - **数据类型:** 日期时间 / **支持的运算符:** "between"
  - **数据类型:** 布尔值 / **支持的运算符:** "="
  - **数据类型:** 列表 / **支持的运算符:** 不适用
  - **数据类型:** 结构体 / **支持的运算符:** 不适用



**HubSpot API v2**：



- **表单**
  - **字段:** portalId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** guid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** method / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** cssClass / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 重定向 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** submitText / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** notifyRecipients / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** ignoreCurrentValues / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** deletable / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** inlineMessage / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** captchaEnabled / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** cloneable / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** formFieldGroups / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** editable / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** deletedAt / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** themeName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** parentId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** style / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** isPublished / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** publishAt / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** unpublishAt / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** publishedAt / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** kickbackEmailWorkflowId / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** kickbackEmailsJson / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** customUid / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** createMarketableContact / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** editVersion / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** thankYouMessageJson / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** themeColor / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** alwaysCreateNewCompany / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** internalUpdatedAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** businessUnitId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** portableKey / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** paymentSessionTemplateIds / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** selectedExternalOptions / **数据类型:** 列表 / **支持的运算符:** 不适用



**HubSpot API v1**：



- **活动**
  - **字段:** id / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** appId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** appName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** lastUpdatedTime / **数据类型:** 长整型 / **支持的运算符:** 不适用

- **Contact\_List**
  - **字段:** dynamic / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 名称 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** portalId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** createdAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** listId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** updatedAt / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** ListType / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** filters / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** authorId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** metaData / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** archived / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** ilsFilterBranch / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** filterIds / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** limitExempt / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** 内部 / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** readOnly / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** parentId / **数据类型:** 整数 / **支持的运算符:** 不适用

- **Email\_Event**
  - **字段:** id / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** recipient / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** portalId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** appId / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** appName / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** emailCampaignId / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** attempt / **数据类型:** 整数 / **支持的运算符:** 不适用
  - **字段:** created / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** sentBy / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** smtpId / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 响应 / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** subject / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** cc / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** bcc / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** replyTo / **数据类型:** 列表 / **支持的运算符:** 不适用
  - **字段:** from / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** dropReason / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** dropMessage / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** 浏览器 / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** userAgent / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** duration / **数据类型:** 长整型 / **支持的运算符:** 不适用
  - **字段:** location / **数据类型:** 结构体 / **支持的运算符:** 不适用
  - **字段:** filteredEvent / **数据类型:** 布尔值 / **支持的运算符:** 不适用
  - **字段:** deviceType / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** suppressedReason / **数据类型:** 字符串 / **支持的运算符:** 不适用
  - **字段:** suppressedMessage / **数据类型:** 字符串 / **支持的运算符:** 不适用

- **CRM\_Pipeline**
  - **字段:**  pipelineId
  - **数据类型:** 字符串
  - **支持的运算符:** 不适用

- ****
  - **字段:** createdAt
  - **数据类型:** 长整型
  - **支持的运算符:** 不适用

- ****
  - **字段:** updatedAt
  - **数据类型:** 长整型
  - **支持的运算符:** 不适用

- ****
  - **字段:** objectType
  - **数据类型:** 字符串
  - **支持的运算符:** 不适用

- ****
  - **字段:** label
  - **数据类型:** 字符串
  - **支持的运算符:** 不适用

- ****
  - **字段:** displayOrder
  - **数据类型:** 整数
  - **支持的运算符:** 不适用

- ****
  - **字段:** active
  - **数据类型:** 布尔值
  - **支持的运算符:** 不适用

- ****
  - **字段:** 阶段
  - **数据类型:** 列表
  - **支持的运算符:** 不适用

- ****
  - **字段:** objectTypeId
  - **数据类型:** 字符串
  - **支持的运算符:** 不适用

- ****
  - **字段:** 默认值
  - **数据类型:** 布尔值
  - **支持的运算符:** 不适用



## 对查询进行分区
<a name="hubspot-reading-partitioning-queries"></a>

如果您想在 Spark 中利用并发，可以提供其他 Spark 选项：`PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND` 和 `NUM_PARTITIONS`。使用这些参数，原始查询将被拆分为 `NUM_PARTITIONS` 个子查询，这些子查询可以由 Spark 任务同时执行。
+ `PARTITION_FIELD`：用于对查询进行分区的字段的名称。
+ `LOWER_BOUND`：所选分区字段的**包含**下限值。

  对于日期时间字段，我们接受 ISO 格式的值。

  有效值示例：

  ```
  “2024-01-01T10:00:00.115Z" 
  ```
+ `UPPER_BOUND`：所选分区字段的**排除**上限值。
+ `NUM_PARTITIONS`：分区的数量。

下表描述实体分区字段支持详细信息：



- **contact**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, lastmodifieddate / **数据类型:** 日期时间

- **company**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **deal**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **ticket**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **产品**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **custom\_object**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **call**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **电子邮件**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **会议**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **note**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **task**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间

- **postal\_mail**
  - **分区字段:** hs\_object\_id / **数据类型:** 长整型
  - **分区字段:** createdate, hs\_lastmodifieddate / **数据类型:** 日期时间



示例：

```
hubspot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="hubspot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "company",
        "API_VERSION": "v3",
        "PARTITION_FIELD": "hs_object_id"
        "LOWER_BOUND": "50"
        "UPPER_BOUND": "16726619290"
        "NUM_PARTITIONS": "10"
    }
```