Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Esquemas y conjuntos de datos personalizados
<a name="custom-datasets-and-schemas"></a>

Cuando crea un grupo de conjuntos de datos personalizados, crea sus propios esquemas desde cero. Los conjuntos de datos y esquemas de grupos de conjuntos de datos personalizados tienen menos campos obligatorios y mayor flexibilidad. En los siguientes temas se explican los requisitos de esquema y de datos para los conjuntos de datos de un grupo de conjuntos de datos personalizados. Cada sección del conjunto de datos enumera los datos necesarios para el tipo de conjunto de datos y proporciona un ejemplo de JSON de un esquema. 

Para obtener información sobre los tipos de datos que puede importar en Amazon Personalize, consulte [Tipos de datos que Amazon Personalize puede utilizar](datasets.md). Para obtener información sobre los requisitos generales de esquema de Amazon Personalize, como los requisitos de formato y los tipos de datos de campo disponibles, consulte [Creación de archivos JSON de esquema para los esquemas de Amazon Personalize](how-it-works-dataset-schema.md). Estos requisitos se aplican a todos los esquemas de Amazon Personalize.

**Topics**
+ [Requisitos de esquemas y conjuntos de datos personalizados](#dataset-requirements)
+ [Requisitos del esquema del conjunto de datos de interacciones de elementos (personalizado)](interactions-dataset-requirements.md)
+ [Requisitos del esquema del conjunto de datos de usuarios (personalizado)](user-dataset-requirements.md)
+ [Requisitos del esquema del conjunto de datos de elementos (personalizado)](item-dataset-requirements.md)
+ [Requisitos del esquema del conjunto de datos de acciones (personalizado)](action-dataset-requirements.md)
+ [Requisitos del esquema del conjunto de datos de interacciones de acción (personalizado)](action-interactions-dataset-requirements.md)

## Requisitos de esquemas y conjuntos de datos personalizados
<a name="dataset-requirements"></a>

Al crear un conjunto de datos para un grupo de conjuntos de datos personalizados, cada tipo de conjunto de datos tiene los siguientes campos obligatorios y palabras clave reservadas con los tipos de datos obligatorios.


| Tipo de conjunto de datos | Campos obligatorios | Palabras clave reservadas | 
| --- | --- | --- | 
| Interacciones de elementos ([ejemplo de esquema](interactions-dataset-requirements.md#schema-examples-interactions)) | USER\_ID (`string`)<br />ITEM\_ID (`string`)<br />TIMESTAMP (`long`) | EVENT\_TYPE (`string`)<br />EVENT\_VALUE (`float`, `null`)<br />IMPRESSION (`string`, `null`)<br />RECOMMENDATION\_ID (`string`, `null`)<br />EVENT\_ATTRIBUTION\_SOURCE (`string`, `null`) | 
| Usuarios ([ejemplo de esquema](user-dataset-requirements.md#schema-examples-users)) | USER\_ID (`string`)<br />1 campo de metadatos (`string` categórica o numérica) |  | 
| Elementos ([ejemplo de esquema](item-dataset-requirements.md#schema-examples-items)) | ITEM\_ID (`string`)<br />1 campo de metadatos (campo `string` categórico o textual o campo numérico) | CREATION\_TIMESTAMP (`long`) | 
| Acciones ([ejemplo de esquema](action-dataset-requirements.md#schema-examples-actions)) | ACTION\_ID (`string`)<br />1 campo de metadatos (`string` categórica o numérica) | CREATION\_TIMESTAMP (`long`)<br />VALUE (`long`, `null`)<br />TYPE (`string`, `null`)<br />EXPIRATION\_TIMESTAMP (`long`, `null`)<br />REPEAT\_FREQUENCY (`long`, `null`) | 
| Interacciones de acción ([ejemplo de esquema](action-interactions-dataset-requirements.md#schema-examples-action-interactions)) | USER\_ID (`string`)<br />ACTION\_ID (`string`)<br />EVENT\_TYPE (`string`)<br />TIMESTAMP (`long`) | IMPRESSION (`string`, `null`)<br />RECOMMENDATION\_ID (`string`, `null`) | 

### Campos de metadatos
<a name="metadata-fields"></a>

Los metadatos incluyen campos de cadena o sin cadena que no son obligatorios o que no utilizan una palabra clave reservada. Los esquemas de metadatos tienen las siguientes restricciones: 
+ Los esquemas de usuarios, elementos y acciones requieren al menos un campo de metadatos.
+ Puede agregar como máximo 25 campos de metadatos para un esquema de usuarios, 100 campos de metadatos para un esquema de elementos y 10 campos de metadatos para un esquema de acciones.
+ Si agrega su propio campo de metadatos de tipo `string`, debe incluir el atributo `categorical` o el atributo `textual` (solo los esquemas de elementos admiten campos con el atributo textual). De lo contrario, Amazon Personalize no utilizará el campo al entrenar un modelo.

### Palabras clave reservadas
<a name="reserved-keywords"></a>

Las palabras clave reservadas son campos opcionales que no son de metadatos. Estos campos se consideran reservados porque debe definirlos como su tipo de datos obligatorio al usarlos, y las palabras clave no se pueden usar como valores en sus datos. Los campos de cadenas categóricas reservadas deben tener `categorical` establecido en `true`, mientras que los campos de cadenas reservadas no pueden ser categóricos. Las siguientes son palabras clave reservadas:
+ EVENT\_TYPE: para los conjuntos de datos de interacciones de elementos con uno o más tipos de eventos, como *hacer clic* y *descargar*, use un campo `EVENT_TYPE`. Debe definir un campo EVENT\_TYPE como `string` y no puede establecerse como categórico.
+ EVENT\_VALUE: para los conjuntos de datos de interacciones de elementos que incluyen datos de valor para los eventos, como el porcentaje de un vídeo que ha visto un usuario, use un campo `EVENT_VALUE` con el tipo `float` y, de forma opcional, `null`.
+  CREATION\_TIMESTAMP: para los conjuntos de datos de elementos o acciones con una marca de tiempo para la fecha de creación de cada elemento, use un campo `CREATION_TIMESTAMP` con un tipo `long`. Amazon Personalize utiliza los datos de `CREATION_TIMESTAMP` para calcular la edad de un elemento y ajustar las recomendaciones en consecuencia. Consulte [Datos de la marca de tiempo de creación](items-datasets.md#creation-timestamp-data). 
+  IMPRESSION: para los conjuntos de datos de interacciones de elementos con datos de impresiones explícitos, utilice un campo `IMPRESSION` con el tipo `String` y, si lo desea, el tipo `null`. Las impresiones son listas de elementos que estaban visibles para un usuario cuando interactuaba con un elemento concreto (por ejemplo, al hacer clic o verlo). Para obtener más información, consulte [Datos de impresiones](interactions-datasets.md#interactions-impressions-data). 
+  RECOMMENDATION\_ID: para los conjuntos de datos de interacciones de elementos que utilizan recomendaciones anteriores como datos de impresiones implícitas, si lo desea, utilice un campo `RECOMMENDATION_ID` con el tipo `String` y, opcionalmente, el tipo `null`. 

  No es necesario añadir un campo `RECOMMENDATION_ID` para que Amazon Personalize utilice impresiones implícitas al generar recomendaciones. Puede pasar un valor de `recommendationId` en una operación [PutEvents](API_UBS_PutEvents.md) sin él. Para obtener más información, consulte [Datos de impresiones](interactions-datasets.md#interactions-impressions-data). 
+ VALUE: para los conjuntos de datos de acciones, si tiene datos de valor para algunas de sus acciones o todas, agregue un campo `VALUE` al esquema. Para el tipo, use `long` y, si lo desea, escriba `null`. Para obtener más información sobre las acciones y su valor, consulte [Value data](actions-datasets.md#action-value-data). 
+ ACTION\_EXPIRATION\_TIMESTAMP: para los conjuntos de datos de acciones, si tiene una marca de tiempo de caducidad para algunas de sus acciones o todas, agregue un campo `ACTION_EXPIRATION_TIMESTAMP` al esquema. Para el tipo, use `long` y, si lo desea, escriba `null`. Para obtener más información sobre las marcas de tiempo de caducidad, consulte [Datos de la marca de tiempo de caducidad de la acción](actions-datasets.md#action-expiration-timestamp-data). 
+ REPEAT\_FREQUENCY: para los conjuntos de datos de acciones, si tiene datos de frecuencia de repetición para algunas de sus acciones o todas, agregue un campo `REPEAT_FREQUENCY` al esquema. Para el tipo, use `long` y, si lo desea, escriba `null`. Para obtener más información sobre los datos de frecuencia de repetición, consulte [Datos de frecuencia de repetición](actions-datasets.md#action-repeat-frequency).