Lecture à partir des entités Salesforce Marketing Cloud Account Engagement - AWS Glue
Requêtes de partitionnement

Lecture à partir des entités Salesforce Marketing Cloud Account Engagement

Prérequis

Un objet Salesforce Marketing Cloud Account Engagement à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet.

Entités prises en charge pour la source de synchronisation :

Entité Peut être filtré Limit prise en charge Order by prise en charge Select prise en charge* Partitionnement pris en charge
Campagne Oui Oui Oui Oui Oui
Contenu dynamique Oui Oui Oui Oui Oui
E-mails Oui Oui Oui Oui Oui
Email Template Oui Oui Oui Oui Oui
Engagement Studio Program Oui Oui Oui Oui Oui
Folder Contents Oui Oui Oui Oui Oui
Landing Page Oui Oui Oui Oui Oui
Lifecycle History Oui Oui Oui Oui Oui
Lifecycle Stage Oui Oui Oui Oui Oui
Liste Oui Oui Oui Oui Oui
List Email Oui Oui Oui Oui Oui
List Membership Oui Oui Oui Oui Oui
Opportunity Oui Oui Oui Oui Oui
Prospect Oui Oui Oui Oui Oui
Prospect Account Oui Oui Oui Oui Oui
Utilisateur Oui Oui Oui Oui Oui

Exemple :

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

Entités prises en charge pour la source asynchrone :

Entité Peut être filtré Limit prise en charge Order by prise en charge Select prise en charge* Partitionnement pris en charge
Campagne Oui Non Non Oui Non
Contenu dynamique Oui Non Non Oui Non
Email Template Oui Non Non Oui Non
Landing Page Oui Non Non Oui Non
Lifecycle History Oui Non Non Oui Non
Lifecycle Stage Oui Non Non Oui Non
Liste Oui Non Non Oui Non
List Email Oui Non Non Oui Non
List Membership Oui Non Non Oui Non
Opportunity Oui Non Non Oui Non
Prospect Oui Non Non Oui Non
Prospect Account Oui Non Non Oui Non
Utilisateur Oui Non Non Oui Non

Exemple :

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

Détails des entités et des champs Salesforce Marketing Cloud Account Engagement :

Pour afficher les détails des champs pour les entités suivantes, accédez à API Salesforce Marketing Cloud Account Engagement, choisissez Guides, faites défiler la page vers le bas jusqu’à Open Source API Wrappers, développez Version 5 Docs dans le menu et choisissez une entité.

Liste des entités :

  • Campagne

  • Contenu dynamique

  • E-mails

  • Email Template

  • Engagement Studio Program

  • Folder Content

  • Landing Page

  • Lifecycle History

  • Lifecycle Stage

  • Liste

  • List Email

  • List Membership

  • Opportunity

  • Prospect

  • Prospect Account

  • Utilisateur

Outre les champs mentionnés ci-dessus, le mode asynchrone prend en charge des champs filtrables spécifiques pour chaque entité, comme indiqué dans le tableau ci-dessous.

Entité Champs filtrables supplémentaires pris en charge en mode asynchrone
Campagne createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Contenu dynamique createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Email Template createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Engagement Studio Program -
Landing Page createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Lifecycle History createdAfter, createdBefore
Lifecycle Stage createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Liste createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
List Email createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
List Membership createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Opportunity createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Prospect createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Prospect Account createdAfter, createdBefore, deleted
Utilisateur createdAfter, createdBefore, deleted, updatedAfter, updatedBefore

Pour plus d’informations sur les champs supplémentaires, consultez API Salesforce Export.

Notez les considérations à prendre en compte pour le connecteur :

  • La valeur du champ delete dans les entités peut être false (par défaut), true ou all.

Requêtes de partitionnement

Partitionnement basé sur des filtres :

Vous pouvez indiquer les options Spark supplémentaires PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND et NUM_PARTITIONS si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en NUM_PARTITIONS nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark.

  • PARTITION_FIELD : le nom du champ à utiliser pour partitionner la requête.

  • LOWER_BOUND : une valeur limite inférieure inclusive du champ de partition choisi.

    Pour le champ Datetime, nous acceptons le format d’horodatage Spark utilisé dans les requêtes SQL Spark.

    Exemples de valeurs valides :

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

  • UPPER_BOUND : une valeur limite supérieure exclusive du champ de partition choisi.

  • NUM_PARTITIONS : le nombre de partitions.

  • PARTITION_BY : le type de partitionnement à effectuer. « FIELD » doit être transmis en cas de partitionnement basé sur des champs.

Exemple :

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