Lesen aus Salesforce-Marketing-Cloud-Account-Engagement-Entitäten - AWS Glue
Partitionieren von Abfragen

Lesen aus Salesforce-Marketing-Cloud-Account-Engagement-Entitäten

Voraussetzung

Ein Salesforce-Marketing-Cloud-Account-Engagement-Objekt, aus dem Sie lesen möchten. Sie benötigen den Objektnamen.

Unterstützte Entitäten für Synchronisierungsquelle:

Entität Kann gefiltert werden Unterstützt Limit Unterstützt „Sortieren nach“ Unterstützt „* auswählen“ Unterstützt Partitionierung
Kampagne Ja Ja Ja Ja Ja
Dynamischer Inhalt Ja Ja Ja Ja Ja
Email Ja Ja Ja Ja Ja
E-Mail-Vorlage Ja Ja Ja Ja Ja
Engagement-Studio-Programm Ja Ja Ja Ja Ja
Ordnerinhalt Ja Ja Ja Ja Ja
Landingpage Ja Ja Ja Ja Ja
Lebenszyklusverlauf Ja Ja Ja Ja Ja
Lebenszyklusphase Ja Ja Ja Ja Ja
Auflisten Ja Ja Ja Ja Ja
E-Mail-Liste Ja Ja Ja Ja Ja
Mitgliedschaftsliste Ja Ja Ja Ja Ja
Gelegenheit Ja Ja Ja Ja Ja
Interessent Ja Ja Ja Ja Ja
Konto Interessent Ja Ja Ja Ja Ja
Benutzer Ja Ja Ja Ja Ja

Beispiel:

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

Unterstützte Entitäten für asynchrone Quelle

Entität Kann gefiltert werden Unterstützt Limit Unterstützt „Sortieren nach“ Unterstützt „* auswählen“ Unterstützt Partitionierung
Kampagne Ja Nein Nein Ja Nein
Dynamischer Inhalt Ja Nein Nein Ja Nein
E-Mail-Vorlage Ja Nein Nein Ja Nein
Landingpage Ja Nein Nein Ja Nein
Lebenszyklusverlauf Ja Nein Nein Ja Nein
Lebenszyklusphase Ja Nein Nein Ja Nein
Auflisten Ja Nein Nein Ja Nein
E-Mail-Liste Ja Nein Nein Ja Nein
Mitgliedschaftsliste Ja Nein Nein Ja Nein
Gelegenheit Ja Nein Nein Ja Nein
Interessent Ja Nein Nein Ja Nein
Konto Interessent Ja Nein Nein Ja Nein
Benutzer Ja Nein Nein Ja Nein

Beispiel:

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

Entitäts- und Felddetails zu Salesforce Marketing Cloud Account Engagement:

Um die Felddetails für die folgenden Entitäten anzuzeigen, navigieren Sie zu Salesforce Marketing Cloud Account Engagement API, wählen Sie Guides aus, scrollen Sie nach unten zu Open Source API Wrappers, erweitern Sie Version 5 Docs im Menü und wählen Sie eine Entität aus.

Liste der Entitäten:

  • Kampagne

  • Dynamischer Inhalt

  • Email

  • E-Mail-Vorlage

  • Engagement-Studio-Programm

  • Ordnerinhalt

  • Landingpage

  • Lebenszyklusverlauf

  • Lebenszyklusphase

  • Auflisten

  • E-Mail-Liste

  • Mitgliedschaftsliste

  • Gelegenheit

  • Interessent

  • Konto Interessent

  • Benutzer

Zusätzlich zu den oben genannten Feldern unterstützt der asynchrone Modus spezifische filterbare Felder für jede Entität, wie in der Tabelle unten dargestellt.

Entität Zusätzliche filterbare Felder werden im asynchronen Modus unterstützt
Kampagne createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Dynamischer Inhalt createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
E-Mail-Vorlage createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Engagement-Studio-Programm -
Landingpage createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Lebenszyklusverlauf createdAfter, createdBefore
Lebenszyklusphase createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Auflisten createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
E-Mail-Liste createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Mitgliedschaftsliste createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Gelegenheit createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Interessent createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Konto Interessent createdAfter, createdBefore, deleted
Benutzer createdAfter, createdBefore, deleted, updatedAfter, updatedBefore

Weitere Informationen zu den zusätzlichen Feldern finden Sie unter Salesforce Export API.

Beachten Sie folgende Überlegungen zum Connector:

  • Der Wert des Felds delete in den Entitäten kann false (Standard), true oder all sein.

Partitionieren von Abfragen

Filterbasierte 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 DateTime-Feld akzeptieren wir das Spark-Zeitstempelformat, das in Spark-SQL-Abfragen verwendet wird.

    Beispiele für gültigen Wert:

    "2022-01-01T01:01:01.000Z"

  • UPPER_BOUND: ein exklusiver Obergrenzwert des ausgewählten Partitionsfelds.

  • NUM_PARTITIONS: die Anzahl der Partitionen.

  • PARTITION_BY: der Typ der durchzuführenden Partitionierung. Bei feldbasierter Partitionierung ist „FIELD“ zu übergeben.

Beispiel:

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