Lettura dalle entità di Salesforce Marketing Cloud - AWS Glue
Interrogazioni di partizionamento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lettura dalle entità di Salesforce Marketing Cloud

Prerequisito

Un oggetto di Salesforce Marketing Cloud da cui desideri leggere. Avrai bisogno del nome dell'oggetto, ad esempio Activity o. Campaigns La tabella seguente mostra le entità supportate.

Entità supportate per l'origine:

Entità Interfaccia Può essere filtrato Limite di supporto Supporta Order by Supporta SELECT * Supporta il partizionamento
Richiamata di notifica degli eventi REST No No No Sì No
Elenco dei semi REST No Sì No Sì No
Configurazione REST Sì Sì No Sì No
Verifica del dominio REST Sì Sì Sì Sì No
Oggetti - Tag annidati REST Sì No No Sì No
Contatti REST No Sì No Sì No
Abbonamento alla notifica degli eventi REST No No No Sì No
Messaggistica REST No Sì No Sì No
Attività SOAP No No No Sì Sì
Evento Bounce SOAP No No No Sì Sì
Fai clic su Evento SOAP No No No Sì Sì
Area dei contenuti SOAP No No No Sì Sì
Estensione dei dati SOAP No Sì No Sì Sì
E-mail SOAP No Sì No Sì Sì
Evento e-mail inoltrato SOAP No Sì No Sì Sì
Inoltra e-mail OptInEvent SOAP No Sì No Sì Sì
Link SOAP No Sì No Sì Sì
Link Invia SOAP No Sì No Sì Sì
Elenco SOAP No Sì No Sì Sì
Elenco abbonati SOAP No Sì No Sì Sì
Evento non inviato SOAP No Sì No Sì Sì
Evento aperto SOAP No Sì No Sì Sì
Invia SOAP No Sì No Sì Sì
Evento inviato SOAP No Sì No Sì Sì
Sottoscrittore SOAP No Sì No Sì Sì
Evento del sondaggio SOAP No Sì No Sì Sì
Evento Unsub SOAP No Sì No Sì Sì
Eventi di audit REST No Sì Sì Sì No
Campagne REST No Sì Sì Sì No
Interazioni REST No Sì Sì Sì No
Risorse di contenuto REST No Sì Sì Sì No

Esempio per 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"
    }

Esempio per 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"
    }

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

Le tabelle seguenti descrivono le entità di Salesforce Marketing Cloud. Esistono entità REST con metadati statici ed entità SOAP con metadati dinamici.

Entità REST con metadati statici:

