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à Salesforce Marketing Cloud
<a name="salesforce-marketing-cloud-reading-from-entities"></a>

**Prerequisito**

Un oggetto di Salesforce Marketing Cloud da cui si desidera leggere. È necessario il nome dell'oggetto, come `Activity` o `Campaigns`. Nella tabella seguente sono illustrate le entità supportate.

**Entità supportate come origine**:


| Entità | Interfaccia | Può essere Filtrato | Supporta limite | Supporta Ordina per | Supporta SELEZIONA \$1 | Supporta il partizionamento | 
| --- | --- | --- | --- | --- | --- | --- | 
| Callback di notifiche di eventi | REST | No | No | No | Sì | No | 
| Elenco di seed | REST | No | Sì | No | Sì | No | 
| Configurazione | REST | Sì  | Sì | No | Sì | No | 
| Verifica del dominio | REST | Sì  | Sì | Sì | Sì | No | 
| Oggetti tag nidificati | REST | Sì | No | No | Sì | No | 
| Contatti | REST | No | Sì | No | Sì | No | 
| Iscrizione alle notifiche di eventi | REST | No | No | No | Sì | No | 
| Messaggistica | REST | No | Sì | No | Sì | No | 
| Attività | SOAP | No | No | No | Sì | Sì | 
| Evento di mancato recapito | SOAP | No | No | No | Sì | Sì | 
| Evento di clic  | SOAP | No | No | No | Sì | Sì | 
| Area contenuti | SOAP | No | No | No | Sì | Sì | 
| Estensione di dati | SOAP | No | Sì | No | Sì | Sì | 
| Email | SOAP | No | Sì | No | Sì | Sì | 
| Evento di e-mail inoltrata | SOAP | No | Sì | No | Sì | Sì | 
| Inoltra email OptInEvent | SOAP | No | Sì | No | Sì | Sì | 
| Link | SOAP | No | Sì | No | Sì | Sì | 
| Link Invia | SOAP | No | Sì | No | Sì | Sì | 
| List | SOAP | No | Sì | No | Sì | Sì | 
| Abbonato all'elenco | 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ì | 
| Abbonato | SOAP | No | Sì | No | Sì | Sì | 
| Evento di sondaggio | SOAP | No | Sì | No | Sì | Sì | 
| Evento di annullamento dell'iscrizione | 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 contenuti | 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**:

Nelle tabelle seguenti sono descritte le entità di Salesforce Marketing Cloud. Sono presenti entità REST con metadati statici ed entità SOAP con metadati dinamici.

**Entità REST con metadati statici**:

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

**Entità SOAP con metadati dinamici**:

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

## Query di partizionamento
<a name="salesforce-marketing-cloud-reading-partitioning-queries"></a>

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

Puoi fornire le opzioni Spark aggiuntive `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se desideri utilizzare la concorrenza 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 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"
    }
)
```