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

**Pré-requisito**

Um objeto do Twilio do qual você deseja ler. Você precisará do nome do objeto, como `SMS-Message` ou `SMS-CountryPricing`.

**Entidades compatíveis quanto à origem**:


| Entidade | Interface | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \$1 | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | --- | 
| SMS-Message | REST | Sim | Sim | Não | Sim | Sim | 
| SMS-CountryPricing | REST | Não | Não | Não | Sim | Não | 
| Voice-Call | REST | Sim | Sim | Não | Sim | Não | 
| Voice-Application | REST | Sim | Sim | Não | Sim | Não | 
| Voice-OutgoingCallerID | REST | Sim | Sim | Não | Sim | Não | 
| Voice-Queue | REST | Sim | Sim | Não | Sim | Não | 
| Conversations-Conversation | REST | Sim | Sim | Não | Sim | Não | 
| Conversations-User | REST | Não | Sim | Não | Sim | Não | 
| Conversas-Função | REST | Não | Sim | Não | Sim | Não | 
| Conversations-Configuration | REST | Não | Não | Não | Sim | Não | 
| Conversations-AddressConfiguration | REST | Sim | Sim | Não | Sim | Não | 
| Conversations-WebhookConfiguration | REST | Não | Não | Não | Sim | Não | 
| Conversations-ParticipantConversation | REST | Não | Não | Não | Sim | Não | 
| Conversations-Credential | REST | Não | Sim | Não | Sim | Não | 
| Conversations-ConversationService | REST | Não | Sim | Não | Sim | Não | 

**Exemplo:**

```
twilio_read = glueContext.create_dynamic_frame.from_options(
    connection_type="twilio",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "sms-message",
        "API_VERSION": "2010-04-01",
        "Edge_Location": "sydney.us1"
    }
```

**Detalhes de entidade e campo do Twilio**:

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

## Particionamento de consultas
<a name="twilio-reading-partitioning-queries"></a>

**Campos com suporte a particionamento**:

No Twilio, os campos de tipo de dados DateTime oferecem suporte ao particionamento baseado em campos.

É 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.

  No campo Datetime, aceitamos o formato de carimbo de data/hora do Spark usado em consultas SQL do Spark.

  Exemplos de valores válidos:

  ```
  "2024-05-01T20:55:02.000Z"
  ```
+ `UPPER_BOUND`: um valor limite superior **exclusivo** do campo de partição escolhido.
+ `NUM_PARTITIONS`: o número de partições.

Exemplo:

```
twilio_read = glueContext.create_dynamic_frame.from_options(
    connection_type="twilio",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "sms-message",
        "API_VERSION": "2010-04-01",
        "PARTITION_FIELD": "date_sent"
        "LOWER_BOUND": "2024-05-01T20:55:02.000Z"
        "UPPER_BOUND": "2024-06-01T20:55:02.000Z"
        "NUM_PARTITIONS": "10"
    }
```