Entità Campo Tipo di dati Operatori supportati
Richiamata di notifica degli eventi ID di richiamata Stringa
Nome di richiamata Stringa
url Stringa
maxBatchSize Numero intero
status Stringa
Motivo dello stato Stringa
Elenco dei semi id Stringa
nome Stringa
description Stringa
activeSeedCount Numero intero
Configurazione Chiave del cliente Stringa
nome Stringa
description Stringa
Tipo di ubicazione Stringa '='
awsFileTransferLocation Struct
Verifica del dominio EnterpriseID Numero intero
status Stringa '='
Tipo di dominio Stringa '='
ID membro Numero intero
emailSendTime DateTime
domain Stringa
È inviabile Booleano
Oggetti, tag annidati id Numero intero
Data modificata DateTime
tags Elenco
nome Stringa
description Stringa
ID principale Numero intero
Contatti values Elenco
Abbonamento alla notifica degli eventi Nome dell'abbonamento Stringa
ID di richiamata Stringa
Nome di richiamata Stringa
eventCategoryTypes Elenco
filtri Elenco
url Stringa
maxBatchSize Numero intero
ID di sottoscrizione Stringa
status Stringa
Motivo dello stato Stringa
Messaggistica Tempo di consegna DateTime
id Stringa
messageId Stringa
status Stringa
in Struct
Interazioni status Stringa '='
id Stringa
key Stringa
nome Stringa
lastPublishedDate DateTime
description Stringa
version Numero intero
workflowApiVersion Numero intero
Data di creazione DateTime
Data modificata DateTime
obiettivi Struct
statistiche Struct
modalità di ingresso Stringa
defaults Struct
Modalità di esecuzione Struct
ID di definizione Stringa
Risorse di contenuto id Numero intero
Chiave del cliente Stringa
objectId Stringa
contentType Stringa
Tipo di risorsa Struct
nome Stringa
description Stringa
owner Struct
Data di creazione DateTime
Creato da Struct
Data modificata DateTime
Modificato da Struct
miniatura Struct
category Struct
meta Struct
viste Struct
Visualizzazioni disponibili Struct
dati Struct
Dati preesistenti Struct
Versione del modello Numero intero
Versione Numero intero
Locked (Bloccato) Booleano
FileProperties Struct
Tag Elenco
Contenuti Stringa
Progettazione Stringa
SuperContent Stringa
CustomFields Struct
Blocchi Struct
MinBlocks Numero intero
MaxBlocks Numero intero
Canali Struct
AllowedBlocks Elenco
Slot Struct
BusinessUnitAvailability Struct
Condivisione delle proprietà Struct
Condivisione di proprietà. Condiviso con Struct
Condivisione di proprietà. Tipo di condivisione Stringa
Modello Struct
File Stringa
GenerateFrom Stringa
Eventi di controllo id Numero intero
Data di creazione DateTime
ID membro Numero intero
ID aziendale Numero intero
dipendente Struct
objectType Struct
operation Struct
oggetto Struct
ID transazione Stringa
Campagne id Numero intero
Data di creazione DateTime
Data modificata DateTime
nome Stringa
description Stringa
Codice della campagna Stringa
color Stringa
preferito Booleano

entità SOAP con metadati dinamici:

Entità Tipo di dati Operatori supportati
Attività Stringa TIPO,! =, =
Struct
Numero intero !=,=,>=,<=,<,>
Doppio !=,=,>=,<=,<,>
Booleano !=,=
DateTime >=, <=, <, >, =, TRA
Evento di rimbalzo Numero intero !=,=,>=,<=,<,>
DateTime >=, <=, <, >, =, TRA
Stringa TIPO,! =, =
Struct
Fai clic su Evento Numero intero !=,=,>=,<=,<,>
DateTime >=, <=, <, >, =, TRA
Stringa TIPO,! =, =
Struct
Area dei contenuti Struct
Stringa TIPO,! =, =
Numero intero !=,=,>=,<=,<,>
DateTime >=, <=, <, >, =, TRA
Booleano !=,=
Estensione dei dati DateTime >=, <=, <, >, =, TRA
Stringa TIPO,! =, =
E-mail Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Booleano !=,=
Struct
Evento e-mail inoltrato Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Email inoltrata OptInEvent Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Link Numero intero !=,=,>=,<=,<,>
Link Invia Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
Doppio !=,=,>=,<=,<,>
Elenco Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Elenco abbonati Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Evento non inviato Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Evento aperto Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Invia Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Booleano !=,=
Struct
Evento inviato Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Sottoscrittore Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Evento del sondaggio Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Struct
Evento Unsub Numero intero !=,=,>=,<=,<,>
Stringa TIPO,! =, =
DateTime >=, <=, <, >, =, TRA
Booleano !=,=
Struct

Interrogazioni di partizionamento

In Salesforce Marketing Cloud, i campi Integer e DateTime Datatype supportano il partizionamento basato sul campo.

Puoi fornire le opzioni Spark aggiuntive e, se desideri PARTITION_FIELDLOWER_BOUND, UPPER_BOUND utilizzare la concorrenza in Spark. NUM_PARTITIONS Con questi parametri, la query originale verrebbe suddivisa in un NUM_PARTITIONS numero di sottoquery 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 timestamp, accettiamo il formato di timestamp Spark utilizzato nelle query SQL di Spark.

    Esempi di valori validi:

    “2024-05-07T02:03:00.00Z"

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

  • NUM_PARTITIONS: il numero di partizioni.

Esempio:

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