如何通过CLI为指定Kafka主题覆盖log.retention.check.interval.ms配置

log.retention.check.interval.ms 属于 Broker 全局维度配置，不支持针对单个Kafka主题做单独覆盖，不存在对应的CLI操作可以实现单主题修改该参数的需求。

原因说明 #

该参数控制的是Broker端日志清理线程的调度间隔，是进程级的运行参数：

• 日志清理线程是Broker启动时初始化的全局线程池，不会为单个主题启动独立的检查调度任务
• 所有主题的日志过期判定，都复用这套全局调度的检查周期，本身就没有设计单主题的配置入口
• 执行topic级配置查询命令时，你也不会在支持动态修改的topic配置列表中找到这个参数，所有可单主题覆盖的参数都会出现在这个列表里。

可单主题覆盖的相关保留配置 #

如果你实际需求是调整单个主题的日志保留规则，以下参数是支持通过CLI为指定主题单独设置的：

• retention.ms：单主题日志的最长保留时长
• retention.bytes：单主题单个分区的最大日志存储容量
• segment.ms：单主题日志段滚动生成的时间间隔
• segment.bytes：单主题单个日志段的最大文件大小

单主题配置操作示例 #

给指定主题添加/修改配置的命令格式：

kafka-configs.sh --bootstrap-server <Broker连接地址> \
--entity-type topics \
--entity-name <目标主题名> \
--alter --add-config retention.ms=86400000

校验配置是否生效的命令：

kafka-configs.sh --bootstrap-server <Broker连接地址> \
--entity-type topics \
--entity-name <目标主题名> \
--describe

如果确实需要调整log.retention.check.interval.ms的取值，只能修改Broker端server.properties文件中的对应参数值，重启Broker后生效，修改后对该Broker上存储的所有主题生效，无法只作用于单个主题。

内容的提问来源于stack exchange，提问作者i474