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

 **Pré-requisitos** 

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

 **Entidades compatíveis** 
+ [Recurso do](https://developers.pendo.io/docs/?bash#feature)
+ [Guia](https://developers.pendo.io/docs/?bash#guide)
+ [Página](https://developers.pendo.io/docs/?bash#page)
+ [Relatório](https://developers.pendo.io/docs/?bash#report)
+ [Dados de relatório](https://developers.pendo.io/docs/?bash#return-report-contents-as-array-of-json-objects)
+ [Visitante](https://developers.pendo.io/docs/?bash#visitor)
+ [Conta da](https://developers.pendo.io/docs/?bash#entities)
+ [Event](https://developers.pendo.io/docs/?bash#events-grouped)
+ [Evento do recurso](https://developers.pendo.io/docs/?bash#events-grouped)
+ [Evento do guia](https://developers.pendo.io/docs/?bash#events-ungrouped)
+ [Evento da página](https://developers.pendo.io/docs/?bash#events-grouped)
+ [Evento de enquete](https://developers.pendo.io/docs/?bash#events-ungrouped)
+ [Evento de rastreamento](https://developers.pendo.io/docs/?bash#events-grouped)


| Entidade | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \$1 | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | 
| Recurso | Não | Não | Não | Sim | Não | 
| Guia | Não | Não | Não | Sim | Não | 
| Página | Não | Não | Não | Sim | Não | 
| Relatório | Não | Não | Não | Sim | Não | 
| Dados de relatório | Não | Não | Não | Sim | Não | 
| Visitante (API de agregação) | Sim | Não | Sim | Sim | Não | 
| Conta (API de agregação) | Sim | Não | Sim | Sim | Não | 
| Evento (API de agregação) | Sim | Não | Sim | Sim | Não | 
| Evento do recurso (API de agregação) | Sim | Não | Sim | Sim | Sim | 
| Evento do guia (API de agregação) | Sim | Não | Sim | Sim | Sim | 
| Conta (API de agregação) | Sim | Não | Sim | Sim | Sim | 
| Evento da página (API de agregação) | Sim | Não | Sim | Sim | Sim | 
| Evento de enquete (API de agregação) | Sim | Não | Sim | Sim | Sim | 
| Evento de rastreamento (API de agregação) | Sim | Não | Sim | Sim | Sim | 

 **Exemplo** 

```
Pendo_read = glueContext.create_dynamic_frame.from_options(
    connection_type="glue.spark.Pendo",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "feature",
        "API_VERSION": "v1",
        "INSTANCE_URL": "instanceUrl"
    }
```

## Consultas de particionamento
<a name="adobe-marketo-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:


| Nome da entidade | 
| --- | 
| Event | 
|  Evento do recurso  | 
| Evento do guia | 
| Evento da página | 
| Evento de enquete | 
| Evento de rastreamento | 

Exemplo:

```
pendo_read = glueContext.create_dynamic_frame.from_options(
    connection_type="glue.spark.pendo",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "event",
        "API_VERSION": "v1",
        "INSTANCE_URL": "instanceUrl"
        "NUM_PARTITIONS": "10",
        "PARTITION_FIELD": "appId"
        "LOWER_BOUND": "4656"
        "UPPER_BOUND": "7788"
    }
```