Avviso di fine del supporto: il 15 dicembre 2025, AWS terminerà il supporto per AWS IoT Analytics. Dopo il 15 dicembre 2025, non potrai più accedere alla AWS IoT Analytics console o AWS IoT Analytics alle risorse. Per ulteriori informazioni, consulta [AWS IoT Analytics Fine del supporto](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Ricevere notifiche sui dati in ritardo tramite Amazon CloudWatch Events
Quando crei contenuti del set di dati utilizzando dati relativi a un intervallo di tempo specificato, alcuni dati potrebbero non arrivare in tempo per l'elaborazione. Per consentire un ritardo, è possibile specificare un `deltaTime` offset per la `QueryFilter` [creazione di un set di dati applicando una](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CreateDataset.html) `queryAction` (una query SQL). AWS IoT Analytics elabora comunque i dati che arrivano entro il delta time e il contenuto del set di dati presenta un ritardo. La funzionalità di notifica dei dati in ritardo AWS IoT Analytics consente di inviare notifiche tramite [Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) quando i dati arrivano dopo il delta time.
Puoi utilizzare la AWS IoT Analytics console, l'[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 l'[AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) per specificare le regole relative ai dati in ritardo per un set di dati.
Nell' AWS IoT Analytics API, l'`LateDataRuleConfiguration`oggetto rappresenta le impostazioni delle regole relative ai dati tardivi di un set di dati. Questo oggetto fa parte dell'`Dataset`oggetto associato alle operazioni `CreateDataset` e `UpdateDataset` API.
## Parametri
Quando si crea una regola relativa ai dati tardivi per un set di dati con AWS IoT Analytics, è necessario specificare le seguenti informazioni:
**`ruleConfiguration` (`LateDataRuleConfiguration`)**
Una struttura che contiene le informazioni di configurazione di una regola relativa ai dati in ritardo.
**`deltaTimeSessionWindowConfiguration`**
Una struttura che contiene le informazioni di configurazione di una finestra di sessione delta time.
[DeltaTime](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeltaTime.html) specifica un intervallo di tempo. Puoi utilizzare `DeltaTime` per creare il contenuto del set di dati con i dati che sono arrivati nel datastore dall'ultima esecuzione. Per un esempio di`DeltaTime`, consulta [Creazione di un set di dati SQL con una finestra delta (CLI)](https://docs.aws.amazon.com/iotanalytics/latest/userguide/automate-create-dataset.html#automate-example6).
**`timeoutInMinutes`**
Un intervallo di tempo. È possibile utilizzare `timeoutInMinutes` To That AWS IoT Analytics per raggruppare in batch le notifiche di dati tardive generate dall'ultima esecuzione. AWS IoT Analytics invia un batch di notifiche a CloudWatch Events contemporaneamente.
Tipo: integer
Intervallo valido: 1-60
**`ruleName`**
Il nome della regola dati in ritardo.
▬Tipo: stringa
**Importante**
Per specificare`lateDataRules`, il set di dati deve utilizzare un `DeltaTime` filtro.
## Configura le regole relative ai dati tardivi (console)
La procedura seguente mostra come configurare la regola relativa ai dati in ritardo di un set di dati nella AWS IoT Analytics console.
**Per configurare le regole relative ai dati in ritardo**
1. Accedi alla [console AWS IoT Analytics](https://console.aws.amazon.com/iotanalytics/).
1. Nel riquadro di navigazione, scegli **Set di dati**.
1. In **Set di dati**, scegli il set di dati di destinazione.
1. Nel riquadro di navigazione, scegli **Dettagli**.
1. Nella sezione della **finestra Delta**, scegli **Modifica**.
1. In **Configura il filtro di selezione dei dati**, procedi come segue:
1. Per la **finestra di selezione dei dati**, scegli **Delta time**.
1. Per **Offset**, inserisci un periodo di tempo, quindi scegli un'unità.
1. Per l'espressione **Timestamp, immettete un'espressione**. Può essere il nome di un campo timestamp o un'espressione SQL che può derivare l'ora, ad esempio. *from\$1unixtime(time)*
*Per ulteriori informazioni su come scrivere un'espressione timestamp, vedere [Funzioni e operatori di data e ora nella documentazione di Presto](https://prestodb.io/docs/0.172/functions/datetime.html) 0.172.*
1. **Per la **notifica tardiva dei dati, scegli Attivo**.**
1. Per **Delta time**, inserisci un numero intero. L'intervallo valido è compreso tra 1 e 60.
1. Scegli **Save** (Salva).
![\[Configura il filtro di selezione dei dati nella AWS IoT Analytics console.\]](http://docs.aws.amazon.com/it_it/iotanalytics/latest/userguide/images/late-data-notification-1.png)
## Configurazione delle regole relative ai dati tardivi (CLI)
Nell' AWS IoT Analytics API, l'`LateDataRuleConfiguration`oggetto rappresenta le impostazioni delle regole relative ai dati in ritardo di un set di dati. Questo oggetto fa parte dell'`Dataset`oggetto associato a `CreateDataset` and`UpdateDataset`. Puoi utilizzare l'[API](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/) o l'[AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) per specificare le regole relative ai dati in ritardo per un set di dati. [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html) Gli esempi seguenti utilizzano AWS CLI.
Per creare il set di dati con le regole specificate per i dati in ritardo, esegui il comando seguente. Il comando presuppone che il `dataset.json` file si trovi nella directory corrente.
**Nota**
È possibile utilizzare l'[UpdateDataset](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UpdateDataset.html)API per aggiornare un set di dati esistente.
```
aws iotanalytics create-dataset --cli-input-json file://dataset.json
```
Il `dataset.json` file deve contenere quanto segue:
+ Sostituisci *demo\$1dataset* con il nome del set di dati di destinazione.
+ Sostituisci *demo\$1datastore* con il nome del data store di destinazione.
+ Sostituisci *from\$1unixtime(time)* con il nome di un campo timestamp o un'espressione SQL che può derivare l'ora.
*Per ulteriori informazioni su come scrivere un'espressione timestamp, vedere [Funzioni e operatori di data e ora nella documentazione di Presto](https://prestodb.io/docs/0.172/functions/datetime.html) 0.172.*
+ Sostituire *timeout* con un numero intero compreso tra 1 e 60.
+ Sostituisci *demo\$1rule* con un nome qualsiasi.
```
{
"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"
}
]
}
```
## Iscrizione per ricevere notifiche relative ai dati in ritardo
In CloudWatch Events puoi creare regole che definiscano come elaborare le notifiche relative ai dati in ritardo inviate da AWS IoT Analytics. Quando CloudWatch Events riceve le notifiche, richiama le azioni mirate specificate definite nelle regole.
### Prerequisiti per la creazione di regole relative agli eventi CloudWatch
Prima di creare una regola CloudWatch Events per AWS IoT Analytics, è necessario effettuare le seguenti operazioni:
+ Acquisisci familiarità con gli eventi, le regole e gli obiettivi in CloudWatch Events.
+ Crea e configura i [target](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) richiamati dalle tue CloudWatch regole Events. Le regole possono richiamare molti tipi di obiettivi, come i seguenti:
+ Flussi Amazon Kinesis
+ AWS Lambda funzioni
+ Argomenti su Amazon Simple Notification Service (Amazon SNS)
+ Code di Amazon Simple Queue Service (Amazon SQS)
La tua regola CloudWatch Eventi e gli obiettivi associati devono trovarsi nella AWS regione in cui hai creato AWS IoT Analytics le tue risorse. Per ulteriori informazioni, consulta [Endpoint e quote del servizio](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) in. *Riferimenti generali di AWS*
Per ulteriori informazioni, consulta [What is CloudWatch Events?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) e [Guida introduttiva ad Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) nella *Amazon CloudWatch Events User Guide*.
### Evento di notifica tardiva dei dati
L'evento per le notifiche di dati in ritardo utilizza il seguente 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
}
}
```
### Crea una regola CloudWatch Events per ricevere notifiche relative ai dati in ritardo
La procedura seguente mostra come creare una regola che invii notifiche di dati in AWS IoT Analytics ritardo a una coda Amazon SQS.
**Per creare una regola Events CloudWatch**
1. Accedi alla [ CloudWatchconsole Amazon](https://console.aws.amazon.com/cloudwatch/).
1. Nel pannello di navigazione, in **Events (Eventi)**, scegli **Rules (Regole)**.
1. Nella pagina **Regole**, scegli **Crea regola**.
1. In **Origine evento**, scegli **Event Pattern**.
1. Nella sezione **Crea un modello di eventi per abbinare gli eventi per servizio**, procedi come segue:
1. Per **Service Name**, scegli **IoT Analytics**
1. Per **Tipo di evento**, scegli **IoT Analytics Dataset Lifecycle Notification**.
1. Scegli **i nomi dei set di dati specifici**, quindi inserisci il nome del set di dati di destinazione.
1. In **Obiettivi**, scegli **Aggiungi obiettivo\$1**.
1. Scegli la **coda SQS**, quindi procedi come segue:
1. Per **Queue\$1**, scegli la coda di destinazione.
1. Scegli **Configura dettagli**.
1. Nella pagina **Passo 2: Configurazione dei dettagli della regola**, inserisci un nome e una descrizione.
1. Scegli **Crea regola**.