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

 **Pré-requisitos** 

Um objeto do Mailchimp do qual você deseja ler. Consulte a tabela de entidades compatíveis abaixo para verificar as entidades disponíveis. 

 **Entidades compatíveis** 
+ [Relatórios de abuso](https://mailchimp.com/developer/marketing/api/campaign-abuse/)
+ [Automação](https://mailchimp.com/developer/marketing/api/automation/list-automations/)
+ [Campanhas](https://mailchimp.com/developer/marketing/api/campaigns/list-campaigns/)
+ [Detalhes de cliques](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Listas](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Membros](https://mailchimp.com/developer/marketing/api/list-segment-members/)
+ [Detalhes de abertura](https://mailchimp.com/developer/marketing/api/list-members/)
+ [Segmentos](https://mailchimp.com/developer/marketing/api/list-segments/)
+ [Lojas](https://mailchimp.com/developer/marketing/api/ecommerce-stores/list-stores/)
+ [Cancelamentos de assinaturas](https://mailchimp.com/developer/marketing/api/unsub-reports/)


| Entidade | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \$1 | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | 
| Automação | Sim | Sim | Sim | Sim | Sim | 
| Campanhas | Não | Não | Não | Não | Não | 
| Listas | Sim | Sim | Não | Sim | Sim | 
| Relatórios de abusos | Não | Sim | Não | Sim | Sim | 
| Relatórios de aberturas | Não | Sim | Não | Sim | Sim | 
| Relatórios de cliques | Sim | Sim | Não | Sim | Sim | 
| Relatórios de cancelamentos de assinaturas | Não | Sim | Não | Sim | Sim | 
| Segmento | Não | Sim | Não | Sim | Sim | 
| Membros do segmento | Sim | Sim | Não | Sim | Não | 
| Lojas | Sim | Sim | Sim | Sim | Não | 

 **Exemplo** 

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

 **Detalhes das entidades e dos campos do Mailchimp** 
+ [Relatórios de abuso](https://mailchimp.com/developer/marketing/api/campaign-abuse/)
+ [Automação](https://mailchimp.com/developer/marketing/api/automation/list-automations/)
+ [Campanhas](https://mailchimp.com/developer/marketing/api/campaigns/list-campaigns/)
+ [Detalhes de cliques](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Listas](https://mailchimp.com/developer/marketing/api/link-clickers/)
+ [Membros](https://mailchimp.com/developer/marketing/api/list-segment-members/)
+ [Detalhes de abertura](https://mailchimp.com/developer/marketing/api/list-members/)
+ [Segmentos](https://mailchimp.com/developer/marketing/api/list-segments/)
+ [Lojas](https://mailchimp.com/developer/marketing/api/ecommerce-stores/list-stores/)
+ [Cancelamentos de assinaturas](https://mailchimp.com/developer/marketing/api/unsub-reports/)

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

É possível fornecer as opções adicionais do Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND` e `NUM_PARTITIONS` se quiser utilizar a simultaneidade no Spark. Com esses parâmetros, a consulta original seria dividida em `NUM_PARTITIONS` subconsultas, que poderiam ser executadas pelas tarefas do Spark simultaneamente.
+ `PARTITION_FIELD`: o nome do campo a ser usado para particionar a consulta.
+ `LOWER_BOUND`: um valor limite inferior **inclusivo** do campo de partição escolhido.

  Para o campo DateTime, aceitamos o valor no formato ISO.

  Exemplo de valor válido:

  ```
  "2024-07-01T00:00:00.000Z"
  ```
+ `UPPER_BOUND`: um valor limite superior **exclusivo** do campo de partição escolhido.
+ `NUM_PARTITIONS`: o número de partições.

A tabela a seguir descreve os detalhes do suporte do campo de particionamento da entidade:

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

Exemplo:

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