Aviso de fim do suporte: em 15 de dezembro de 2025, AWS encerrará o suporte para AWS IoT Analytics. Depois de 15 de dezembro de 2025, você não poderá mais acessar o AWS IoT Analytics console ou os AWS IoT Analytics recursos. Para obter mais informações, consulte [AWS IoT Analytics Fim do suporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Receber notificações de dados atrasadas por meio do Amazon CloudWatch Events
Quando você cria conteúdo do conjunto de dados usando dados da mensagem de um período especificado, alguns dados da mensagem ainda podem não chegar a tempo para serem processados. Para permitir um atraso, você pode especificar um `deltaTime` deslocamento para o `QueryFilter` ao [criar um conjunto](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CreateDataset.html) de dados aplicando uma `queryAction` (uma consulta SQL). AWS IoT Analytics ainda processa os dados que chegam dentro do tempo delta, e o conteúdo do conjunto de dados tem um intervalo de tempo. O recurso de notificação tardia de dados AWS IoT Analytics permite enviar notificações por meio do [Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) quando os dados chegam após o horário delta.
Você pode usar o AWS IoT Analytics console, a [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) ou o [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) para especificar regras de dados atrasados para um conjunto de dados.
Na AWS IoT Analytics API, o `LateDataRuleConfiguration` objeto representa as configurações atrasadas da regra de dados de um conjunto de dados. Esse objeto faz parte do objeto `Dataset` associado a `CreateDataset` e às operações da API `UpdateDataset`.
## Parâmetros
Ao criar uma regra de dados atrasados para um conjunto de dados com AWS IoT Analytics, você deve especificar as seguintes informações:
**`ruleConfiguration` (`LateDataRuleConfiguration`)**
Uma estrutura que contém as informações de configuração de uma regra de dados atrasada.
**`deltaTimeSessionWindowConfiguration`**
Uma estrutura que contém as informações de configuração de uma janela de sessão de tempo delta.
[DeltaTime](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeltaTime.html) especifica um intervalo de tempo. Você pode usar `DeltaTime` para criar conteúdo de conjunto de dados com dados que chegaram ao armazenamento de dados desde a última execução. Para obter um exemplo de `DeltaTime`, consulte [Criação de um conjunto de dados SQL com uma janela delta (CLI)](https://docs.aws.amazon.com/iotanalytics/latest/userguide/automate-create-dataset.html#automate-example6).
**`timeoutInMinutes`**
Um intervalo de tempo. Você pode usar `timeoutInMinutes` para agrupar notificações de dados atrasados que foram geradas desde a última execução. AWS IoT Analytics AWS IoT Analytics envia um lote de notificações para CloudWatch Eventos ao mesmo tempo.
Tipo: inteiro
Intervalo válido: 1-60
**`ruleName`**
O nome da regra de dados atrasados.
Tipo: String
**Importante**
Para especificar `lateDataRules`, o conjunto de dados deve usar um filtro `DeltaTime`.
## Configurar regras de dados atrasados (console)
O procedimento a seguir mostra como configurar a regra de dados atrasados de um conjunto de dados no console AWS IoT Analytics .
**Para configurar regras de dados atrasados**
1. Faça login no [console do AWS IoT Analytics](https://console.aws.amazon.com/iotanalytics/).
1. No painel de navegação, escolha **Conjunto de dados**.
1. Em **Conjuntos de dados**, escolha o conjunto de dados de destino.
1. No painel de navegação, escolha **Detalhes**.
1. Na seção **Janela delta**, escolha **Editar**.
1. Em **Configurar filtro de seleção de dados**, faça o seguinte:
1. Em **Janela de seleção de dados**, escolha **Hora delta**.
1. Em **Deslocamento**, insira um período de tempo e escolha uma unidade.
1. Em **Expressão de timestamp**, insira uma expressão. Esse pode ser o nome de um campo de carimbo de data/hora ou de uma expressão SQL que pode derivar a hora, como. *from\$1unixtime(time)*
Para obter mais informações sobre como escrever uma expressão timestamp, consulte [Funções de data e hora e operadores](https://prestodb.io/docs/0.172/functions/datetime.html), na *Documentação do Presto 0.172*.
1. Para **Notificação de dados atrasada**, escolha **Ativo**.
1. Em **Hora delta**, insira um número inteiro. O intervalo válido é 1-60.
1. Escolha **Salvar**.
![\[Configure o filtro de seleção de dados no AWS IoT Analytics console.\]](http://docs.aws.amazon.com/pt_br/iotanalytics/latest/userguide/images/late-data-notification-1.png)
## Configurar regras de dados atrasada (CLI)
Na AWS IoT Analytics API, o `LateDataRuleConfiguration` objeto representa as configurações atrasadas da regra de dados de um conjunto de dados. Esse objeto faz parte do objeto `Dataset` associado a `CreateDataset` e `UpdateDataset`. Você pode usar a [API](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/), [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html) ou [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) para especificar regras de dados atrasados para um conjunto de dados. O exemplo a seguir usa a AWS CLI.
Para criar o conjunto de dados com regras de dados atrasados especificadas, execute o comando a seguir. O comando a seguir pressupõe que o arquivo `dataset.json` esteja no diretório atual.
**nota**
Você pode usar a [UpdateDataset](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UpdateDataset.html)API para atualizar um conjunto de dados existente.
```
aws iotanalytics create-dataset --cli-input-json file://dataset.json
```
O arquivo `dataset.json` deve conter o seguinte:
+ *demo\$1dataset*Substitua pelo nome do conjunto de dados de destino.
+ *demo\$1datastore*Substitua pelo nome do armazenamento de dados de destino.
+ *from\$1unixtime(time)*Substitua pelo nome de um campo de carimbo de data/hora ou de uma expressão SQL que possa derivar a hora.
Para obter mais informações sobre como escrever uma expressão timestamp, consulte [Funções de data e hora e operadores](https://prestodb.io/docs/0.172/functions/datetime.html), na *Documentação do Presto 0.172*.
+ *timeout*Substitua por um número inteiro entre 1—60.
+ *demo\$1rule*Substitua por qualquer nome.
```
{
"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"
}
]
}
```
## Assinando para receber notificações de dados atrasados
Você pode criar regras em CloudWatch Eventos que definam como processar notificações de dados atrasadas enviadas de AWS IoT Analytics. Quando o CloudWatch Events recebe as notificações, ele invoca as ações-alvo especificadas nas suas regras.
### Pré-requisitos para criar regras de eventos CloudWatch
Antes de criar uma regra de CloudWatch eventos para AWS IoT Analytics, você deve fazer o seguinte:
+ Familiarize-se com eventos, regras e metas em CloudWatch Eventos.
+ Crie e configure os [alvos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) invocados por suas regras de CloudWatch eventos. As regras podem invocar muitos tipos de destinos, como:
+ Fluxos do Amazon Kinesis
+ AWS Lambda funções
+ Amazon Simple Notification Service (Amazon SNS) topics
+ Filas do Amazon Simple Queue Service (Amazon SQS)
Sua regra de CloudWatch eventos e os alvos associados devem estar na AWS região em que você criou seus AWS IoT Analytics recursos. Para obter mais informações, consulte [Endpoints e cotas do serviço](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) na *Referência geral da AWS*.
Para obter mais informações, consulte [O que são CloudWatch eventos?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) e [Introdução ao Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) no *Guia do usuário do Amazon CloudWatch Events*.
### Evento de notificação de dados atrasados
O evento para notificações de dados atrasados usa o formato a seguir.
```
{
"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
}
}
```
### Crie uma regra de CloudWatch eventos para receber notificações de dados atrasadas
O procedimento a seguir mostra como criar uma regra que envia notificações de dados AWS IoT Analytics atrasados para uma fila do Amazon SQS.
**Para criar uma regra de CloudWatch eventos**
1. Faça login no [ CloudWatchconsole da Amazon](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, em **Eventos**, escolha **Regras**.
1. Na página **Regras**, selecione **Criar uma regra**.
1. Em **Fonte do evento**, selecione **Padrão do evento**.
1. Na seção **Construir padrão de eventos para corresponder a eventos por serviço**, faça o seguinte:
1. Em **Nome do serviço**, escolha **IoT Analytics**
1. Em **Tipo de evento**, escolha **Notificação do ciclo de vida do conjunto de dados do IoT Analytics**.
1. Escolha **nome(s) específicos do conjunto de dados** e, em seguida, insira o nome do conjunto de dados de destino.
1. Em **Destinos**, escolha **Adicionar destino\$1**.
1. Selecione **Fila do SQS** e faça o seguinte:
1. Em **Fila\$1**, escolha a fila de destino.
1. Escolha **Configure details (Configurar detalhes)**.
1. Na página **Etapa 2: Configurar detalhes da regra** insira um nome e uma descrição.
1. Escolha **Criar regra**.