# Salesforce Marketing Cloud エンティティからの読み取り
<a name="salesforce-marketing-cloud-reading-from-entities"></a>

**前提条件**

読み取り元の Salesforce Marketing Cloud オブジェクト。`Activity` または `Campaigns` などのオブジェクト名が必要です。次の表に、サポートされているエンティティを示します。

**ソースに対応するエンティティ**:


| エンティティ | インターフェイス | フィルタリング可能 | 制限をサポートする | Order By をサポートする | SELECT \* をサポートする | パーティション分割をサポートする | 
| --- | --- | --- | --- | --- | --- | --- | 
| Event Notification Callback | REST | なし | なし | なし | あり | なし | 
| Seed-List | REST | なし | あり | なし | あり | なし | 
| セットアップ | REST | はい | あり | なし | あり | なし | 
| ドメインの検証 | REST | はい | あり | あり | あり | なし | 
| Objects Nested Tags | REST | あり | なし | なし | あり | なし | 
| 問い合わせ | REST | なし | あり | なし | あり | なし | 
| Event Notification Subscription | REST | なし | なし | なし | あり | なし | 
| メッセージング | REST | なし | あり | なし | あり | なし | 
| アクティビティ | SOAP | なし | なし | なし | あり | あり | 
| Bounce Event | SOAP | なし | なし | なし | あり | あり | 
| Click Event | SOAP | なし | なし | なし | あり | あり | 
| Content Area | SOAP | なし | なし | なし | あり | あり | 
| Data Extension | SOAP | なし | あり | なし | あり | あり | 
| E メール | SOAP | なし | あり | なし | あり | あり | 
| Forwarded Email Event | SOAP | なし | あり | なし | あり | あり | 
| Forward Email OptInEvent | SOAP | なし | あり | なし | あり | あり | 
| リンク | SOAP | なし | あり | なし | あり | あり | 
| Link Send | SOAP | なし | あり | なし | あり | あり | 
| リスト | SOAP | なし | あり | なし | あり | あり | 
| List Subscriber | SOAP | なし | あり | なし | あり | あり | 
| Not Sent Event | SOAP | なし | あり | なし | あり | あり | 
| Open Event | SOAP | なし | あり | なし | あり | あり | 
| 送信 | SOAP | なし | あり | なし | あり | あり | 
| Sent Event | SOAP | なし | あり | なし | あり | あり | 
| サブスクライバー | SOAP | なし | あり | なし | あり | あり | 
| Survey Event | SOAP | なし | あり | なし | あり | あり | 
| Unsub Event | SOAP | なし | あり | なし | あり | あり | 
| Audit Events | REST | なし | あり | あり | あり | なし | 
| キャンペーン | REST | なし | あり | あり | あり | なし | 
| インタラクション | REST | なし | あり | あり | あり | なし | 
| Content Assets | 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 エンティティ**:



- **Event Notification Callback**
  - **フィールド:** callbackId / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** callbackName / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** url / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** maxBatchSize / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** ステータス / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** statusReason / **データ型:** 文字列 / **サポートされている演算子:** 

- **Seed-List**
  - **フィールド:** id / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** 名前 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** description / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** activeSeedCount / **データ型:** 整数 / **サポートされている演算子:** 

- **セットアップ**
  - **フィールド:** customerKey / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** 名前 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** description / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** locationType / **データ型:** 文字列 / **サポートされている演算子:** '='
  - **フィールド:** awsFileTransferLocation / **データ型:** Struct / **サポートされている演算子:** 

- **Domain verification**
  - **フィールド:** enterpriseId / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** ステータス / **データ型:** 文字列 / **サポートされている演算子:** '='
  - **フィールド:** domainType / **データ型:** 文字列 / **サポートされている演算子:** '='
  - **フィールド:** memberId / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** emailSendTime / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** ドメイン / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** isSendable / **データ型:** ブール値 / **サポートされている演算子:** 

- **Objects Nested Tags**
  - **フィールド:** id / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** modifiedDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** tags / **データ型:** リスト / **サポートされている演算子:** 
  - **フィールド:** 名前 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** description / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** parentId / **データ型:** 整数 / **サポートされている演算子:** 

- **連絡先**
  - **フィールド:** 値
  - **データ型:** リスト
  - **サポートされている演算子:** 

- **Event Notification Subscription**
  - **フィールド:** subscriptionName / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** callbackId / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** callbackName / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** eventCategoryTypes / **データ型:** リスト / **サポートされている演算子:** 
  - **フィールド:** フィルター / **データ型:** リスト / **サポートされている演算子:** 
  - **フィールド:** url / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** maxBatchSize / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** subscriptionId / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** ステータス / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** statusReason / **データ型:** 文字列 / **サポートされている演算子:** 

