本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 從 HubSpot 實體讀取
**必要條件**
您要從中讀取的 HubSpot 物件。您將需要物件名稱，例如聯絡人或任務。下表顯示 Sync 來源支援的實體。
## 同步來源支援的實體
| 實體 | API 版本 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \$1 | 支援分區 |
| --- | --- | --- | --- | --- | --- | --- |
| 行銷活動 | v1 | 否 | 是 | 否 | 是 | 否 |
| 公司 | v3 | 是 | 是 | 是 | 是 | 是 |
| 聯絡人 | v3 | 是 | 是 | 是 | 是 | 是 |
| 聯絡人清單 | v1 | 否 | 是 | 否 | 是 | 否 |
| 交易 | v3 | 是 | 是 | 是 | 是 | 是 |
| CRM 管道 (交易管道) | v1 | 否 | 否 | 否 | 是 | 否 |
| 電子郵件事件 | v1 | 否 | 是 | 否 | 是 | 否 |
| 呼叫 | v3 | 是 | 是 | 是 | 是 | 是 |
| 備註 | v3 | 是 | 是 | 是 | 是 | 是 |
| 電子郵件 | v3 | 是 | 是 | 是 | 是 | 是 |
| 會議 | v3 | 是 | 是 | 是 | 是 | 是 |
| 任務 | v3 | 是 | 是 | 是 | 是 | 是 |
| 郵政郵件 | v3 | 是 | 是 | 是 | 是 | 是 |
| 自訂物件 | v3 | 是 | 是 | 是 | 是 | 是 |
| 表單 | v2 | 否 | 否 | 否 | 是 | 否 |
| 擁有者 | v3 | 否 | 是 | 否 | 是 | 否 |
| 產品 | v3 | 是 | 是 | 是 | 是 | 是 |
| 票證 | v3 | 是 | 是 | 是 | 是 | 是 |
| 工作流程 | v3 | 否 | 否 | 否 | 是 | 否 |
| 關聯 | v4 | 是 | 否 | 否 | 是 | 否 |
| 關聯標籤 | v4 | 否 | 否 | 否 | 是 | 否 |
**範例**：
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3"
}
```
## 非同步來源支援的實體
| 實體 | API 版本 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \$1 | 支援分區 |
| --- | --- | --- | --- | --- | --- | --- |
| 公司 | v3 | 是 | 否 | 是 | 是 | 否 |
| 聯絡人 | v3 | 是 | 否 | 是 | 是 | 否 |
| 交易 | v3 | 是 | 否 | 是 | 是 | 否 |
| 呼叫 | 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**：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/hubspot-reading-from-entities.html)
**注意**
針對 `Associations` 物件，若要擷取兩個物件之間的關聯，您需要在建立 AWS Glue 任務時，透過強制性篩選條件提供 'from Id' （第一個物件的 ID)。在這種情況下，如果您想要擷取多個 ID 的關聯，則必須在 `where` 子句中提供多個 ID。例如：若要擷取聯絡人 ID '1' 和 '151' 的`Associations`，您需要提供一個篩選條件，如 `where id=1 AND id=151`。
**HubSpot API v3**：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/hubspot-reading-from-entities.html)
對於下列實體，HubSpot 會提供端點來動態擷取中繼資料，以便在每個實體的資料類型層級擷取運算子支援。
**注意**
`DML_STATUS` 是在執行時期新增至每個記錄的虛擬欄位，以判斷其在同步模式中的狀態 (CREATED/UPDATED)。非同步模式不支援 `CONTAINS/LIKE` 運算子。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v2**：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v1**：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/hubspot-reading-from-entities.html)
## 分區查詢
如果想要在 Spark 中使用並行，可以提供其他 Spark 選項 `PARTITION_FIELD`、`LOWER_BOUND`、`UPPER_BOUND` 和 `NUM_PARTITIONS`。使用這些參數，原始查詢會分區為可由 Spark 任務並行執行的子查詢的 `NUM_PARTITIONS` 數目。
+ `PARTITION_FIELD`：用來分區查詢的欄位名稱。
+ `LOWER_BOUND`：所選分區欄位的**包含**下限值。
對於 DateTime 欄位，接受 ISO 格式的值。
有效值的範例：
```
“2024-01-01T10:00:00.115Z"
```
+ `UPPER_BOUND`：所選分區欄位的**唯一**上限值。
+ `NUM_PARTITIONS`：分區數目。
下表說明實體分區欄位支援詳細資訊：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/hubspot-reading-from-entities.html)
範例：
```
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"
}
```