Alterar o período de retenção de dados - Amazon Kinesis Data Streams

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

Alterar o período de retenção de dados

O Amazon Kinesis Data Streams aceita alterações ao período de retenção de registros de dados do stream de dados. Um fluxo de dados do Kinesis é uma sequência ordenada de registros de dados na qual gravar e da qual ler em tempo real. Os registros de dados são, portanto, armazenados em estilhaços no seu stream temporariamente. O período entre o momento de adição de um registro e o momento em que ele deixa de estar acessível é chamado de período de retenção. Um fluxo de dados do Kinesis armazena registros de 24 horas por padrão (o máximo é 8760 horas) (365 dias).

Você pode atualizar o período de retenção por meio do console do Kinesis Data Streams ou usando oIncreaseStreamRetentionPeriodO e aDecreaseStreamRetentionPeriodoperações. Com o console do Kinesis Data Streams, você pode editar em massa o período de retenção de mais de um fluxo de dados ao mesmo tempo. Você pode aumentar o período de retenção até 8760 horas (365 dias) usando oIncreaseStreamRetentionPeriodoperação ou o console do Kinesis Data Streams. Você pode diminuir o período de retenção até um mínimo de 24 horas usando oDecreaseStreamRetentionPeriodoperação ou o console do Kinesis Data Streams. A sintaxe de solicitação das duas operações inclui o nome do stream e o período de retenção em horas. Finalmente, você pode verificar o período de retenção atual de um stream chamando a operação DescribeStream.

Este é um exemplo de alteração do período de retenção que usa a AWS CLI:

aws kinesis increase-stream-retention-period --stream-name retentionPeriodDemo --retention-period-hours 72

O Kinesis Data Streams deixa de tornar os registros inacessíveis novelhoperíodo de retenção vários minutos após aumentar o período de retenção. Por exemplo, alterar o período de retenção de 24 horas para 48 horas significa que os registros adicionados ao streaming 23 horas 55 minutos antes ainda estarão disponíveis depois de 24 horas.

Quase imediatamente, o Kinesis Data Streams torna inacessíveis os registros mais antigos que o novo período de retenção após a diminuição do período de retenção. Portanto, deve-se tomar muito cuidado ao chamar a operação DecreaseStreamRetentionPeriod.

Defina o período de retenção dos dados para garantir que os consumidores possam ler dados antes de expirar, se ocorrerem problemas. Você deve considerar cuidadosamente todas as possibilidades, como um problema com a lógica de processamento de registro ou a inatividade de uma dependência de downstream por um longo período. Ideia do período de retenção como uma rede de segurança para dar mais tempo para os consumidores de dados se recuperarem. As operações da API de período de retenção permitem que você configure isso de forma proativa ou responda a eventos operacionais reativamente.

Encargos adicionais incidem sobre streams com período de retenção definido acima de 24 horas. Para obter mais informações, consulte Definição de preço do Amazon Kinesis Streams.