Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Lesen aus Salesforce-Marketing-Cloud-Entitäten
<a name="salesforce-marketing-cloud-reading-from-entities"></a>

**Voraussetzung**

Ein Salesforce-Marketing-Cloud-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen wie `Activity` oder `Campaigns`. Die folgende Tabelle zeigt die unterstützten Entitäten.

**Unterstützte Entitäten für Quelle**:


| Entität | Schnittstelle | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 SELECT“ | Unterstützt Partitionierung | 
| --- | --- | --- | --- | --- | --- | --- | 
| Ereignisbenachrichtigung-Callback | REST | Nein | Nein | Nein | Ja | Nein | 
| Seed-Liste | REST | Nein | Ja | Nein | Ja | Nein | 
| Einrichtung | REST | Ja | Ja | Nein | Ja | Nein | 
| Domänenverifizierung | REST | Ja | Ja | Ja | Ja | Nein | 
| Verschachtelte Objekt-Tags | REST | Ja | Nein | Nein | Ja | Nein | 
| Kontakt | REST | Nein | Ja | Nein | Ja | Nein | 
| Abonnement für Ereignisbenachrichtigung | REST | Nein | Nein | Nein | Ja | Nein | 
| Messaging | REST | Nein | Ja | Nein | Ja | Nein | 
| Aktivität | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Bounce-Ereignis | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Klickereignis | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Inhaltsbereich | SOAP | Nein | Nein | Nein | Ja | Ja | 
| Datenerweiterung | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Email | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Weitergeleitete E-Mail | SOAP | Nein | Ja | Nein | Ja | Ja | 
| E-Mail weiterleiten OptInEvent | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Link | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Link senden | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Auflisten | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Liste von Abonnenten | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Nicht gesendet | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Öffnen | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Senden | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Gesendet | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Subscriber | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Umfrage | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Ereignis Abonnement beenden | SOAP | Nein | Ja | Nein | Ja | Ja | 
| Prüfungsereignisse | REST | Nein | Ja | Ja | Ja | Nein | 
| Kampagnen | REST | Nein | Ja | Ja | Ja | Nein | 
| Interaktionen | REST | Nein | Ja | Ja | Ja | Nein | 
| Inhalts-Assets | REST | Nein | Ja | Ja | Ja | Nein | 

**Beispiel für 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"
    }
)
```

**Beispiel für 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"
    }
)
```

**Entitäts- und Felddetails zu Salesforce Marketing Cloud**:

In den folgenden Tabellen werden die Salesforce-Marketing-Cloud-Entitäten beschrieben. Es gibt REST-Entitäten mit statischen Metadaten und SOAP-Entitäten mit dynamischen Metadaten.

**REST-Entitäten mit statischen Metadaten**:

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

**SOAP-Entitäten mit dynamischen Metadaten**:

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

## Partitionierung von Abfragen
<a name="salesforce-marketing-cloud-reading-partitioning-queries"></a>

In Salesforce Marketing Cloud unterstützen die Felder Integer und DateTime Datentyp die feldbasierte Partitionierung.

Sie können die zusätzlichen Spark-Optionen `PARTITION_FIELD`,`LOWER_BOUND`, `UPPER_BOUND` und `NUM_PARTITIONS` angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesen Parametern wird die ursprüngliche Abfrage in `NUM_PARTITIONS` Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.
+ `PARTITION_FIELD`: der Name des Feldes, das zur Partitionierung der Abfrage verwendet werden soll.
+ `LOWER_BOUND`: ein **inklusiver** Untergrenzwert des ausgewählten Partitionsfelds.

  Für das Timestamp-Feld akzeptieren wir das Spark-Zeitstempelformat, das in Spark-SQL-Abfragen verwendet wird.

  Beispiele für gültigen Wert:

  ```
  “2024-05-07T02:03:00.00Z"
  ```
+ `UPPER_BOUND`: ein **exklusiver** Obergrenzwert des ausgewählten Partitionsfelds.
+ `NUM_PARTITIONS`: Die Anzahl an Partitionen.

Beispiel:

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