

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à.

# Rielaborazione dei messaggi del canale
<a name="reprocessing"></a>

AWS IoT Analytics consente di rielaborare i dati del canale. Ciò può essere utile nei seguenti casi:
+ Vuoi riprodurre dati esistenti inseriti anziché ricominciare da zero.
+ Effettuate un aggiornamento a una pipeline e desiderate aggiungere i dati esistenti up-to-date con le modifiche.
+ Desideri includere i dati che sono stati acquisiti prima di apportare modifiche alle opzioni di archiviazione gestite dal cliente, alle autorizzazioni per i canali o all'archivio dati.

## Parametri
<a name="reprocess-parameters"></a>

Quando rielaborate i messaggi del canale attraverso la pipeline con AWS IoT Analytics, dovete specificare le seguenti informazioni:

`StartPipelineReprocessing`  
Inizia a rielaborare i messaggi del canale attraverso la pipeline.    
`ChannelMessages`  
Specificate uno o più set di messaggi di canale che desiderate rielaborare.  
Se si utilizza l'`channelMessages`oggetto, non è necessario specificare un valore per `startTime` e. `endTime`    
`s3Paths`  
Speciifica una o più chiavi che identificano gli oggetti Amazon Simple Storage Service (Amazon S3) che salvano i messaggi del tuo canale. È necessario utilizzare il percorso completo della chiave.  
Percorso di esempio: `00:00:00/1582940490000_1582940520000_123456789012_mychannel_0_2118.0.json.gz`  
Tipo: matrice di stringhe  
Vincoli relativi ai membri dell'array: 1-100 elementi.  
Vincoli di lunghezza: 1-1024 caratteri.  
`endTime`  
L'ora di fine (esclusiva) dei dati del canale che vengono rielaborati.  
Se si specifica un valore per il `endTime` parametro, non è necessario utilizzare l'`channelMessages`oggetto.  
Tipo: Timestamp  
`startTime`  
L'ora di inizio (inclusa) della rielaborazione dei dati dei messaggi non elaborati.  
Se si specifica un valore per il `startTime` parametro, non è necessario utilizzare l'`channelMessages`oggetto.  
Tipo: Timestamp

`pipelineName`  
Il nome della pipeline su cui avviare la rielaborazione.  
Tipo: stringa  
Vincoli di lunghezza: 1-128 caratteri.

## Rielaborazione dei messaggi del canale (console)
<a name="reprocessing-console"></a>

Questo tutorial mostra come rielaborare i dati del canale archiviati nell'oggetto Amazon S3 specificato nella AWS IoT Analytics console.

Prima di iniziare, assicurati che i messaggi del canale che desideri rielaborare siano salvati in un bucket Amazon S3 gestito dal cliente.

1. Accedere alla [console AWS IoT Analytics](https://console.aws.amazon.com/iotanalytics/).

1. **Nel pannello di navigazione, scegli Pipelines.**

1. Scegli la pipeline di destinazione.

1. **Scegli **Rielabora i messaggi** da Azioni.**

1. **Nella pagina **Rielaborazione della pipeline**, scegli **Oggetti S3** per Rielabora i messaggi.**

   La AWS IoT Analytics console offre anche le seguenti opzioni:
   + **Tutto l'intervallo disponibile**: rielabora tutti i dati validi nel canale.
   + **Ultimi 120 giorni**: rielabora i dati arrivati negli ultimi 120 giorni.
   + **Ultimi 90 giorni**: rielabora i dati arrivati negli ultimi 90 giorni.
   + **Ultimi 30 giorni**: rielabora i dati arrivati negli ultimi 30 giorni.
   + **Intervallo personalizzato**: rielabora i dati arrivati nell'intervallo di tempo specificato. Puoi scegliere qualsiasi intervallo di tempo.

1. Inserisci la chiave dell'oggetto Amazon S3 che memorizza i messaggi del tuo canale.

   Per trovare la chiave, procedi come segue: 

   1. Vai alla console [Amazon S3](https://console.aws.amazon.com/s3/).

   1. Scegli l'oggetto Amazon S3 di destinazione.

   1. In **Proprietà**, nella sezione **Panoramica dell'oggetto**, copia la chiave.

1. Scegliete **Avvia rielaborazione**.

## Rielaborazione dei messaggi del canale (API)
<a name="reprocessing-api"></a>

Quando utilizzi l'`StartPipelineReprocessing`API, tieni presente quanto segue:
+ I `endTime` parametri `startTime` and specificano quando i dati grezzi sono stati inseriti, ma si tratta di stime approssimative. Puoi arrotondare all'ora più vicina. `startTime`È inclusivo, ma `endTime` è esclusivo.
+ Il comando avvia la rielaborazione in modo asincrono e restituisce immediatamente i risultati.
+ Non vi è alcuna garanzia che i messaggi rielaborati vengano elaborati nell'ordine in cui sono stati ricevuti inizialmente: orientativamente è lo stesso ordine, ma non in modo preciso.
+ Puoi effettuare fino a 1000 richieste `StartPipelineReprocessing` API ogni 24 ore per rielaborare i messaggi dello stesso canale attraverso una pipeline.
+ La rielaborazione dei dati grezzi comporta costi aggiuntivi.

Per ulteriori informazioni, consulta l'[StartPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_StartPipelineReprocessing.html)API, in *AWS IoT Analytics API* Reference.

## Annullamento delle attività di rielaborazione dei canali
<a name="cancel-reprocessing"></a>

**Per annullare un'attività di rielaborazione della pipeline, utilizza l'[CancelPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CancelPipelineReprocessing.html)API o scegli **Annulla rielaborazione** nella pagina Attività della console.** AWS IoT Analytics Se annulli la rielaborazione, i dati rimanenti non verranno rielaborati. È necessario avviare un'altra richiesta di rielaborazione.

Utilizza l'[DescribePipeline](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeletePipeline.html)API per verificare lo stato della rielaborazione. Vedi il `reprocessingSummaries` campo nella risposta.