Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membaca dari entitas Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-reading-from-entities"></a>

**Prasyarat**

Objek Salesforce Marketing Cloud yang ingin Anda baca. Anda akan membutuhkan nama objek seperti `Activity` atau`Campaigns`. Tabel berikut menunjukkan entitas yang didukung.

**Entitas yang didukung untuk sumber**:


| Entitas | Antarmuka | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung SELECT \$1 | Mendukung partisi | 
| --- | --- | --- | --- | --- | --- | --- | 
| Panggilan Balik Pemberitahuan Acara | REST | Tidak | Tidak | Tidak | Ya | Tidak | 
| Daftar Benih | REST | Tidak | Ya | Tidak | Ya | Tidak | 
| Pengaturan | REST | Ya | Ya | Tidak | Ya | Tidak | 
| Verifikasi Domain | REST | Ya | Ya | Ya | Ya | Tidak | 
| Tag Bersarang Objek | REST | Ya | Tidak | Tidak | Ya | Tidak | 
| Kontak | REST | Tidak | Ya | Tidak | Ya | Tidak | 
| Langganan Pemberitahuan Acara | REST | Tidak | Tidak | Tidak | Ya | Tidak | 
| Perpesanan | REST | Tidak | Ya | Tidak | Ya | Tidak | 
| Aktifitas | SOAP | Tidak | Tidak | Tidak | Ya | Ya | 
| Acara Bounce | SOAP | Tidak | Tidak | Tidak | Ya | Ya | 
| Klik Acara | SOAP | Tidak | Tidak | Tidak | Ya | Ya | 
| Area Konten | SOAP | Tidak | Tidak | Tidak | Ya | Ya | 
| Ekstensi Data | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Email | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Email yang Diteruskan | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Teruskan Email OptInEvent | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Tautan | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Tautan Kirim | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Daftar | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Daftar Pelanggan | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Tidak Terkirim | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Terbuka | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Kirim | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Terkirim | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Pelanggan | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Survei | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Unsub | SOAP | Tidak | Ya | Tidak | Ya | Ya | 
| Acara Audit | REST | Tidak | Ya | Ya | Ya | Tidak | 
| Kampanye | REST | Tidak | Ya | Ya | Ya | Tidak | 
| Interaksi | REST | Tidak | Ya | Ya | Ya | Tidak | 
| Aset Konten | REST | Tidak | Ya | Ya | Ya | Tidak | 

**Contoh untuk 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"
    }
)
```

**Contoh untuk 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"
    }
)
```

**Entitas dan detail bidang Salesforce Marketing Cloud**:

Tabel berikut menjelaskan entitas Salesforce Marketing Cloud. Ada entitas REST dengan metadata statis dan entitas SOAP dengan metadata dinamis.

**Entitas REST dengan metadata statis**:

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

**Entitas SOAP dengan metadata dinamis**:

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

## Mempartisi kueri
<a name="salesforce-marketing-cloud-reading-partitioning-queries"></a>

Di Salesforce Marketing Cloud, bidang Integer dan DateTime tipe data mendukung partisi berbasis lapangan.

Anda dapat memberikan opsi Spark tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, dan `NUM_PARTITIONS` jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas Spark secara bersamaan.
+ `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`: nilai batas bawah **inklusif** dari bidang partisi yang dipilih.

  Untuk bidang timestamp, kami menerima format stempel waktu Spark yang digunakan dalam kueri Spark SQL.

  Contoh nilai valid:

  ```
  “2024-05-07T02:03:00.00Z"
  ```
+ `UPPER_BOUND`: nilai batas atas **eksklusif** dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.

Contoh:

```
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"
    }
)
```