# Kustomer 엔터티에서 읽기
<a name="kustomer-reading-from-entities"></a>

**사전 조건**

읽으려는 Kustomer 객체. 객체 이름(예: Brands 또는 Cards)이 필요합니다. 다음 표에는 지원되는 엔터티가 나와 있습니다.

**소스에 대해 지원되는 엔터티**:


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| Brands | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| Cards | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| Chat Settings | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| Companies | 예 | 예 | 예 | 예 | 예 | 
| Conversations | 예 | 예 | 예 | 예 | 예 | 
| Customers | 예 | 예 | 예 | 예 | 예 | 
| Customer Searches Pinned | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| Customer Searches Position | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| Email Hooks | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| Web Hooks | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Articles | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Categories | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Forms | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Routes | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Tags | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Templates | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KB Themes | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| Klasses | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| KViews | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| 메시지 | 예 | 예 | 예 | 예 | 예 | 
| Notes | 예 | 예 | 예 | 예 | 예 | 
| 알림 | 아니요 | 예 | 아니요 | 예 | 아니요 | 

**예시:**

```
Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "brands",
        "API_VERSION": "v1"
    }
```

## Kustomer 엔터티 및 필드 세부 정보
<a name="kustomer-reading-from-entities-field-details"></a>

엔터티 및 필드 세부 정보에 대한 자세한 내용은 다음을 참조하세요.
+ [Brands](https://api.kustomerapp.com/v1/brands)
+ [Cards](https://api.kustomerapp.com/v1/cards)
+ [Chat Settings](https://api.kustomerapp.com/v1/chat/settings)
+ [Companies](https://api.kustomerapp.com/v1/companies)
+ [Conversations](https://api.kustomerapp.com/v1/conversations)
+ [Customers](https://api.kustomerapp.com/v1/customers)
+ [Customers Searches Pinned](https://api.kustomerapp.com/v1/customers/searches/pinned)
+ [Customer Searches Positions](https://api.kustomerapp.com/v1/customers/searches/positions)
+ [Hooks Email](https://api.kustomerapp.com/v1/hooks/email)
+ [Hooks Web](https://api.kustomerapp.com/v1/hooks/web)
+ [KB Articles](https://api.kustomerapp.com/v1/kb/articles)
+ [KB Categories](https://api.kustomerapp.com/v1/kb/categories)
+ [KB Forms]( https://api.kustomerapp.com/v1/kb/forms)
+ [KB Routes](https://api.kustomerapp.com/v1/kb/routes)
+ [KB Tags](https://api.kustomerapp.com/v1/kb/tags)
+ [KB Templates](https://api.kustomerapp.com/v1/kb/templates)
+ [KB Themes](https://api.kustomerapp.com/v1/kb/themes)
+ [Klasses](https://api.kustomerapp.com/v1/klasses)
+ [Kviews](https://api.kustomerapp.com/v1/kviews)
+ [메시지](https://api.kustomerapp.com/v1/messages)
+ [참고](https://api.kustomerapp.com/v1/notes)
+ [알림](https://api.kustomerapp.com/v1/notifications)

Kustomer API v1

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/glue/latest/dg/kustomer-reading-from-entities.html)

## 분할 쿼리
<a name="kustomer-reading-from-partitioning"></a>

**필드 기반 분할**

Spark에서 동시성을 활용하려는 경우 추가 Spark 옵션(`PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND`, `NUM_PARTITIONS`)을 제공할 수 있습니다. 이러한 파라미터를 사용하면 Spark 작업에서 동시에 실행할 수 있는 `NUM_PARTITIONS`개의 하위 쿼리로 원래 쿼리가 분할됩니다.
+ `PARTITION_FIELD`: 쿼리 분할에 사용할 필드의 이름입니다.
+ `LOWER_BOUND`: 선택한 파티션 필드의 하한 값(**경계 포함**).

  DateTime 필드의 경우 ISO 형식의 값이 허용됩니다.

  유효한 값의 예제:

  ```
  "2023-01-15T11:18:39.205Z"
  ```
+ `UPPER_BOUND`: 선택한 파티션 필드의 상한 값(**경계 제외**).
+ `NUM_PARTITIONS`: 파티션 수.

엔터티 수준 분할 필드 지원 세부 정보는 다음 표에 나와 있습니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/glue/latest/dg/kustomer-reading-from-entities.html)

예시:

```
Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2023-01-15T11:18:39.205Z"
        "UPPER_BOUND": "2023-02-15T11:18:39.205Z"
        "NUM_PARTITIONS": "2"
    }
```