지원 종료 알림: 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).
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 채널 메시지 재처리
AWS IoT 분석 를 사용하면 채널 데이터를 재처리할 수 있습니다. 이는 다음과 같은 경우에 유용할 수 있습니다.
+ 처음부터 새로 시작하는 대신, 수집한 기존 데이터를 다시 재생하려는 경우
+ 파이프라인을 업데이트하고 기존 데이터에 변경 사항을 적용하여 최신 상태로 만들려는 경우
+ 고객 관리형 스토리지 옵션, 채널 권한 또는 데이터 스토어를 변경하기 전에 수집된 데이터를 포함하고자 합니다.
## 파라미터
를 사용하여 파이프라인을 통해 채널 메시지를 재처리 AWS IoT 분석하는 경우 다음 정보를 지정해야 합니다.
`StartPipelineReprocessing`
파이프라인을 통한 채널 메시지의 재처리를 시작합니다.
`ChannelMessages`
재처리하려는 하나 이상의 채널 메시지 세트를 지정합니다.
`channelMessages` 객체를 사용하는 경우 `startTime` 및 `endTime` 값을 지정해서는 안 됩니다.
`s3Paths`
채널 메시지를 저장하는 Amazon Simple Storage Service(S3) 객체를 식별하는 키를 하나 이상 지정합니다. 키의 전체 경로를 사용해야 합니다.
예시 경로: `00:00:00/1582940490000_1582940520000_123456789012_mychannel_0_2118.0.json.gz`
유형: 문자열 배열
배열 멤버 제약 조건: 1\~100개 항목.
길이 제한: 1\~1,024자
`endTime`
재처리된 채널 데이터의 종료 시간(제외)입니다.
`endTime` 파라미터 값을 지정하는 경우 `channelMessages` 객체를 사용해서는 안 됩니다.
유형: 타임스탬프
`startTime`
재처리된 원시 메시지 데이터의 시작 시간(포함)입니다.
`startTime` 파라미터 값을 지정하는 경우 `channelMessages` 객체를 사용해서는 안 됩니다.
유형: 타임스탬프
`pipelineName`
재처리를 시작할 파이프라인의 이름입니다.
유형: 문자열
길이 제한: 1\~128자.
## 채널 메시지 재처리(콘솔)
이 자습서에서는 AWS IoT 분석 콘솔의 지정된 Amazon S3 객체에 저장된 채널 데이터를 재처리하는 방법을 보여줍니다.
시작하기 전에 재처리하려는 채널 메시지가 고객 관리형 Amazon S3 버킷에 저장되어 있는지 확인합니다.
1. [AWS IoT 분석 콘솔](https://console.aws.amazon.com/iotanalytics/)에 로그인합니다.
1. 탐색 창에서 **파이프라인**을 클릭합니다.
1. 대상 파이프라인을 선택합니다.
1. **작업**에서 **메시지 재처리**를 선택합니다.
1. **파이프라인 재처리** 페이지에서 **메시지 재처리**에 대해 **S3 객체**를 선택합니다.
AWS IoT 분석 콘솔은 다음 옵션도 제공합니다.
+ **사용 가능한 모든 범위** - 채널의 모든 유효한 데이터를 재처리합니다.
+ **지난 120일** - 지난 120일 동안 도착한 데이터를 재처리합니다.
+ **지난 90일** - 지난 90일 동안 도착한 데이터를 재처리합니다.
+ **지난 30일** - 지난 30일 동안 도착한 데이터를 재처리합니다.
+ **사용자 지정 범위** - 지정된 시간 범위에 도착한 데이터를 재처리합니다. 원하는 시간 범위를 선택할 수 있습니다.
1. 채널 메시지를 저장하는 Amazon S3 객체의 키를 입력합니다.
키를 찾으려면 다음을 수행합니다.
1. [Amazon S3 콘솔](https://console.aws.amazon.com/s3/)을 사용합니다.
1. 대상 Amazon S3 객체를 선택합니다.
1. **속성**의 **객체 개요** 섹션에서 키를 복사합니다.
1. **재처리 시작**을 선택합니다.
## 채널 메시지 재처리(API)
`StartPipelineReprocessing` API를 사용할 때 다음 사항에 유의하십시오.
+ `startTime` 및 `endTime` 파라미터는 원시 데이터의 수집 시점을 지정하지만, 이것은 대강의 추정치에 불과합니다. 가장 가까운 시간 단위로 반올림할 수 있습니다. `startTime`은 포함되지만 `endTime`은 제외됩니다.
+ 이 명령은 비동기식으로 재처리를 시작하고 즉시 결과를 반환합니다.
+ 재처리된 메시지가 원래의 수신 순서에 따라 처리된 것이라는 보장은 없습니다. 거의 동일한 순서지만 정확히 같지는 않습니다.
+ 24시간마다 최대 1,000개의 `StartPipelineReprocessing` API 요청을 생성하여 파이프라인을 통해 동일한 채널 메시지를 재처리할 수 있습니다.
+ 원시 데이터를 재처리하는 경우 추가 비용이 발생합니다.
*자세한 내용은AWS IoT Analytics API 참조*의 [StartPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_StartPipelineReprocessing.html) API를 참조하십시오.
## 채널 재처리 활동 취소
파이프라인 재처리 활동을 취소하려면 [CancelPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CancelPipelineReprocessing.html) API를 사용하거나 AWS IoT 분석 콘솔의 **활동** 페이지에서 **재처리 취소**를 선택합니다. 재처리를 취소하면 나머지 데이터는 재처리되지 않습니다. 재처리 요청을 다시 시작해야 합니다.
[DescribePipeline](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeletePipeline.html) API를 사용하여 재처리 상태를 확인합니다. 응답의 `reprocessingSummaries` 필드를 참조하십시오.