本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Blackbaud Raiser's Edge NXT 實體中讀取
<a name="blackbaud-reading-from-entities"></a>

**必要條件**

您想要讀取的 Blackbaud Raiser's Edge NXT 物件。將需要物件名稱。

**來源的支援實體**：


| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \$1 | 支援分區 | 
| --- | --- | --- | --- | --- | --- | 
| 組成部分地址 | 是 | 是 | 否 | 是 | 是 | 
| 組成部分教育 | 是 | 是 | 否 | 是 | 是 | 
| 組成部分電子郵件地址 | 是 | 是 | 否 | 是 | 是 | 
| 組成部分電話 | 是 | 是 | 否 | 是 | 是 | 
| 組成部分備註 | 是 | 是 | 否 | 是 | 是 | 
| 組成部分關係 | 是 | 是 | 否 | 是 | 是 | 
| 組成部分線上存在 | 是 | 是 | 否 | 是 | 是 | 
| 機會 | 是 | 是 | 否 | 是 | 是 | 
| 吸引力 | 是 | 是 | 否 | 是 | 是 | 
| 行銷活動 | 是 | 是 | 否 | 是 | 是 | 
| 資金 | 是 | 是 | 否 | 是 | 是 | 
| 套件 | 是 | 是 | 否 | 是 | 是 | 
| 禮物批次 | 是 | 是 | 否 | 是 | 否 | 
| 事件參與者 | 是 | 是 | 是 | 是 | 是 | 
| 組成部分籌款者指派 | 否 | 否 | 否 | 是 | 否 | 
| 禮物 | 是 | 是 | 是 | 是 | 是 | 
| 成員資格 | 是 | 是 | 否 | 是 | 是 | 
| Action | 是 | 是 | 否 | 是 | 否 | 
| 組成部分 | 是 | 是 | 是 | 是 | 是 | 
| 組成部分商品 | 是 | 是 | 否 | 是 | 是 | 
| 事件 | 是 | 是 | 是 | 是 | 是 | 
| 禮物自訂欄位 | 是 | 是 | 否 | 是 | 是 | 

**範例**：

```
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>

如需實體和欄位詳細資訊的更多資訊，請參閱：
+ [Action](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Action)
+ [組成部分](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Constituent)
+ [組成部分地址](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Address)
+ [組成部分成員資格](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Membership)
+ [組成部分籌款者指派](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#FundraiserAssignment)
+ [組成部分教育](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Education)
+ [組成部分電子郵件地址](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#EmailAddress)
+ [組成部分電話](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Phone)
+ [組成部分備註](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Note)
+ [組成部分線上存在](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#OnlinePresence)
+ [組成部分關係](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Relationship)
+ [事件](https://developer.blackbaud.com/skyapi/renxt/event/entities#Event)
+ [事件參與者](https://developer.blackbaud.com/skyapi/renxt/event/entities#Participant)
+ [吸引力](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Appeal)
+ [行銷活動](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Campaign)
+ [資金](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Fund)
+ [套件](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Package)
+ [禮物](https://developer.blackbaud.com/skyapi/renxt/gift/entities#Gift)
+ [禮物自訂欄位](https://developer.blackbaud.com/skyapi/renxt/gift/entities#CustomField)
+ [禮物批次](https://developer.blackbaud.com/skyapi/renxt/gift-batch/entities#GiftBatch)
+ [機會](https://developer.blackbaud.com/skyapi/renxt/opportunity/entities#Opportunity)
+ [組成部分程式碼](https://developer.sky.blackbaud.com/api#api=56b76470069a0509c8f1c5b3)

**注意**  
在連接器的回應中，Struct 和 List 資料類型會轉換為 String 資料類型，DateTime 資料類型會轉換為 Timestamp。

## 分區查詢
<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>
    }
```