Lettura dalle entità Salesforce Marketing Cloud Account Engagement - AWS Glue
Query di partizionamento

Lettura dalle entità Salesforce Marketing Cloud Account Engagement

Prerequisito

Un oggetto di Salesforce Marketing Cloud Account Engagement da cui si desidera leggere. È necessario il nome dell'oggetto.

Entità supportate come origine Sync:

Entità Può essere filtrato Supporta limite Supporta Ordina per Supporta Seleziona * Supporta il partizionamento
Campagna Sì Sì Sì Sì Sì
Contenuti dinamici Sì Sì Sì Sì Sì
E-mail Sì Sì Sì Sì Sì
Modello e-mail Sì Sì Sì Sì Sì
Engagement Studio Program Sì Sì Sì Sì Sì
Contenuti della cartella Sì Sì Sì Sì Sì
Pagina di destinazione Sì Sì Sì Sì Sì
Cronologia del ciclo di vita Sì Sì Sì Sì Sì
Stadio del ciclo di vita Sì Sì Sì Sì Sì
Elenco Sì Sì Sì Sì Sì
Elenco e-mail Sì Sì Sì Sì Sì
Elenco iscrizioni Sì Sì Sì Sì Sì
Opportunità Sì Sì Sì Sì Sì
Prospect Sì Sì Sì Sì Sì
Account Prospect Sì Sì Sì Sì Sì
Utente Sì Sì Sì Sì Sì

Esempio:

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

Entità supportate come origine Async:

Entità Può essere filtrato Supporta limite Supporta Ordina per Supporta Seleziona * Supporta il partizionamento
Campagna Sì No No Sì No
Contenuti dinamici Sì No No Sì No
Modello e-mail Sì No No Sì No
Pagina di destinazione Sì No No Sì No
Cronologia del ciclo di vita Sì No No Sì No
Stadio del ciclo di vita Sì No No Sì No
Elenco Sì No No Sì No
Elenco e-mail Sì No No Sì No
Elenco iscrizioni Sì No No Sì No
Opportunità Sì No No Sì No
Prospect Sì No No Sì No
Account Prospect Sì No No Sì No
Utente Sì No No Sì No

Esempio:

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

Dettagli dell'entità e del campo di Salesforce Marketing Cloud Account Engagement:

Per visualizzare i dettagli dei campi per le seguenti entità, accedere all'API Salesforce Marketing Cloud Account Engagement, scegliere Guide, scorrere verso il basso fino a Wrapper API Open Source, espandere la versione 5 Docs dal menu e scegliere un'entità.

Elenco delle entità:

  • Campagna

  • Contenuti dinamici

  • E-mail

  • Modello e-mail

  • Engagement Studio Program

  • Contenuto della cartella

  • Pagina di destinazione

  • Cronologia del ciclo di vita

  • Stadio del ciclo di vita

  • Elenco

  • Elenco e-mail

  • Elenco iscrizioni

  • Opportunità

  • Prospect

  • Account Prospect

  • Utente

Oltre ai campi sopra menzionati, la modalità asincrona supporta campi filtrabili specifici per ciascuna entità, come mostrato nella tabella seguente.

Entità Campi filtrabili aggiuntivi supportati in modalità asincrona
Campagna createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Contenuti dinamici createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Modello e-mail createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Engagement Studio Program -
Pagina di destinazione createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Cronologia del ciclo di vita createdAfter, createdBefore
Stadio del ciclo di vita createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Elenco createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Elenco e-mail createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Elenco iscrizioni createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Opportunità createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Prospect createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Account Prospect createdAfter, createdBefore, deleted
Utente createdAfter, createdBefore, deleted, updatedAfter, updatedBefore

Per ulteriori informazioni sui campi aggiuntivi, consultare l'API Salesforce Export

Prendere nota di quanto segue per il connettore:

  • Il valore del campo delete nelle entità può essere false (impostazione predefinita), true o all.

Query di partizionamento

Partizionamento basato su filtri:

È possibile fornire le opzioni Spark aggiuntive PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND e NUM_PARTITIONS se si desidera utilizzare la simultaneità in Spark. Con questi parametri, la query originale viene suddivisa in NUM_PARTITIONS query secondarie che possono essere eseguite contemporaneamente dalle attività Spark.

  • PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query.

  • LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.

    Per il campo Datetime, accettiamo il formato di timestamp Spark utilizzato nelle query SQL di Spark.

    Esempi di valori validi:

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

  • UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.

  • NUM_PARTITIONS: il numero di partizioni.

  • PARTITION_BY: il tipo di partizionamento da eseguire. “FIELD” deve essere passato in caso di partizionamento basato sul campo.

Esempio:

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