終止支援通知：在 2025 年 12 月 15 日， AWS 將終止對 的支援 AWS IoT Analytics。2025 年 12 月 15 日之後，您將無法再存取 AWS IoT Analytics 主控台或 AWS IoT Analytics 資源。如需詳細資訊，請參閱[AWS IoT Analytics 終止支援](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 重新處理頻道訊息
<a name="reprocessing"></a>

AWS IoT Analytics 可讓您重新處理頻道資料。這在下列情況下很有用：
+ 您想要重新播放現有的擷取資料，而不是從頭開始。
+ 您對管道進行更新，並想將現有的資料更新至最新變更。
+ 您想要包含在您變更客戶受管儲存選項、頻道許可或資料存放區之前擷取的資料。

## 參數
<a name="reprocess-parameters"></a>

當您透過管道使用 重新處理頻道訊息時 AWS IoT Analytics，您必須指定下列資訊：

`StartPipelineReprocessing`  
開始透過管道重新處理頻道訊息。    
`ChannelMessages`  
指定您要重新處理的一組或多組頻道訊息。  
如果您使用 `channelMessages` 物件，則不得指定 `startTime`和 的值`endTime`。    
`s3Paths`  
指定一或多個金鑰，以識別儲存頻道訊息的 Amazon Simple Storage Service (Amazon S3) 物件。您必須使用金鑰的完整路徑。  
路徑範例： `00:00:00/1582940490000_1582940520000_123456789012_mychannel_0_2118.0.json.gz`  
類型：字串陣列  
陣列成員限制條件：1-100 個項目。  
長度限制：1-1024 個字元。  
`endTime`  
重新處理之頻道資料的結束時間 （專屬）。  
如果您指定 `endTime` 參數的值，則不得使用 `channelMessages` 物件。  
類型：Timestamp  
`startTime`  
經重新處理的原始訊息資料開始時間 (包含)。  
如果您指定 `startTime` 參數的值，則不得使用 `channelMessages` 物件。  
類型：Timestamp

`pipelineName`  
要開始重新處理的管道名稱。  
類型：字串  
長度限制條件：1-128 個字元。

## 重新處理頻道訊息 （主控台）
<a name="reprocessing-console"></a>

本教學課程說明如何重新處理存放在 AWS IoT Analytics 主控台中指定 Amazon S3 物件中的頻道資料。

開始之前，請確定您要重新處理的頻道訊息儲存在客戶受管的 Amazon S3 儲存貯體中。

1. 登入 [AWS IoT Analytics 主控台](https://console.aws.amazon.com/iotanalytics/)。

1. 在導覽窗格中，選擇**管道**。

1. 選擇您的目標管道。

1. 從**動作**中選擇**重新處理訊息**。

1. 在**管道重新處理**頁面上，選擇**重新處理訊息**的 **S3 物件**。

    AWS IoT Analytics 主控台也提供下列選項：
   + **所有可用範圍** - 重新處理頻道中的所有有效資料。
   + **過去 120 天** - 重新處理過去 120 天內抵達的資料。
   + **過去 90 天** - 重新處理過去 90 天內抵達的資料。
   + **過去 30 天** - 重新處理過去 30 天內抵達的資料。
   + **自訂範圍** - 重新處理抵達指定時間範圍的資料。您可以選擇任何時間範圍。

1. 輸入存放頻道訊息的 Amazon S3 obejct 金鑰。

   若要尋找金鑰，請執行下列動作：

   1. 前往 [Amazon S3 主控台](https://console.aws.amazon.com/s3/)。

   1. 選擇目標 Amazon S3 物件。

   1. 在**屬性**的**物件概觀**區段中，複製金鑰。

1. 選擇**開始重新處理**。

## 重新處理頻道訊息 (API)
<a name="reprocessing-api"></a>

當您使用 `StartPipelineReprocessing` API 時，請注意下列事項：
+ `startTime` 和 `endTime` 參數會指定原始資料擷取的時間，但這些是粗略的預估值。您可以四捨五入到最接近的 1 小時。`startTime` 包含 ，但 `endTime`是唯一的。
+ 命令會以非同步方式啟動重新處理，並立即傳回。
+ 不保證重新處理訊息會依其原本收到的順序來處理。只會大致相同，但不完全一樣。
+ 您每 24 小時最多可以提出 1000 個 `StartPipelineReprocessing` API 請求，以透過管道重新處理相同的頻道訊息。
+ 重新處理您的原始資料會產生額外費用。

如需詳細資訊，請參閱 API 參考中的 [StartPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_StartPipelineReprocessing.html) API。 *AWS IoT Analytics *

## 取消頻道重新處理活動
<a name="cancel-reprocessing"></a>

若要取消管道重新處理活動，請使用 [CancelPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CancelPipelineReprocessing.html) API，或在 AWS IoT Analytics 主控台的活動****頁面上選擇**取消重新處理**。如果您取消重新處理，則不會重新處理剩餘的資料。您必須開始另一個重新處理請求。

使用 [DescribePipeline](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeletePipeline.html) API 檢查重新處理的狀態。請參閱回應中的 `reprocessingSummaries` 欄位。