Message retention period for Kafka instances - ApsaraMQ for Kafka: Central de Documentação do Alibaba Cloud

O ApsaraMQ for Kafka retém mensagens por um período configurável. Após o término desse período, o sistema exclui as mensagens automaticamente. Defina o período de retenção no nível da instância, no nível do tópico ou em ambos.

Níveis de configuração

A retenção de mensagens permite dois níveis de configuração:

Nível da instância (log.retention.hours): defina o período de retenção padrão para todos os tópicos da instância.
Nível do tópico (retention.ms): aplica-se a um tópico específico e substitui a configuração no nível do broker.

Se nenhuma retenção for definida no nível do tópico, ele herdará o valor do nível da instância.

Suporte à retenção por tipo de instância

As instâncias do Kafka estão disponíveis em duas versões principais: V2 (provisionada) e V3 (Serverless). As configurações de retenção compatíveis dependem da edição da instância e da classe de armazenamento do tópico.

Versão da instância	Edição	Retenção no nível da instância	Retenção no nível do tópico	Observações
V3 (Serverless)	--	Compatível	Compatível	Ambos os níveis são compatíveis independentemente do tipo de armazenamento
V2 (provisionada)	Standard Edition	Compatível	Não compatível	Apenas nível da instância
V2 (provisionada)	Professional Edition	Compatível	Compatível	Retenção no nível do tópico apenas para tópicos com armazenamento local

Parâmetros de configuração

Parâmetro	Escopo	Unidade	Descrição
`log.retention.hours`	Instância	Horas	Período de retenção padrão de mensagens para todos os tópicos na instância
`retention.ms`	Tópico	Milissegundos	Período de retenção para um tópico específico. Substitui `log.retention.hours`

Comportamento específico por edição

A V2 Standard Edition é compatível apenas com retenção no nível da instância.
A V2 Professional Edition aceita retenção no nível do tópico somente para tópicos com armazenamento local.
As instâncias V3 aceitam retenção nos níveis da instância e do tópico para todos os tópicos, independentemente do tipo de armazenamento.
Se log.retention.hours e retention.ms estiverem configurados simultaneamente, retention.ms terá precedência para esse tópico.