# Instagram Ads 엔터티에서 읽기
<a name="instagram-ads-reading-from-entities"></a>

**사전 조건**

읽으려는 Instagram Ads 객체. 객체 이름이 필요합니다. 다음 표에는 지원되는 엔터티가 나와 있습니다.

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


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| 캠페인 | 예 | 예 | 아니요 | 예 | 예 | 
| 광고 세트 | 예 | 예 | 아니요 | 예 | 예 | 
| 광고 | 예 | 예 | 아니요 | 예 | 예 | 
| 광고 크리에이티브 | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| 인사이트 - 계정 | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| 광고 이미지 | 예 | 예 | 아니요 | 예 | 아니요 | 
| 인사이트 - 광고 | 예 | 예 | 아니요 | 예 | 예 | 
| 인사이트 - 광고 세트 | 예 | 예 | 아니요 | 예 | 예 | 
| 인사이트 - 캠페인 | 예 | 예 | 아니요 | 예 | 예 | 

**예시:**

```
instagramAds_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0"
    }
```

## Instagram Ads 엔터티 및 필드 세부 정보
<a name="instagram-ads-reading-entity-and-field-details"></a>

엔터티 및 필드 세부 정보에 대한 자세한 내용은 다음을 참조하세요.
+ [캠페인](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group)
+ [광고 세트](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign)
+ [광고](https://developers.facebook.com/docs/marketing-api/reference/adgroup)
+ [광고 크리에이티브](https://developers.facebook.com/docs/marketing-api/reference/ad-creative)
+ [광고 계정 인사이트](https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights)
+ [광고 이미지](https://developers.facebook.com/docs/marketing-api/reference/ad-image)
+ [광고 인사이트](https://developers.facebook.com/docs/marketing-api/reference/adgroup/insights/)
+ [광고 세트 인사이트](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/insights)
+ [캠페인 인사이트](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/insights)

자세한 내용은 [마케팅 API](https://developers.facebook.com/docs/marketing-api/reference/v21.0)를 참조하세요.

**참고**  
구조체 및 목록 데이터 유형은 커넥터의 응답에서 문자열 데이터 유형으로 변환됩니다.

## 쿼리 파티셔닝
<a name="instagram-ads-reading-partitioning-queries"></a>

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

  DateTime 필드의 경우 Spark SQL 쿼리에 사용된 Spark 타임스탬프 형식을 허용합니다.

  유효한 값의 예제:

  ```
  "2022-01-01T00:00:00.000Z"
  ```
+ `UPPER_BOUND`: 선택한 파티션 필드의 상한 값(**경계 제외**).

  유효한 값의 예제:

  ```
  "2024-01-02T00:00:00.000Z"
  ```
+ `NUM_PARTITIONS`: 파티션 수.

예시:

```
instagramADs_read = glueContext.create_dynamic_frame.from_options(
    connection_type="instagramads",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v20.0",
        "PARTITION_FIELD": "created_time"
        "LOWER_BOUND": "2022-01-01T00:00:00.000Z"
        "UPPER_BOUND": "2024-01-02T00:00:00.000Z"
        "NUM_PARTITIONS": "10"
    }
```