# Lectura de entidades de Kustomer
<a name="kustomer-reading-from-entities"></a>

**Requisito previo**

Un objeto de Kustomer desde el que desea leer. Necesitará el nombre del objeto, como Marcas o Tarjetas. En la siguiente tabla se muestran las entidades admitidas.

**Entidades compatibles como origen:**


| Entidad | Se puede filtrar | Admite límite | Admite Ordenar por | Admite Seleccionar \$1 | Admite partición | 
| --- | --- | --- | --- | --- | --- | 
| Marcas | No | Sí | No | Sí | No | 
| Tarjetas | No | Sí | No | Sí | No | 
| Configuración del chat | No | No | No | Sí | No | 
| Empresas | Sí | Sí | Sí | Sí | Sí | 
| Conversaciones | Sí | Sí | Sí | Sí | Sí | 
| Clientes | Sí | Sí | Sí | Sí | Sí | 
| Búsquedas de clientes ancladas | No | Sí | No | Sí | No | 
| Posición de búsquedas de clientes | No | No | No | Sí | No | 
| Enlaces de correo | No | Sí | No | Sí | No | 
| Enlaces web | No | Sí | No | Sí | No | 
| Artículos de KB | No | Sí | No | Sí | No | 
| Categorías de KB | No | Sí | No | Sí | No | 
| Formularios de KB | No | Sí | No | Sí | No | 
| Rutas de KB | No | Sí | No | Sí | No | 
| Etiquetas de KB | No | Sí | No | Sí | No | 
| Plantillas de KB | No | Sí | No | Sí | No | 
| Temas de KB | No | Sí | No | Sí | No | 
| Klasses | No | Sí | No | Sí | No | 
| KViews | No | Sí | No | Sí | No | 
| Mensajes | Sí | Sí | Sí | Sí | Sí | 
| Notas | Sí | Sí | Sí | Sí | Sí | 
| Notificaciones | No | Sí | No | Sí | No | 

**Ejemplo:**

```
Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "brands",
        "API_VERSION": "v1"
    }
```

## Detalles de entidades y campos de Kustomer
<a name="kustomer-reading-from-entities-field-details"></a>

Para obtener más información acerca de las entidades y los detalles de los campos, consulte:
+ [Marcas](https://api.kustomerapp.com/v1/brands)
+ [Tarjetas](https://api.kustomerapp.com/v1/cards)
+ [Configuración del chat](https://api.kustomerapp.com/v1/chat/settings)
+ [Empresas](https://api.kustomerapp.com/v1/companies)
+ [Conversaciones](https://api.kustomerapp.com/v1/conversations)
+ [Clientes](https://api.kustomerapp.com/v1/customers)
+ [Búsquedas de clientes ancladas](https://api.kustomerapp.com/v1/customers/searches/pinned)
+ [Posición de búsquedas de clientes](https://api.kustomerapp.com/v1/customers/searches/positions)
+ [Enlaces de correo](https://api.kustomerapp.com/v1/hooks/email)
+ [Enlaces web](https://api.kustomerapp.com/v1/hooks/web)
+ [Artículos de KB](https://api.kustomerapp.com/v1/kb/articles)
+ [Categorías de KB](https://api.kustomerapp.com/v1/kb/categories)
+ [Formularios de KB]( https://api.kustomerapp.com/v1/kb/forms)
+ [Rutas de KB](https://api.kustomerapp.com/v1/kb/routes)
+ [Etiquetas de KB](https://api.kustomerapp.com/v1/kb/tags)
+ [Plantillas de KB](https://api.kustomerapp.com/v1/kb/templates)
+ [Temas de KB](https://api.kustomerapp.com/v1/kb/themes)
+ [Klasses](https://api.kustomerapp.com/v1/klasses)
+ [KViews](https://api.kustomerapp.com/v1/kviews)
+ [Mensajes](https://api.kustomerapp.com/v1/messages)
+ [Notas](https://api.kustomerapp.com/v1/notes)
+ [Notificaciones](https://api.kustomerapp.com/v1/notifications)

API v1

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

## Consultas de partición
<a name="kustomer-reading-from-partitioning"></a>

**Partición basada en campos**

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:

  ```
  "2023-01-15T11:18:39.205Z"
  ```
+ `UPPER_BOUND`: un valor límite superior **exclusivo** del campo de partición elegido.
+ `NUM_PARTITIONS`: el número de particiones.

En la siguiente tabla se detalla la compatibilidad de los campos de partición por entidad:

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

Ejemplo:

```
Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2023-01-15T11:18:39.205Z"
        "UPPER_BOUND": "2023-02-15T11:18:39.205Z"
        "NUM_PARTITIONS": "2"
    }
```