# Blackbaud Raiser’s Edge NXT 엔터티에서 읽기
<a name="blackbaud-reading-from-entities"></a>

**사전 조건**

읽으려는 Blackbaud Raiser’s Edge NXT 객체. 객체 이름이 필요합니다.

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


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \$1 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| Constituent Address | 예 | 예 | 아니요 | 예 | 예 | 
| Constituent Education | 예 | 예 | 아니요 | 예 | 예 | 
| Constituent Email address | 예 | 예 | 아니요 | 예 | 예 | 
| Constituent Phone | 예 | 예 | 아니요 | 예 | 예 | 
| Constituent Note | 예 | 예 | 아니요 | 예 | 예 | 
| Constituent Relationship | 예 | 예 | 아니요 | 예 | 예 | 
| Constituent Online presence | 예 | 예 | 아니요 | 예 | 예 | 
| 기회 | 예 | 예 | 아니요 | 예 | 예 | 
| Appeal | 예 | 예 | 아니요 | 예 | 예 | 
| 캠페인 | 예 | 예 | 아니요 | 예 | 예 | 
| Fund | 예 | 예 | 아니요 | 예 | 예 | 
| Package | 예 | 예 | 아니요 | 예 | 예 | 
| Gift Batch | 예 | 예 | 아니요 | 예 | 아니요 | 
| Event Participant | 예 | 예 | 예 | 예 | 예 | 
| Constituent Fundraiser Assignment | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| Gift | 예 | 예 | 예 | 예 | 예 | 
| 멤버십 | 예 | 예 | 아니요 | 예 | 예 | 
| 작업 | 예 | 예 | 아니요 | 예 | 아니요 | 
| Constituent | 예 | 예 | 예 | 예 | 예 | 
| Constituent Goods | 예 | 예 | 아니요 | 예 | 예 | 
| Event | 예 | 예 | 예 | 예 | 예 | 
| Gift custom field | 예 | 예 | 아니요 | 예 | 예 | 

**예시:**

```
blackbaud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="BLACKBAUD",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v1",
        "SUBSCRIPTION_KEY": <Subscription key associated with one's developer account>
    }
```

## Blackbaud Raiser’s Edge NXT 엔터티 및 필드 세부 정보
<a name="blackbaud-reading-entity-field-details"></a>

엔터티 및 필드 세부 정보에 대한 자세한 내용은 다음을 참조하세요.
+ [작업](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Action)
+ [Constituent](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Constituent)
+ [Constituent Address](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Address)
+ [Constituent Membership](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Membership)
+ [Constituent Fundraiser Assignment](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#FundraiserAssignment)
+ [Constituent Education](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Education)
+ [Constituent Email Address](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#EmailAddress)
+ [Constituent Phone](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Phone)
+ [Constituent Note](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Note)
+ [Constituent Online Presence](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#OnlinePresence)
+ [Constituent Relationship](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Relationship)
+ [Event](https://developer.blackbaud.com/skyapi/renxt/event/entities#Event)
+ [Event Participant](https://developer.blackbaud.com/skyapi/renxt/event/entities#Participant)
+ [Appeal](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Appeal)
+ [캠페인](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Campaign)
+ [Fund](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Fund)
+ [Package](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Package)
+ [Gift](https://developer.blackbaud.com/skyapi/renxt/gift/entities#Gift)
+ [Gift Custom Field](https://developer.blackbaud.com/skyapi/renxt/gift/entities#CustomField)
+ [Gift Batch](https://developer.blackbaud.com/skyapi/renxt/gift-batch/entities#GiftBatch)
+ [Opportunity](https://developer.blackbaud.com/skyapi/renxt/opportunity/entities#Opportunity)
+ [Constituent Codes](https://developer.sky.blackbaud.com/api#api=56b76470069a0509c8f1c5b3)

**참고**  
커넥터의 응답에서 Struct 및 List 데이터 유형은 String 데이터 유형으로 변환되며, DateTime 데이터 유형은 타임스탬프로 변환됩니다.

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

**필드 기반 분할**:

Blackbaud Raiser’s Edge NXT는 필드 기반 또는 레코드 기반 분할을 지원하지 않습니다.

**레코드 기반 분할**:

Spark에서 동시성을 활용하려는 경우 추가 Spark 옵션(`NUM_PARTITIONS`)을 제공할 수 있습니다. 이 파라미터를 사용하면 Spark 태스크에서 동시에 실행할 수 있는 `NUM_PARTITIONS`개의 하위 쿼리로 원본 쿼리가 분할됩니다.

레코드 기반 분할에서는 존재하는 총 레코드 수를 Blackbaud Raiser’s Edge NXT API에서 쿼리하고 제공된 `NUM_PARTITIONS` 수로 나눕니다. 그런 다음, 결과 레코드 수를 각 하위 쿼리에서 동시에 가져옵니다.
+ `NUM_PARTITIONS`: 파티션 수.

예시:

```
blackbaud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="BLACKBAUD",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v1",
        "NUM_PARTITIONS": "2",
        "SUBSCRIPTION_KEY": <Subscription key associated with one's developer account>
    }
```