Avis de fin de support : le 15 décembre 2025, AWS le support de AWS IoT Analytics. Après le 15 décembre 2025, vous ne pourrez plus accéder à la AWS IoT Analytics console ni aux AWS IoT Analytics ressources. Pour plus d'informations, voir [AWS IoT Analytics fin du support](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Recevoir des notifications de données en retard via Amazon CloudWatch Events
Lorsque vous créez le contenu d'un ensemble de données à partir de données issues d'une période spécifiée, certaines données peuvent ne pas arriver à temps pour être traitées. Pour permettre un délai, vous pouvez spécifier un `deltaTime` décalage `QueryFilter` lors de la [création d'un ensemble de données](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CreateDataset.html) en appliquant une `queryAction` (une requête SQL). AWS IoT Analytics traite toujours les données qui arrivent dans le temps delta, et le contenu de votre ensemble de données est décalé dans le temps. La fonctionnalité de notification tardive des données permet AWS IoT Analytics d'envoyer des notifications via [Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) lorsque les données arrivent après l'heure delta.
Vous pouvez utiliser la AWS IoT Analytics console, l'[API AWS Command Line Interface](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/) [(AWS CLI)](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html) ou le [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) pour définir les règles relatives aux données tardives pour un ensemble de données.
Dans l' AWS IoT Analytics API, l'`LateDataRuleConfiguration`objet représente les derniers paramètres des règles de données d'un ensemble de données. Cet objet fait partie de l'`Dataset`objet associé aux opérations `CreateDataset` et à `UpdateDataset` l'API.
## Paramètres
Lorsque vous créez une règle de données en retard pour un ensemble de données avec AWS IoT Analytics, vous devez spécifier les informations suivantes :
**`ruleConfiguration` (`LateDataRuleConfiguration`)**
Structure contenant les informations de configuration d'une règle de données tardive.
**`deltaTimeSessionWindowConfiguration`**
Structure qui contient les informations de configuration d'une fenêtre de session de temps delta.
[DeltaTime](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeltaTime.html) spécifie un intervalle de temps. Vous pouvez utiliser `DeltaTime` pour créer un contenu d'ensemble de données avec des données arrivées dans le magasin de données depuis la dernière exécution. Pour un exemple`DeltaTime`, voir [Création d'un jeu de données SQL avec une fenêtre delta (CLI)](https://docs.aws.amazon.com/iotanalytics/latest/userguide/automate-create-dataset.html#automate-example6).
**`timeoutInMinutes`**
Intervalle de temps. Vous pouvez l'utiliser `timeoutInMinutes` pour regrouper les notifications de données en retard générées depuis la dernière exécution. AWS IoT Analytics AWS IoT Analytics envoie un lot de notifications à CloudWatch Events à la fois.
Type : entier
Plage valide : 1 à 60
**`ruleName`**
Nom de la règle de données tardives.
Type : String
**Important**
Pour le spécifier`lateDataRules`, l'ensemble de données doit utiliser un `DeltaTime` filtre.
## Configuration des règles relatives aux données tardives (console)
La procédure suivante explique comment configurer la règle des données tardives d'un ensemble de données dans la AWS IoT Analytics console.
**Pour configurer les règles relatives aux données tardives**
1. Connectez-vous à la [console AWS IoT Analytics](https://console.aws.amazon.com/iotanalytics/).
1. Dans le volet de navigation, sélectionnez **Ensembles de données**.
1. Sous **Ensembles de données**, choisissez le jeu de données cible.
1. Dans le volet de navigation, sélectionnez **Détails**.
1. Dans la section de **la fenêtre Delta**, choisissez **Modifier**.
1. Sous **Configurer le filtre de sélection des données**, procédez comme suit :
1. Pour la **fenêtre de sélection des données**, choisissez **Delta time**.
1. Pour **Décalage**, entrez une période, puis choisissez une unité.
1. Pour Expression d'**horodatage, entrez une expression**. Il peut s'agir du nom d'un champ d'horodatage ou d'une expression SQL permettant de déduire l'heure, par exemple. *from\$1unixtime(time)*
Pour plus d'informations sur la façon d'écrire une expression d'horodatage, voir [Fonctions et opérateurs de date et d'heure](https://prestodb.io/docs/0.172/functions/datetime.html) dans la documentation de *Presto 0.172*.
1. Pour **la notification tardive des données**, sélectionnez **Actif**.
1. Pour l'**heure Delta**, entrez un entier. La plage valide est comprise entre 1 et 60.
1. Choisissez **Enregistrer**.
![\[Configurez le filtre de sélection des données dans la AWS IoT Analytics console.\]](http://docs.aws.amazon.com/fr_fr/iotanalytics/latest/userguide/images/late-data-notification-1.png)
## Configuration des règles relatives aux données tardives (CLI)
Dans l' AWS IoT Analytics API, l'`LateDataRuleConfiguration`objet représente les derniers paramètres des règles de données d'un ensemble de données. Cet objet fait partie de l'`Dataset`objet associé à `CreateDataset` et`UpdateDataset`. Vous pouvez utiliser l'[API](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/) ou le [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) pour définir les règles relatives aux données tardives pour un ensemble de données. [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html) L'exemple suivant repose sur AWS CLI.
Pour créer votre ensemble de données avec des règles de données tardives spécifiées, exécutez la commande suivante. La commande suppose que le `dataset.json` fichier se trouve dans le répertoire en cours.
**Note**
Vous pouvez utiliser l'[UpdateDataset](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UpdateDataset.html)API pour mettre à jour un ensemble de données existant.
```
aws iotanalytics create-dataset --cli-input-json file://dataset.json
```
Le `dataset.json` fichier doit contenir les éléments suivants :
+ Remplacez *demo\$1dataset* par le nom du jeu de données cible.
+ Remplacez *demo\$1datastore* par le nom du magasin de données cible.
+ *from\$1unixtime(time)*Remplacez-le par le nom d'un champ d'horodatage ou d'une expression SQL permettant de dériver l'heure.
Pour plus d'informations sur la façon d'écrire une expression d'horodatage, voir [Fonctions et opérateurs de date et d'heure](https://prestodb.io/docs/0.172/functions/datetime.html) dans la documentation de *Presto 0.172*.
+ Remplacez *timeout* par un entier compris entre 1 et 60.
+ Remplacez *demo\$1rule* par n'importe quel nom.
```
{
"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"
}
]
}
```
## S'abonner pour recevoir des notifications de données tardives
Vous pouvez créer des règles dans CloudWatch Events qui définissent comment traiter les notifications de données en retard envoyées depuis AWS IoT Analytics. Lorsque CloudWatch Events reçoit les notifications, il invoque les actions cibles spécifiées dans vos règles.
### Conditions préalables à la création de règles relatives CloudWatch aux événements
Avant de créer une règle d' CloudWatch événements pour AWS IoT Analytics, vous devez effectuer les opérations suivantes :
+ Familiarisez-vous avec les événements, les règles et les cibles dans CloudWatch Événements.
+ Créez et configurez les [cibles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) invoquées par vos règles d' CloudWatch événements. Les règles peuvent invoquer de nombreux types de cibles, tels que les suivants :
+ Amazon Kinesis Streams
+ AWS Lambda fonctions
+ Rubriques Amazon Simple Notification Service (Amazon SNS)
+ Files d’attente Amazon Simple Queue Service (Amazon SQS)
Votre règle relative aux CloudWatch événements et les cibles associées doivent se trouver dans la AWS région où vous avez créé vos AWS IoT Analytics ressources. Pour plus d'informations, consultez la section [Points de terminaison et quotas du service](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) dans le *Références générales AWS*.
Pour plus d'informations, voir [Qu'est-ce que CloudWatch les événements ?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) et [Getting started with Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) dans le *guide de l'utilisateur Amazon CloudWatch Events*.
### Événement de notification de données tardif
L'événement relatif aux notifications de données tardives utilise le format suivant.
```
{
"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
}
}
```
### Créez une règle d' CloudWatch événements pour recevoir des notifications de données en retard
La procédure suivante explique comment créer une règle qui envoie des notifications de données AWS IoT Analytics en retard à une file d'attente Amazon SQS.
**Pour créer une règle d' CloudWatch événements**
1. Connectez-vous à la [ CloudWatchconsole Amazon](https://console.aws.amazon.com/cloudwatch/).
1. Sous **Events** (Événements) dans le panneau de navigation, choisissez **Rules** (Règles).
1. Sur la page **Règles**, choisissez **Créer une règle**.
1. Sous **Source d'événement**, choisissez **Event Pattern**.
1. Dans la section **Créer un modèle d'événement correspondant aux événements par service**, procédez comme suit :
1. Pour le **nom du service**, choisissez **IoT Analytics**
1. Pour **Type d'événement**, choisissez **IoT Analytics Dataset Lifecycle Notification**.
1. Choisissez **Nom (s) de jeu de données spécifique**, puis entrez le nom du jeu de données cible.
1. Sous **Cibles**, choisissez **Ajouter une cible\$1**.
1. Choisissez la **file d'attente SQS**, puis procédez comme suit :
1. Pour **Queue\$1**, choisissez la file d'attente cible.
1. Choisissez **Configure details** (Configurer les détails).
1. Sur la page **Étape 2 : Configuration des détails des règles**, entrez un nom et une description.
1. Choisissez **Créer une règle**.