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á.
# Reprocessamento de mensagens do canal
AWS IoT Analytics permite que você reprocesse os dados do canal. Isso pode ser útil nos seguintes casos:
+ Você quiser reproduzir dados consumidos em vez de iniciar novamente.
+ Você faz uma atualização em um pipeline e quer trazer os dados existentes up-to-date com as alterações.
+ Você deseja incluir dados que foram ingeridos antes de fazer alterações nas opções de armazenamento gerenciado pelo cliente, nas permissões dos canais ou no armazenamento de dados.
## Parâmetros
Ao reprocessar as mensagens do canal por meio do pipeline com AWS IoT Analytics, você deve especificar as seguintes informações:
`StartPipelineReprocessing`
Inicia o reprocessamento de mensagens por meio do pipeline.
`ChannelMessages`
Especifica um ou mais conjuntos de mensagens do canal que você deseja reprocessar.
Se você usar o objeto `channelMessages`, não deverá especificar um valor para `startTime` e `endTime`.
`s3Paths`
Especifica uma ou mais chaves que identificam os objetos do Amazon Simple Storage Service (Amazon S3) que salvam as mensagens do canal. Você deve usar o caminho completo para a chave.
Exemplo de caminho: `00:00:00/1582940490000_1582940520000_123456789012_mychannel_0_2118.0.json.gz`
Tipo: matriz de strings
Restrições de membros da matriz: 1 a 100 itens.
Restrições de comprimento: 1 a 1.024 caracteres.
`endTime`
A hora de término (exclusivo) dos dados do canal que serão reprocessados.
Se você especificar um valor para o parâmetro `endTime`, não deverá usar o objeto `channelMessages`.
Tipo: carimbo de data/hora
`startTime`
A hora de início (inclusive) dos dados brutos da mensagem que serão reprocessados.
Se você especificar um valor para o parâmetro `startTime`, não deverá usar o objeto `channelMessages`.
Tipo: carimbo de data/hora
`pipelineName`
O nome do pipeline em que o reprocessamento será iniciado.
Tipo: string
Restrições de comprimento: 1 a 128 caracteres.
## Reprocessar mensagens do canal (console)
Este tutorial mostra como reprocessar os dados do canal que estão armazenados no objeto Amazon S3 especificado no AWS IoT Analytics console.
Antes de começar, certifique-se de que as mensagens do canal que pretende reprocessar estão salvas em um bucket do Amazon S3 gerenciado pelo cliente.
1. Faça login no [console do AWS IoT Analytics](https://console.aws.amazon.com/iotanalytics/).
1. No painel de navegação, selecione **Pipelines**.
1. Selecione seu pipeline de destino.
1. Escolha **Reprocessar mensagens** em **Ações**.
1. Na página de **reprocessamento do pipeline**, escolha **objetos do S3** para **reprocessar mensagens**.
O AWS IoT Analytics console também oferece as seguintes opções:
+ **Todo o intervalo disponível**: reprocesse todos os dados válidos no canal.
+ **Últimos 120 dias**: reprocesse os dados que chegaram nos últimos 120 dias.
+ **Últimos 90 dias**: reprocesse os dados que chegaram nos últimos 90 dias.
+ **Últimos 30 dias**: reprocesse os dados que chegaram nos últimos 30 dias.
+ **Intervalo personalizado**: reprocesse os dados que chegaram no intervalo de tempo especificado. Você pode escolher qualquer intervalo de tempo.
1. Insira a chave do objeto Amazon S3 que armazena as mensagens do seu canal.
Para encontrar a chave, faça o seguinte:
1. Acesse o [console do Amazon S3](https://console.aws.amazon.com/s3/).
1. Escolha o objeto do Amazon S3 de destino.
1. Em **Propriedades**, na seção **Visão geral do objeto**, copie a chave.
1. Escolha **Iniciar reprocessamento**.
## Reprocessamento de mensagens do canal (API)
Ao usar a API `StartPipelineReprocessing`, observe o seguinte:
+ Os parâmetros `startTime` e `endTime` especificam quando os dados brutos foram consumidos, mas esses são cálculos genéricos. É possível arredondar para a hora mais próxima. O `startTime` é inclusivo, mas `endTime` é exclusivo.
+ O comando inicia o reprocessamento de forma assíncrona e retorna imediatamente.
+ Não há garantia de que as mensagens reprocessadas são processadas na ordem em que foram recebidas originalmente. Elas são aproximadamente as mesmas, mas não exatamente.
+ Você pode fazer até 1.000 solicitações da API `StartPipelineReprocessing` a cada 24 horas para reprocessar as mensagens do mesmo canal por meio de um pipeline.
+ O reprocessamento dos dados brutos incorre em custos adicionais.
Para obter mais informações, consulte a [StartPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_StartPipelineReprocessing.html)API, em *Referência AWS IoT Analytics da API*.
## Cancelamento de atividades de reprocessamento de canais
Para cancelar uma atividade de reprocessamento do pipeline, use a [CancelPipelineReprocessing](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_CancelPipelineReprocessing.html)API ou escolha **Cancelar reprocessamento** na página **Atividades** no AWS IoT Analytics console. Se você cancelar o reprocessamento, os dados restantes não serão reprocessados. Você deve iniciar outra solicitação de reprocessamento.
Use a [DescribePipeline](https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_DeletePipeline.html)API para verificar o status do reprocessamento. Consulte o campo `reprocessingSummaries` na resposta.