# HubSpot 엔터티에서 읽기
**사전 조건**
읽으려는 HubSpot 객체. 객체 이름(예: 연락처 또는 태스크)이 필요합니다. 다음 표에는 동기화 소스에 대해 지원되는 엔터티가 나와 있습니다.
## 동기화 소스에 대해 지원되는 엔터티
| 개체 | API 버전 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 |
| --- | --- | --- | --- | --- | --- | --- |
| Campaigns | v1 | 아니요 | 예 | 아니요 | 예 | 아니요 |
| 회사 | v3 | 예 | 예 | 예 | 예 | 예 |
| Contacts | v3 | 예 | 예 | 예 | 예 | 예 |
| 연락처 목록 | v1 | 아니요 | 예 | 아니요 | 예 | 아니요 |
| 거래 | v3 | 예 | 예 | 예 | 예 | 예 |
| CRM 파이프라인(거래 파이프라인) | v1 | 아니요 | 아니요 | 아니요 | 예 | 아니요 |
| 이메일 이벤트 | v1 | 아니요 | 예 | 아니요 | 예 | 아니요 |
| 호출 | v3 | 예 | 예 | 예 | 예 | 예 |
| Notes | v3 | 예 | 예 | 예 | 예 | 예 |
| 이메일 | v3 | 예 | 예 | 예 | 예 | 예 |
| 회의 | v3 | 예 | 예 | 예 | 예 | 예 |
| 업무 | v3 | 예 | 예 | 예 | 예 | 예 |
| 우편 | v3 | 예 | 예 | 예 | 예 | 예 |
| 사용자 지정 객체 | v3 | 예 | 예 | 예 | 예 | 예 |
| 양식 | v2 | 아니요 | 아니요 | 아니요 | 예 | 아니요 |
| 소유자 | v3 | 아니요 | 예 | 아니요 | 예 | 아니요 |
| Products | 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"
}
```
## 비동기 소스에 대해 지원되는 엔터티:
| 개체 | API 버전 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 |
| --- | --- | --- | --- | --- | --- | --- |
| Companies | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| Contacts | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| 거래 | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| 호출 | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| Notes | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| Emails | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| 회의 | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| 업무 | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| 우편 | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| 사용자 지정 객체 | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| Products | v3 | 예 | 아니요 | 예 | 예 | 아니요 |
| Tickets | 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/ko_kr/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/ko_kr/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/ko_kr/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v2**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v1**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/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/ko_kr/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"
}
```