

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

 **Requisitos previos** 

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

 **Entidades compatibles** 
+ [Característica](https://developers.pendo.io/docs/?bash#feature)
+ [Guía](https://developers.pendo.io/docs/?bash#guide)
+ [Page](https://developers.pendo.io/docs/?bash#page)
+ [Informar](https://developers.pendo.io/docs/?bash#report)
+ [Datos del informe](https://developers.pendo.io/docs/?bash#return-report-contents-as-array-of-json-objects)
+ [Visitante](https://developers.pendo.io/docs/?bash#visitor)
+ [Cuenta de](https://developers.pendo.io/docs/?bash#entities)
+ [Evento](https://developers.pendo.io/docs/?bash#events-grouped)
+ [Evento de característica](https://developers.pendo.io/docs/?bash#events-grouped)
+ [Evento guía](https://developers.pendo.io/docs/?bash#events-ungrouped)
+ [Evento de página](https://developers.pendo.io/docs/?bash#events-grouped)
+ [Evento de encuesta](https://developers.pendo.io/docs/?bash#events-ungrouped)
+ [Evento de seguimiento](https://developers.pendo.io/docs/?bash#events-grouped)


| Entidad | Se puede filtrar | Admite límite | Admite Ordenar por | Admite Seleccionar \$1 | Admite Partición | 
| --- | --- | --- | --- | --- | --- | 
| Característica | No | No | No | Sí | No | 
| Guía | No | No | No | Sí | No | 
| Page | No | No | No | Sí | No | 
| Informar | No | No | No | Sí | No | 
| Datos del informe | No | No | No | Sí | No | 
| Visitante (API de agregación) | Sí | No | Sí | Sí | No | 
| Cuenta (API de agregación) | Sí | No | Sí | Sí | No | 
| Cuenta (API de agregación) | Sí | No | Sí | Sí | No | 
| Evento de característica (API de agregación) | Sí | No | Sí | Sí | Sí | 
| Evento de guía (API de agregación) | Sí | No | Sí | Sí | Sí | 
| Cuenta (API de agregación) | Sí | No | Sí | Sí | Sí | 
| Evento de página (API de agregación) | Sí | No | Sí | Sí | Sí | 
| Evento de encuesta (API de agregación) | Sí | No | Sí | Sí | Sí | 
| Evento de seguimiento (API de agregación) | Sí | No | Sí | Sí | Sí | 

 **Ejemplo** 

```
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 particionamiento
<a name="adobe-marketo-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:


| Nombre de la entidad | 
| --- | 
| Evento | 
|  Evento de característica  | 
| Evento de guía | 
| Evento de página | 
| Evento de encuesta | 
| Evento de seguimiento | 

Ejemplo:

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