文档中心

消息队列 Kafka版

Topic 管理

修改 Topic 配置

修改 Topic 配置

创建 Topic 之后，您可以根据业务流量随时调整分区数量等 Topic 配置信息，及时扩展 Topic 承载业务流量的能力。

前提条件

已创建消息队列 Kafka版实例和 Topic。详细步骤请参考创建实例和创建 Topic。

注意事项

分区数量只能调大，不能调小，修改时请合理规划分区数量。

不支持修改 Topic 名称。

操作步骤

登录消息队列 Kafka版控制台。

在顶部菜单栏中选择实例所在的地域。

在实例列表页面单击指定实例名称。

在页签栏中单击Topic管理。

找到目标 Topic，并在其对应的操作列单击修改配置。

填写相关配置参数，并单击保存。

参数	说明
分区数	此 Topic 的分区数量。分区数量越大，消费的并发度越大。默认值为 12，取值范围为 1～300，且不可超过相应 Kafka 实例的剩余可用分区数。说明在修改 Topic 配置时，该参数只支持增加，不支持减少。 Topic 的分区会在 Kafka 实例内部打散存放，为保证分区在 Kafka 实例内能够均匀的被打散，建议设置Topic 分区数量为相应 Kafka 实例 Broker 数量的整数倍，您可参考查看节点信息，查看 Kafka 实例的 Broker 数量。
副本数	分区的副本个数，表示在对应数量的副本上备份数据，用于保障分区的高可用。当其中一个 Broker 故障时仍可保障数据可用性，副本数越大可靠性越高。副本数支持设置为 1、2 或 3，默认为 3。说明增加副本数会占用实例磁盘容量，请确保容量充足。增加副本时会占用实例带宽资源，建议在业务低峰期操作。减少副本数会降低数据可用性，请谨慎操作。 1 副本 Topic 无法保障数据可靠性且实例升级期间无法进行读写操作，建议选择 2 副本或 3 副本。
最小同步副本数	Topic 最小同步副本个数，即 min.insync.replicas 参数。该值越大，数据可靠性越好，但是可用性将会降低。副本数为 1 时，最小同步副本数只能为 1。副本数为 2 或 3 时，最小同步副本数不能超过副本数减 1。
消息保留时长	磁盘容量充足时，消息在此 Topic 中的最大保留时长，即消息的存储时间。消费者必须在此时间结束前消费消息，否则消息将被删除。删除的消息，无法被消费。单位为小时，取值范围为 0～2160，目前支持的最大存储时长为 90 天。默认为实例级别的消息保留时长，您也可以在此处指定该 Topic 的消息保留时长，仅对该 Topic 生效。
最大消息大小	此 Topic 中单条消息的最大长度。取值范围为 1MB～12MB。默认为实例级别的最大消息大小，您也可以在此处指定该 Topic 的最大消息大小，仅对该 Topic 生效。
消息清理策略	Topic 消息清理策略。 DELETE：默认的消息清理策略。在磁盘容量充足的情况下，保留在最长保留时间范围内的消息；在磁盘容量不足时，将提前删除旧消息，以保证服务可用性。 COMPACT：COMPACT 消息清理策略针对每个消息的 Key 进行整合，对于有相同 Key 的消息，只保留最新的 value 值，旧的记录则会被清除。 DELETE,COMPACT：同时配置 DELETE 和 COMPACT 两种消息清理策略。只要消息满足任一条清理策略时，都将被清除。

在弹出对话框中确认风险提示，并单击确定。

相关操作

如果修改 Topic 配置时修改了分区副本数，后端服务会自动创建一个后台任务，任务类型为更改Topic副本数，用于监控此设置的执行情况。您可以在后台任务页签中查看任务详情。详细说明请参考后台任务管理。

如果任务状态为已执行，表示任务执行成功，副本数已成功修改。

如果任务状态为执行失败，您可以在任务详情中查看错误原因等信息。

最近更新时间：2025.06.27 14:59:10

这个页面对您有帮助吗？

有用

有用

无用

无用