- **メッセージング**
  - **フィールド:** deliveryTime / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** id / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** messageId / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** ステータス / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** 次のように変更します。 / **データ型:** Struct / **サポートされている演算子:** 

- **インタラクション**
  - **フィールド:** ステータス / **データ型:** 文字列 / **サポートされている演算子:** '='
  - **フィールド:** id / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** キー / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** 名前 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** lastPublishedDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** description / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** version / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** workflowApiVersion / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** createdDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** modifiedDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** goals / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** stats / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** entryMode / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** defaults / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** executionMode / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** definitionId / **データ型:** 文字列 / **サポートされている演算子:** 

- **Content Assets**
  - **フィールド:** id / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** customerKey / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** objectId / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** contentType / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** assetType / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** 名前 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** description / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** owner (オーナー) / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** createdDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** CreatedBy / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** modifiedDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** modifiedBy / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** thumbnail / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** category / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** meta / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** ビュー / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** availableViews / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** データ / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** legacyData / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** modelVersion / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** バージョン / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** ロック / **データ型:** ブール値 / **サポートされている演算子:** 
  - **フィールド:** FileProperties / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** [タグ] / **データ型:** リスト / **サポートされている演算子:** 
  - **フィールド:** コンテンツ / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** 設計 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** SuperContent / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** CustomFields / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** ブロック / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** MinBlocks / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** MaxBlocks / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** チャンネル / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** AllowedBlocks / **データ型:** リスト / **サポートされている演算子:** 
  - **フィールド:** スロット / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** BusinessUnitAvailability / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** sharingProperties / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** sharingProperties.sharedWith / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** sharingProperties.sharingType / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** テンプレート / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** ファイル / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** GenerateFrom / **データ型:** 文字列 / **サポートされている演算子:** 

- **Audit Events**
  - **フィールド:** id / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** createdDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** memberId / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** enterpriseId / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** employee / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** objectType / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** オペレーション / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** オブジェクト / **データ型:** Struct / **サポートされている演算子:** 
  - **フィールド:** transactionId / **データ型:** 文字列 / **サポートされている演算子:** 

- **キャンペーン**
  - **フィールド:** id / **データ型:** 整数 / **サポートされている演算子:** 
  - **フィールド:** createdDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** modifiedDate / **データ型:** DateTime / **サポートされている演算子:** 
  - **フィールド:** 名前 / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** description / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** campaignCode / **データ型:** [String] (文字列) / **サポートされている演算子:** 
  - **フィールド:** color / **データ型:** 文字列 / **サポートされている演算子:** 
  - **フィールド:** favorite / **データ型:** ブール値 / **サポートされている演算子:** 



**動的メタデータを持つ SOAP エンティティ**:



- **アクティビティ**
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** Struct / **サポートされている演算子:** 
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 倍精度 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** ブール値 / **サポートされている演算子:** \!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN

- **Bounce Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** Struct / **サポートされている演算子:** 

- **Click Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** Struct / **サポートされている演算子:** 

- **Content Area**
  - **データ型:** Struct / **サポートされている演算子:** 
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** ブール値 / **サポートされている演算子:** \!=,=

- **Data Extension**
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=

- **E メール**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** ブール値 / **サポートされている演算子:** \!=,=
  - **データ型:** Struct / **サポートされている演算子:** 

- **Forwarded Email Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **Forwarded Email OptInEvent**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **リンク**
  - **データ型:** 整数
  - **サポートされている演算子:** \!=,=,>=,<=,<,>

- **Link Send**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** 倍精度 / **サポートされている演算子:** \!=,=,>=,<=,<,>

- **リスト**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **List Subscriber**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **Not Sent Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **Open Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **送信**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** ブール値 / **サポートされている演算子:** \!=,=
  - **データ型:** Struct / **サポートされている演算子:** 

- **Sent Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **サブスクライバー**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **Survey Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** Struct / **サポートされている演算子:** 

- **Unsub Event**
  - **データ型:** 整数 / **サポートされている演算子:** \!=,=,>=,<=,<,>
  - **データ型:** 文字列 / **サポートされている演算子:** LIKE,\!=,=
  - **データ型:** DateTime / **サポートされている演算子:** >=,<=,<,>,=,BETWEEN
  - **データ型:** ブール値 / **サポートされている演算子:** \!=,=
  - **データ型:** Struct / **サポートされている演算子:** 



## パーティショニングクエリ
<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"
    }
)
```