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

**사전 조건**

읽으려는 Salesforce Marketing Cloud 객체. 객체 이름(예: `Activity` 또는 `Campaigns`)이 필요합니다. 다음 표에는 지원되는 엔터티가 나와 있습니다.

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


| 개체 | 인터페이스 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | SELECT \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | --- | 
| 이벤트 알림 콜백 | REST | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| 시드-목록 | REST | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| 설정 | REST | 예 | 예 | 아니요 | 예 | 아니요 | 
| 도메인 확인 | REST | 예 | 예 | 예 | 예 | 아니요 | 
| 객체 중첩된 태그 | REST | 예 | 아니요 | 아니요 | 예 | 아니요 | 
| Contact | REST | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| 이벤트 알림 구독 | REST | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| 메시지 전송 | REST | 아니요 | 예 | 아니요 | 예 | 아니요 | 
| 활동 | SOAP | 아니요 | 아니요 | 아니요 | 예 | 예 | 
| 반송 이벤트 | SOAP | 아니요 | 아니요 | 아니요 | 예 | 예 | 
| 클릭 이벤트 | SOAP | 아니요 | 아니요 | 아니요 | 예 | 예 | 
| 콘텐츠 영역 | SOAP | 아니요 | 아니요 | 아니요 | 예 | 예 | 
| 데이터 확장 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 이메일 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 전달된 이메일 이벤트 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 이메일 OptInEvent 전달 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 링크 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 링크 전송 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 나열 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 구독자 나열 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 전송되지 않은 이벤트 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 열린 이벤트 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| Send | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 전송된 이벤트 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 구독자 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 설문조사 이벤트 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 구독 해지 이벤트 | SOAP | 아니요 | 예 | 아니요 | 예 | 예 | 
| 감사 이벤트 | REST | 아니요 | 예 | 예 | 예 | 아니요 | 
| Campaigns | REST | 아니요 | 예 | 예 | 예 | 아니요 | 
| 상호작용 | REST | 아니요 | 예 | 예 | 예 | 아니요 | 
| 콘텐츠 자산 | REST | 아니요 | 예 | 예 | 예 | 아니요 | 

**REST에 대한 예제**:

```
salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Campaigns",
        "API_VERSION": "v1",
        "INSTANCE_URL": "https://**********************.rest.marketingcloudapis.com"
    }
)
```

**SOAP에 대한 예제**:

```
salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "Activity",
        "API_VERSION": "v1",
        "INSTANCE_URL": "https://**********************.soap.marketingcloudapis.com"
    }
)
```

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

다음 표에서는 Salesforce Marketing Cloud 엔터티를 설명합니다. 정적 메타데이터를 포함하는 REST 엔터티와 동적 메타데이터를 포함하는 SOAP 엔터티가 있습니다.

**정적 메타데이터를 포함하는 REST 엔터티**:

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

**동적 메타데이터를 포함하는 SOAP 엔터티**:

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

## 분할 쿼리
<a name="salesforce-marketing-cloud-reading-partitioning-queries"></a>

Salesforce Marketing Cloud에서 정수 및 DateTime 데이터 유형 필드는 필드 기반 분할을 지원합니다.

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

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

  유효한 값의 예제:

  ```
  “2024-05-07T02:03:00.00Z"
  ```
+ `UPPER_BOUND`: 선택한 파티션 필드의 상한 값(**경계 제외**).
+ `NUM_PARTITIONS`: 파티션 수.

예시:

```
salesforcemarketingcloud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcemarketingcloud",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "ListSubscriber",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "CreatedDate",
        "LOWER_BOUND": "2023-09-07T02:03:00.000Z",
        "UPPER_BOUND": "2024-05-07T02:03:00.000Z",
        "NUM_PARTITIONS": "10"
    }
)
```