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

O Amazon Kinesis Data Streams oferece suporte a alterações do período de retenção do registro de dados no fluxo de dados. Um fluxo de dados do Kinesis é uma sequência ordenada de registros de dados projetada para gravação e leitura em tempo real. Os registros de dados são, portanto, armazenados em fragmentos no fluxo 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. Por padrão, um fluxo de dados do Kinesis armazena registros de 24 horas até 8.760 horas (365 dias).

É possível atualizar o período de retenção no console do Kinesis Data Streams ou usando as operações IncreaseStreamRetentionPeriod e DecreaseStreamRetentionPeriod. No console do Kinesis Data Streams, pode-se editar em massa o período de retenção de mais de um fluxo de dados ao mesmo tempo. É possível aumentar o período de retenção até o máximo de 8.760 horas (365 dias) usando a operação IncreaseStreamRetentionPeriod ou o console do Kinesis Data Streams. É possível diminuir o período de retenção até um mínimo de 24 horas usando a operação DecreaseStreamRetentionPeriod ou o console do Kinesis Data Streams. A sintaxe de solicitação das duas operações inclui o nome do fluxo e o período de retenção em horas. Por fim, é possível verificar o período de retenção atual de um fluxo 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 para de tornar inacessíveis os registros no período de retenção antigo vários minutos após o aumento do período. Por exemplo, alterar o período de retenção de 24 horas para 48 horas significa que os registros adicionados ao fluxo 23 horas 55 minutos antes ainda estarão disponíveis depois de 24 horas.

O Kinesis Data Streams torna inacessíveis os registros mais antigos que o novo período de retenção quase imediatamente após a diminuição do período. 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. Deve-se 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 isso seja configurado 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 Data Kinesis Streams.