지원 종료 알림: 2025년 12월 15일에 AWS 에 대한 지원이 종료됩니다 AWS IoT 분석. 2025년 12월 15일 이후에는 AWS IoT 분석 콘솔 또는 AWS IoT 분석 리소스에 더 이상 액세스할 수 없습니다. 자세한 내용은 [AWS IoT 분석 지원 종료를 참조하세요](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon CloudWatch Events를 통해 지연 데이터 알림 받기
지정 기간 내의 데이터를 사용해 데이터 세트 콘텐츠를 생성할 때, 일부 데이터가 처리할 시간 내에 도착하지 않을 수도 있습니다. 지연을 허용하려면 `queryAction` (SQL 쿼리)를 적용하여 [데이터 세트를 생성할](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CreateDataset.html) `QueryFilter` 때에 대한 `deltaTime` 오프셋을 지정할 수 있습니다. AWS IoT 분석 는 여전히 델타 시간 내에 도착하는 데이터를 처리하고 데이터 세트 콘텐츠에는 시간 지연이 있습니다. 지연 데이터 알림 기능을 사용하면 델타 시간 이후에 데이터가 도착할 때 AWS IoT 분석 가 [Amazon CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html)를 통해 알림을 보낼 수 있습니다.
AWS IoT 분석 콘솔, [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) 또는 [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html)를 사용하여 데이터 세트에 대한 지연 데이터 규칙을 지정할 수 있습니다.
AWS IoT 분석 API에서 `LateDataRuleConfiguration` 객체는 데이터 세트의 지연 데이터 규칙 설정을 나타냅니다. 이 객체는 `CreateDataset` 및 `UpdateDataset` API 작업과 관련된 `Dataset` 객체에 포함되어 있습니다.
## 파라미터
를 사용하여 데이터 세트에 대한 지연 데이터 규칙을 생성할 때 다음 정보를 지정 AWS IoT 분석해야 합니다.
**`ruleConfiguration` (`LateDataRuleConfiguration`)**
지연 데이터 규칙의 구성 정보를 포함하는 구조입니다.
**`deltaTimeSessionWindowConfiguration`**
델타 시간 세션 기간의 구성 정보를 포함하는 구조입니다.
[DeltaTime](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeltaTime.html)은 시간 간격을 지정합니다. `DeltaTime`을 사용하면 마지막 실행 이후 데이터 스토어에 도착한 데이터로 데이터 세트 콘텐츠를 생성할 수 있습니다. `DeltaTime`의 예제를 알아보려면 [델타 기간으로 SQL 데이터 세트 생성(CLI)](https://docs.aws.amazon.com/iotanalytics/latest/userguide/automate-create-dataset.html#automate-example6)을 참조하십시오.
**`timeoutInMinutes`**
시간 간격입니다. AWS IoT 분석 가 마지막 실행 이후 생성된 지연 데이터 알림을 일괄 처리할 수 `timeoutInMinutes` 있도록를 사용할 수 있습니다. AWS IoT 분석 는 한 번에 하나의 알림 배치를 CloudWatch Events로 보냅니다.
유형: 정수
유효 범위: 1\$160
**`ruleName`**
지연 데이터 규칙의 이름입니다.
유형: 문자열
**중요**
`lateDataRules`를 지정하려면 데이터 세트에 `DeltaTime` 필터를 사용해야 합니다.
## 지연 데이터 규칙 구성(콘솔)
다음 절차는 AWS IoT 분석 콘솔에서 데이터 세트의 지연 데이터 규칙을 구성하는 방법을 보여줍니다.
**최신 데이터 규칙을 구성하려면**
1. [AWS IoT 분석 콘솔](https://console.aws.amazon.com/iotanalytics/)에 로그인합니다.
1. 탐색 창에서 **데이터 세트**를 선택합니다.
1. **데이터 세트**에서 대상 데이터 세트를 선택합니다.
1. 탐색 창에서 **세부사항**을 선택합니다.
1. **델타 윈도우** 섹션에서 **편집**을 선택합니다.
1. **데이터 선택 필터 구성**에서 다음을 수행합니다.
1. **데이터 선택 창**에서 **델타 시간**을 선택합니다.
1. **오프셋**에 기간을 입력한 다음 단위를 선택합니다.
1. **타임스탬프 표현식**에는 표현식을 입력합니다. 타임스탬프 필드의 이름이나 *from\$1unixtime(time)*과 같이 시간을 도출할 수 있는 SQL 표현식이 될 수 있습니다.
타임스탬프 표현식을 작성하는 방법에 대한 자세한 내용을 알아보려면 *Presto 0.172 설명서*의 [날짜 및 시간 함수와 연산자](https://prestodb.io/docs/0.172/functions/datetime.html)를 참조하십시오.
1. **지연 데이터 알림**의 경우 **활성**을 선택합니다.
1. **델타 시간**에는 정수를 입력합니다. 값의 범위는 1\$160입니다.
1. **저장**을 선택합니다.
![\[AWS IoT 분석 콘솔에서 데이터 선택 필터를 구성합니다.\]](http://docs.aws.amazon.com/ko_kr/iotanalytics/latest/userguide/images/late-data-notification-1.png)
## 지연 데이터 규칙(CLI) 구성
AWS IoT 분석 API에서 `LateDataRuleConfiguration` 객체는 데이터 세트의 지연 데이터 규칙 설정을 나타냅니다. 이 객체는 `CreateDataset` 및 `UpdateDataset`와 연결된 `Dataset` 객체에 포함되어 있습니다. [API](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/), [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotanalytics/index.html) 또는 [AWS SDK](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html)를 사용하여 데이터 세트에 대한 지연 데이터 규칙을 지정할 수 있습니다. 다음 예제에서는 AWS CLI를 사용합니다.
지정된 지연 데이터 규칙으로 데이터 세트를 생성하려면 다음 명령어를 실행합니다. 명령은 `dataset.json` 파일이 현재 디렉터리에 있다고 가정합니다.
**참고**
[UpdateDataset](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_UpdateDataset.html) API를 사용하여 기존 데이터 세트를 업데이트할 수 있습니다.
```
aws iotanalytics create-dataset --cli-input-json file://dataset.json
```
`dataset.json` 파일에 다음을 포함해야 합니다.
+ *demo\$1dataset*를 대상 데이터 세트 이름으로 바꿉니다.
+ *demo\$1datastore*를 대상 데이터 스토어 이름으로 바꿉니다.
+ *from\$1unixtime(time)*을 타임스탬프 필드의 이름 또는 시간을 도출할 수 있는 SQL 표현식으로 바꿉니다.
타임스탬프 표현식을 작성하는 방법에 대한 자세한 내용을 알아보려면 *Presto 0.172 설명서*의 [날짜 및 시간 함수와 연산자](https://prestodb.io/docs/0.172/functions/datetime.html)를 참조하십시오.
+ *timeout*을 1\$160 사이의 정수로 바꿉니다.
+ *demo\$1rule*을 원하는 이름으로 바꿉니다.
```
{
"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"
}
]
}
```
## 지연 데이터 알림 수신 구독
AWS IoT 분석에서 전송된 지연 데이터 알림을 처리하는 방법을 정의하는 규칙을 CloudWatch Events에서 만들 수 있습니다. CloudWatch Events는 알림을 수신하면 규칙에 정의된 지정된 대상 작업을 간접 호출합니다.
### CloudWatch Events 규칙 생성을 위한 사전 조건
에 대한 CloudWatch Events 규칙을 생성하기 전에 다음을 수행해야 AWS IoT 분석합니다.
+ CloudWatch Events의 이벤트, 규칙 및 대상을 익힙니다.
+ CloudWatch Events 규칙에 의해 간접 호출되는 [대상](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html)을 생성하고 구성해야 합니다. 규칙은 다음과 같은 다양한 유형의 대상을 간접 호출할 수 있습니다.
+ Amazon Kinesis 스트림
+ AWS Lambda 함수
+ Amazon Simple Notification Service(Amazon SNS) 주제
+ Amazon Simple Queue Service(Amazon SQS) 대기열
CloudWatch Events 규칙 및 연결된 대상은 AWS IoT 분석 리소스를 생성한 AWS 리전에 있어야 합니다. 자세한 내용은 *AWS 일반 참조*의 [서비스 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html)을 참조하십시오.
자세한 정보는 *Amazon CloudWatch Events 사용 설명서*의 [Amazon CloudWatch Events란 무엇인가요?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) 및 [Amazon CloudWatch Events 시작하기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html)를 참조하십시오.
### 지연 데이터 알림 이벤트
지연 데이터 알림 이벤트는 다음 형식을 사용합니다.
```
{
"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
}
}
```
### 지연 데이터 알림을 수신할 CloudWatch Events 규칙 생성
다음 절차에서는 Amazon SQS 대기열로 AWS IoT 분석 지연 데이터 알림을 보내는 규칙을 생성하는 방법을 보여줍니다.
**CloudWatch Events 규칙을 생성하려면**
1. [Amazon CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/)에 로그인합니다.
1. 탐색 창의 **이벤트** 아래에서 **규칙**을 선택합니다.
1. **규칙** 페이지에서 **규칙 생성**을 선택합니다.
1. **이벤트 소스** 아래 **이벤트 패턴**을 선택합니다.
1. **서비스별 이벤트와 일치시킬 이벤트 패턴을 작성** 섹션에서 다음을 수행합니다.
1. **서비스 이름**에서 **IoT Analytics**를 선택합니다.
1. **이벤트 유형**에서 **IoT Analytics 데이터 세트 수명 주기 알림**을 선택합니다.
1. **특정 데이터 세트 이름**을 선택한 다음 대상 데이터 세트의 이름을 입력합니다.
1. **대상**에서 **대상 추가**를 선택합니다.
1. **SQS 대기열**을 선택하고 다음을 수행합니다.
1. **대기열\$1**에서 대상 대기열을 선택합니다.
1. **세부 정보 구성**을 선택합니다.
1. **2단계: 규칙 세부 정보 구성** 페이지에 이름 및 설명을 입력합니다.
1. **규칙 생성**을 선택합니다.