

# Lectura de entidades de Mailchimp
<a name="mailchimp-reading-from-entities"></a>

 **Requisitos previos** 

Un objeto de Mailchimp desde el que desea leer. Consulte la tabla de entidades compatibles que aparece a continuación para comprobar las entidades disponibles. 

 **Entidades compatibles** 
+ [Informes de abuso ](https://mailchimp.com/developer/marketing/api/campaign-abuse/)
+ [Automation](https://mailchimp.com/developer/marketing/api/automation/list-automations/)
+ [Campañas de](https://mailchimp.com/developer/marketing/api/campaigns/list-campaigns/)
+ [Detalles de los clics](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Listas](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Miembros](https://mailchimp.com/developer/marketing/api/list-segment-members/)
+ [Detalles de aperturas](https://mailchimp.com/developer/marketing/api/list-members/)
+ [Segmentos](https://mailchimp.com/developer/marketing/api/list-segments/)
+ [Almacenes](https://mailchimp.com/developer/marketing/api/ecommerce-stores/list-stores/)
+ [Cancelación de suscripción](https://mailchimp.com/developer/marketing/api/unsub-reports/)


| Entidad | Se puede filtrar | Admite límite | Admite Ordenar por | Admite Seleccionar \* | Admite Partición | 
| --- | --- | --- | --- | --- | --- | 
| Automatización | Sí | Sí | Sí | Sí | Sí | 
| Campaigns (Campañas) | No | No | No | No | No | 
| Listas | Sí | Sí | No | Sí | Sí | 
| Informa abuso | No | Sí | No | Sí | Sí | 
| Informa aperturas | No | Sí | No | Sí | Sí | 
| Informa clics | Sí | Sí | No | Sí | Sí | 
| Informa cancelaciones de suscripciones | No | Sí | No | Sí | Sí | 
| Segmento | No | Sí | No | Sí | Sí | 
| Segmentar miembros | Sí | Sí | No | Sí | No | 
| Almacenes | Sí | Sí | Sí | Sí | No | 

 **Ejemplo** 

```
mailchimp_read = glueContext.create_dynamic_frame.from_options(                    
            connection_type="mailchimp",                                           
            connection_options={                                                        
                  "connectionName": "connectionName",                                   
                  "ENTITY_NAME": "stores",  
"INSTANCE_URL": "https://us14.api.mailchimp.com",                     
                  "API_VERSION": "3.0"                                                
               })
```

 **Detalles de entidades y campos de Mailchimp** 
+ [Informes de abuso ](https://mailchimp.com/developer/marketing/api/campaign-abuse/)
+ [Automation](https://mailchimp.com/developer/marketing/api/automation/list-automations/)
+ [Campañas de](https://mailchimp.com/developer/marketing/api/campaigns/list-campaigns/)
+ [Detalles de los clics](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Listas](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Miembros](https://mailchimp.com/developer/marketing/api/list-segment-members/)
+ [Detalles de aperturas](https://mailchimp.com/developer/marketing/api/list-members/)
+ [Segmentos](https://mailchimp.com/developer/marketing/api/list-segments/)
+ [Almacenes](https://mailchimp.com/developer/marketing/api/ecommerce-stores/list-stores/)
+ [Cancelación de suscripción](https://mailchimp.com/developer/marketing/api/unsub-reports/)

## Consultas de particionamiento
<a name="mailchimp-engage-reading-partitioning-queries"></a>

Puede proporcionar las opciones adicionales de Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` y `NUM_PARTITIONS` si quiere utilizar la simultaneidad en Spark. Con estos parámetros, la consulta original se dividiría en un número `NUM_PARTITIONS` de subconsultas que las tareas de Spark pueden ejecutar simultáneamente.
+ `PARTITION_FIELD`: el nombre del campo que se utilizará para particionar la consulta.
+ `LOWER_BOUND`: un valor de límite inferior **inclusivo** del campo de partición elegido.

  Para el campo DateTime, aceptamos el valor en formato ISO.

  Ejemplo de valor válido:

  ```
  "2024-07-01T00:00:00.000Z"
  ```
+ `UPPER_BOUND`: un valor límite superior **exclusivo** del campo de partición elegido.
+ `NUM_PARTITIONS`: el número de particiones.

En la tabla siguiente, se describen los detalles de compatibilidad de campos de particiones de entidades:



- ****
  - **Campos de partición:**  / **Tipo de datos:** 
  - **Campos de partición:**  / **Tipo de datos:** 

- ****
  - **Campos de partición:** 
  - **Tipo de datos:** 



Ejemplo:

```
read_read = glueContext.create_dynamic_frame.from_options(
    connection_type="mailchimp",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "automations",
        "API_VERSION": "3.0",
        "INSTANCE_URL": "https://us14.api.mailchimp.com",
        "PARTITION_FIELD": "create_time",
        "LOWER_BOUND": "2024-02-05T14:09:30.115Z",
        "UPPER_BOUND": "2024-06-07T13:30:00.134Z",
        "NUM_PARTITIONS": "3"
    }
```