# Salesforce Marketing Cloud Account Engagement 엔터티에서 읽기
<a name="salesforce-marketing-cloud-account-engagement-reading-from-entities"></a>

**사전 조건**

읽으려는 Salesforce Marketing Cloud Account Engagement 객체. 객체 이름이 필요합니다.

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


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| 캠페인 | 예 | 예 | 예 | 예 | 예 | 
| 동적 콘텐츠 | 예 | 예 | 예 | 예 | 예 | 
| 이메일 | 예 | 예 | 예 | 예 | 예 | 
| 이메일 템플릿 | 예 | 예 | 예 | 예 | 예 | 
| 참여 스튜디오 프로그램 | 예 | 예 | 예 | 예 | 예 | 
| 폴더 콘텐츠 | 예 | 예 | 예 | 예 | 예 | 
| 랜딩 페이지 | 예 | 예 | 예 | 예 | 예 | 
| 수명 주기 기록 | 예 | 예 | 예 | 예 | 예 | 
| 수명 주기 단계 | 예 | 예 | 예 | 예 | 예 | 
| 나열 | 예 | 예 | 예 | 예 | 예 | 
| 이메일 나열 | 예 | 예 | 예 | 예 | 예 | 
| 멤버쉽 나열 | 예 | 예 | 예 | 예 | 예 | 
| 기회 | 예 | 예 | 예 | 예 | 예 | 
| 잠재 고객 | 예 | 예 | 예 | 예 | 예 | 
| 잠재 고객 계정 | 예 | 예 | 예 | 예 | 예 | 
| User | 예 | 예 | 예 | 예 | 예 | 

**예시:**

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5"
    }
   )
```

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


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| 캠페인 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 동적 콘텐츠 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 이메일 템플릿 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 랜딩 페이지 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 수명 주기 기록 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 수명 주기 단계 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 나열 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 이메일 나열 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 멤버쉽 나열 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 기회 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 잠재 고객 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| 잠재 고객 계정 | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| User | 예 | 아니요 | 아니요 | 예 | 아니요 | 

**예시:**

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "TRANSFER_MODE": "ASYNC"
    }
   )
```

**Salesforce Marketing Cloud Account Engagement 엔터티 및 필드 세부 정보**:

다음 엔터티의 필드 세부 정보를 보려면 [Salesforce Marketing Cloud Account Engagement API](https://developer.salesforce.com/docs/marketing/pardot)로 이동하여 **가이드**를 선택하고 **오픈 소스 API 래퍼**로 스크롤한 다음, 메뉴에서 **버전 5 문서**를 확장하고 엔터티를 선택합니다.

엔터티 목록:
+ 캠페인
+ 동적 콘텐츠
+ 이메일
+ 이메일 템플릿
+ 참여 스튜디오 프로그램
+ 폴더 콘텐츠
+ 랜딩 페이지
+ 수명 주기 기록
+ 수명 주기 단계
+ 나열
+ 이메일 나열
+ 멤버쉽 나열
+ Opportunity
+ 잠재 고객
+ 잠재 고객 계정
+ User

위에서 언급한 필드 외에도 비동기 모드는 아래 표와 같이 각 엔터티에 대해 특정 필터링 가능 필드를 지원합니다.


| 개체 | 비동기에서 지원되는 추가 필터링 가능 필드 | 
| --- | --- | 
| 캠페인 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 동적 콘텐츠 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 이메일 템플릿 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 참여 스튜디오 프로그램 | - | 
| 랜딩 페이지 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 수명 주기 기록 | createdAfter, createdBefore | 
| 수명 주기 단계 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 나열 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 이메일 나열 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 멤버쉽 나열 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Opportunity | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 잠재 고객 | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| 잠재 고객 계정 | createdAfter, createdBefore, deleted | 
| User | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 

추가 필드에 대한 자세한 내용은 [Salesforce Export API](https://developer.salesforce.com/docs/marketing/pardot/guide/export-v5.html#procedures)를 참조하세요.

커넥터에 대한 다음 고려 사항에 유의합니다.
+ 엔터티에서 `delete` 필드 값은 `false`(기본값), `true` 또는 `all`일 수 있습니다.

## 분할 쿼리
<a name="salesforce-marketing-cloud-account-engagement-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-01T01:01:01.000Z"
  ```
+ `UPPER_BOUND`: 선택한 파티션 필드의 상한 값(**경계 제외**).
+ `NUM_PARTITIONS`: 파티션 수.
+ `PARTITION_BY`: 수행할 분할 유형. 필드 기반 분할의 경우 "FIELD"를 전달해야 합니다.

예시:

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcepardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2022-01-01T01:01:01.000Z"
        "UPPER_BOUND": "2024-01-01T01:01:01.000Z"
        "NUM_PARTITIONS": "10",
        "PARTITION_BY": "FIELD"
    }
   )
```