Aviso de fin del soporte: el 15 de diciembre de 2025, AWS finalizará el soporte para AWS IoT Analytics. Después del 15 de diciembre de 2025, ya no podrás acceder a la AWS IoT Analytics consola ni a AWS IoT Analytics los recursos. Para obtener más información, consulta [AWS IoT Analytics el fin del soporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
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.
# Recibir notificaciones de datos tardías a través de Amazon CloudWatch Events
Al crear contenidos de conjuntos de datos con datos de mensajes de un periodo de tiempo determinado, es posible que algunos de estos datos no lleguen a tiempo para ser procesados. Para permitir un retraso, puede especificar una `deltaTime` compensación para `QueryFilter` cuando [cree un conjunto de datos](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CreateDataset.html) mediante la aplicación de una `queryAction` (una consulta SQL). AWS IoT Analytics sigue procesando los datos que llegan dentro del tiempo delta y el contenido del conjunto de datos tiene un desfase temporal. La función de notificación de datos atrasados permite enviar notificaciones AWS IoT Analytics a través de [Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) cuando los datos llegan después de la hora delta.
Puede usar la AWS IoT Analytics consola, la [API](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/), [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html) o el [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) para especificar las reglas de datos atrasados para un conjunto de datos.
En la AWS IoT Analytics API, el `LateDataRuleConfiguration` objeto representa la configuración de las reglas de datos tardíos de un conjunto de datos. Este objeto forma parte del objeto `Dataset` asociado a las operaciones `CreateDataset` y `UpdateDataset` de la API.
## Parámetros
Al crear una regla de datos atrasados para un conjunto de datos con AWS IoT Analytics, debes especificar la siguiente información:
**`ruleConfiguration` (`LateDataRuleConfiguration`)**
Una estructura que contiene la información de configuración de una regla de datos tardíos.
**`deltaTimeSessionWindowConfiguration`**
Una estructura que contiene la información de configuración de una ventana de sesión de tiempo delta.
[DeltaTime](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeltaTime.html) especifica un intervalo de tiempo. Puede utilizar `DeltaTime` para crear contenido de un conjunto de datos con los datos que hayan llegado al almacén de datos desde la última ejecución. Para ver un ejemplo de `DeltaTime`, consulte [Creación de un conjunto de datos SQL con una ventana diferencial (CLI)](https://docs.aws.amazon.com/iotanalytics/latest/userguide/automate-create-dataset.html#automate-example6).
**`timeoutInMinutes`**
Un intervalo de tiempo. Puede utilizarla `timeoutInMinutes` para AWS IoT Analytics agrupar las notificaciones de datos atrasados que se han generado desde la última ejecución. AWS IoT Analytics envía un lote de notificaciones a CloudWatch Events a la vez.
Tipo: entero
Rango válido: 1-60
**`ruleName`**
El nombre de la regla de datos tardíos.
Tipo: cadena
**importante**
Para especificar `lateDataRules`, el conjunto de datos debe utilizar un filtro `DeltaTime`.
## Configuración de las reglas de datos atrasados (consola)
En el siguiente procedimiento se explica cómo configurar la regla de datos atrasados de un conjunto de datos en la consola de AWS IoT Analytics .
**Para configurar las reglas de datos atrasados**
1. Inicie sesión en la [consola de AWS IoT Analytics](https://console.aws.amazon.com/iotanalytics/).
1. En el panel de navegación, seleccione **Conjuntos de datos**.
1. En **Conjuntos de datos**, seleccione el conjunto de datos de destino.
1. En el panel de navegación, seleccione **Detalles**.
1. En la sección **Ventana diferencial**, seleccione **Editar**.
1. En **Configurar el filtro de selección de datos**, haga lo siguiente:
1. En la **ventana de Selección de datos**, seleccione **Tiempo delta**.
1. En **Desplazamiento**, introduzca un período de tiempo y, a continuación, seleccione una unidad.
1. En **Expresión de marca de tiempo**, introduzca una expresión. Puede ser el nombre de un campo de marca de tiempo o una expresión SQL que pueda derivar la hora, por ejemplo. *from\$1unixtime(time)*
Para obtener más información sobre cómo escribir una expresión de marca de tiempo, consulte [Funciones y operadores de fecha y hora](https://prestodb.io/docs/0.172/functions/datetime.html), en la *documentación de Presto 0.172*.
1. En **Notificación de datos atrasados**, seleccione **Activo**.
1. En **Tiempo diferencia**, introduzca un número entero. El rango válido es de 1 a 60.
1. Seleccione **Save**.
![\[Configure el filtro de selección de datos en la AWS IoT Analytics consola.\]](http://docs.aws.amazon.com/es_es/iotanalytics/latest/userguide/images/late-data-notification-1.png)
## Configuración de reglas de datos atrasados (CLI)
En la AWS IoT Analytics API, el `LateDataRuleConfiguration` objeto representa la configuración de las reglas de datos tardíos de un conjunto de datos. Este objeto forma parte del objeto `Dataset` asociado a `CreateDataset` y `UpdateDataset`. Puede usar la [API](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/), [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html), o el [SDK de AWS](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) para especificar reglas de datos atrasados para un conjunto de datos. El siguiente ejemplo utiliza AWS CLI.
Use el siguiente comando para crear un conjunto de datos atrasados específicos. El comando da por hecho que el archivo `dataset.json` está en el directorio actual.
**nota**
Puedes usar la [UpdateDataset](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UpdateDataset.html)API para actualizar un conjunto de datos existente.
```
aws iotanalytics create-dataset --cli-input-json file://dataset.json
```
El archivo `dataset.json` debe contener lo siguiente:
+ *demo\$1dataset*Sustitúyalo por el nombre del conjunto de datos de destino.
+ *demo\$1datastore*Sustitúyalo por el nombre del banco de datos de destino.
+ *from\$1unixtime(time)*Sustitúyalo por el nombre de un campo de marca de tiempo o una expresión SQL que pueda derivar la hora.
Para obtener más información sobre cómo escribir una expresión de marca de tiempo, consulte [Funciones y operadores de fecha y hora](https://prestodb.io/docs/0.172/functions/datetime.html), en la *documentación de Presto 0.172*.
+ *timeout*Sustitúyalo por un número entero comprendido entre 1 y 60.
+ *demo\$1rule*Sustitúyalo por cualquier nombre.
```
{
"datasetName": "demo_dataset",
"actions": [
{
"actionName": "myDatasetAction",
"queryAction": {
"filters": [
{
"deltaTime": {
"offsetSeconds": -180,
"timeExpression": "from_unixtime(time)"
}
}
],
"sqlQuery": "SELECT * FROM demo_datastore"
}
}
],
"retentionPeriod": {
"unlimited": false,
"numberOfDays": 90
},
"lateDataRules": [
{
"ruleConfiguration": {
"deltaTimeSessionWindowConfiguration": {
"timeoutInMinutes": timeout
}
},
"ruleName": "demo_rule"
}
]
}
```
## Suscripción para recibir notificaciones de datos atrasados
Puede crear reglas en CloudWatch Events que definan cómo procesar las notificaciones de datos tardías enviadas desde AWS IoT Analytics. Cuando CloudWatch Events recibe las notificaciones, invoca las acciones objetivo especificadas definidas en tus reglas.
### Requisitos previos para crear reglas de eventos CloudWatch
Antes de crear una regla de CloudWatch eventos para AWS IoT Analytics, debe hacer lo siguiente:
+ Familiarícese con los eventos, las reglas y los objetivos de CloudWatch Eventos.
+ Crea y configura los [objetivos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) invocados por tus reglas de CloudWatch eventos. Las reglas pueden invocar muchos tipos de destinos, como los siguientes:
+ Flujos de Amazon Kinesis
+ AWS Lambda funciones
+ Temas de Amazon Simple Notification Service (Amazon SNS)
+ Colas de Amazon Simple Queue Service (Amazon SQS)
Tus CloudWatch eventos gobiernan y los objetivos asociados deben estar en la AWS región en la que creaste tus AWS IoT Analytics recursos. Para obtener más información, consulte [Puntos de enlace y cuotas](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) en la *Referencia general de AWS*.
Para obtener más información, consulta [¿Qué son CloudWatch los eventos?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) y [Introducción a Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) en la *Guía del usuario de Amazon CloudWatch Events*.
### Evento de notificaciones de datos atrasados
El evento de notificaciones de datos atrasados utiliza el siguiente formato.
```
{
"version": "0",
"id": "7f51dfa7-ffef-97a5-c625-abddbac5eadd",
"detail-type": "IoT Analytics Dataset Lifecycle Notification",
"source": "aws.iotanalytics",
"account": "123456789012",
"time": "2020-05-14T02:38:46Z",
"region": "us-east-2",
"resources": ["arn:aws:iotanalytics:us-east-2:123456789012:dataset/demo_dataset"],
"detail": {
"event-detail-version": "1.0",
"dataset-name": "demo_dataset",
"late-data-rule-name": "demo_rule",
"version-ids": ["78244852-8737-4650-aa4d-3071a01338fa"],
"message": null
}
}
```
### Cree una regla de CloudWatch eventos para recibir notificaciones de datos tardías
El siguiente procedimiento muestra cómo crear una regla que envíe notificaciones de datos AWS IoT Analytics atrasados a una cola de Amazon SQS.
**Para crear una regla de eventos CloudWatch**
1. Inicia sesión en la [ CloudWatchconsola de Amazon](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, en **Events (Eventos)**, seleccione **Rules (Reglas)**.
1. En la página **Reglas**, seleccione **Crear una regla**.
1. En **Origen de eventos**, seleccione **Patrón de eventos**.
1. En la sección **Crear patrón de eventos para buscar eventos coincidentes por servicio**, haga lo siguiente:
1. En **Nombre del servicio**, seleccione **IoT Analytics**
1. En **Tipo de evento**, seleccione **Notificación del ciclo de vida del conjunto de datos de IoT Analytics**.
1. Seleccione **Nombre o nombres de conjuntos de datos específicos** y, a continuación, introduzca el nombre del conjunto de datos de destino.
1. En **Destinos**, seleccione **Añadir objetivo\$1**.
1. Seleccione **Cola SQS** y, a continuación, haga lo siguiente:
1. En **Cola\$1**, seleccione la cola de destino.
1. Seleccione **Configure details (Configurar detalles)**.
1. En la página **Paso 2: configurar detalles de la regla**, escriba el nombre y una descripción.
1. Seleccione **Create rule (Crear regla)**.