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

# Membaca dari entitas Keterlibatan Akun Cloud Pemasaran Salesforce
<a name="salesforce-marketing-cloud-account-engagement-reading-from-entities"></a>

**Prasyarat**

Objek Keterlibatan Akun Cloud Pemasaran Salesforce yang ingin Anda baca. Anda akan membutuhkan nama objek.

**Entitas yang didukung untuk sumber Sinkronisasi**:


| Entitas | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih\$1 | Mendukung partisi | 
| --- | --- | --- | --- | --- | --- | 
| Kampanye | Ya | Ya | Ya | Ya | Ya | 
| Konten Dinamis | Ya | Ya | Ya | Ya | Ya | 
| Email | Ya | Ya | Ya | Ya | Ya | 
| Template Email | Ya | Ya | Ya | Ya | Ya | 
| Program Studio Keterlibatan | Ya | Ya | Ya | Ya | Ya | 
| Isi Folder | Ya | Ya | Ya | Ya | Ya | 
| Halaman Landing | Ya | Ya | Ya | Ya | Ya | 
| Riwayat Siklus Hidup | Ya | Ya | Ya | Ya | Ya | 
| Tahap Siklus Hidup | Ya | Ya | Ya | Ya | Ya | 
| Daftar | Ya | Ya | Ya | Ya | Ya | 
| Daftar Email | Ya | Ya | Ya | Ya | Ya | 
| Daftar Keanggotaan | Ya | Ya | Ya | Ya | Ya | 
| Peluang | Ya | Ya | Ya | Ya | Ya | 
| Prospek | Ya | Ya | Ya | Ya | Ya | 
| Akun Prospek | Ya | Ya | Ya | Ya | Ya | 
| Pengguna | Ya | Ya | Ya | Ya | Ya | 

**Contoh:**

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5"
    }
   )
```

**Entitas yang didukung untuk sumber Async**:


| Entitas | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih\$1 | Mendukung partisi | 
| --- | --- | --- | --- | --- | --- | 
| Kampanye | Ya | Tidak | Tidak | Ya | Tidak | 
| Konten Dinamis | Ya | Tidak | Tidak | Ya | Tidak | 
| Template Email | Ya | Tidak | Tidak | Ya | Tidak | 
| Halaman Landing | Ya | Tidak | Tidak | Ya | Tidak | 
| Riwayat Siklus Hidup | Ya | Tidak | Tidak | Ya | Tidak | 
| Tahap Siklus Hidup | Ya | Tidak | Tidak | Ya | Tidak | 
| Daftar | Ya | Tidak | Tidak | Ya | Tidak | 
| Daftar Email | Ya | Tidak | Tidak | Ya | Tidak | 
| Daftar Keanggotaan | Ya | Tidak | Tidak | Ya | Tidak | 
| Peluang | Ya | Tidak | Tidak | Ya | Tidak | 
| Prospek | Ya | Tidak | Tidak | Ya | Tidak | 
| Akun Prospek | Ya | Tidak | Tidak | Ya | Tidak | 
| Pengguna | Ya | Tidak | Tidak | Ya | Tidak | 

**Contoh:**

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "TRANSFER_MODE": "ASYNC"
    }
   )
```

**Entitas dan detail bidang Keterlibatan Akun Cloud Pemasaran Salesforce**:

Untuk melihat detail bidang untuk entitas berikut, navigasikan ke [Salesforce Marketing Cloud Account Engagement API](https://developer.salesforce.com/docs/marketing/pardot), pilih **Guides**, gulir ke bawah ke **Open Source API Wrappers, perluas** **Versi 5 Docs** dari menu dan pilih entitas.

Daftar entitas:
+ Kampanye
+ Konten Dinamis
+ Email
+ Template Email
+ Program Studio Keterlibatan
+ Konten Folder
+ Halaman Landing
+ Riwayat Siklus Hidup
+ Tahap Siklus Hidup
+ Daftar
+ Daftar Email
+ Daftar Keanggotaan
+ Peluang
+ Prospek
+ Akun Prospek
+ Pengguna

Selain bidang yang disebutkan di atas, mode Async mendukung bidang yang dapat difilter khusus untuk setiap entitas, seperti yang ditunjukkan pada tabel di bawah ini.


| Entitas | Bidang disaring tambahan yang didukung di Async | 
| --- | --- | 
| Kampanye | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Konten Dinamis | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Template Email | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Program Studio Keterlibatan | - | 
| Halaman Landing | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Riwayat Siklus Hidup | createdAfter, createdBefore | 
| Tahap Siklus Hidup | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Daftar | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Daftar Email | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Daftar Keanggotaan | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Peluang | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Prospek | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 
| Akun Prospek | createdAfter, createdBefore, deleted | 
| Pengguna | createdAfter, createdBefore, deleted, updatedAfter, updatedBefore | 

Untuk informasi selengkapnya tentang bidang tambahan, lihat [Salesforce](https://developer.salesforce.com/docs/marketing/pardot/guide/export-v5.html#procedures) Export API

Perhatikan pertimbangan berikut untuk konektor:
+ Nilai `delete` bidang dalam entitas dapat `false` (default),`true`, atau`all`.

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

Partisi **berbasis filter**:

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 Datetime, kami menerima format stempel waktu Spark yang digunakan dalam kueri SQL. SPark 

  Contoh nilai valid:

  ```
  "2022-01-01T01:01:01.000Z"
  ```
+ `UPPER_BOUND`: nilai batas atas **eksklusif** dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.
+ `PARTITION_BY`: jenis partisi yang akan dilakukan. “FIELD” harus diteruskan jika terjadi partisi berbasis lapangan.

Contoh:

```
salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcepardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2022-01-01T01:01:01.000Z"
        "UPPER_BOUND": "2024-01-01T01:01:01.000Z"
        "NUM_PARTITIONS": "10",
        "PARTITION_BY": "FIELD"
    }
   )
```