更新时间:2025-08-21 GMT+08:00

修改Kafka Topic配置

本章节指导您在控制台修改如表1所示Kafka Topic的配置。

修改同步复制、同步落盘、消息时间戳类型、批处理消息最大值和描述,不会重启实例。

表1 Kafka Topic的配置参数

参数名称

说明

分区数

Topic的分区数,修改方法请参见修改Kafka Topic分区数

老化时间

消息的最长保留时间,修改方法请参见修改Kafka消息老化时间

副本数

Topic每个分区的副本数量,修改方法请参见修改Kafka Topic副本数

同步复制

后端收到生产消息请求并复制给所有副本后,才返回客户端。

同步落盘

  • 开启:生产的每条消息都会立即写入磁盘,可靠性更高。
  • 关闭:生产的消息存在内存中,不会立即写入磁盘。

消息时间戳类型

定义消息中的时间戳类型,取值如下:
  • CreateTime:生产者创建消息的时间。
  • LogAppendTime:broker将消息写入日志的时间。

批处理消息最大值

Kafka允许的最大批处理大小,如果启用消息压缩,则表示压缩后的最大批处理大小。

如果增加“批处理消息最大值”的值,且存在消费者版本早于0.10.2,此时消费者的“fetch size”值也必须增加,以便消费者可以获取增加后的批处理大小。

描述

Topic的描述信息。

约束与限制

  • 当副本数为1时,不能开启同步复制功能。
  • 开启同步复制后,需要在客户端配置acks=all或者-1,否则无效。
  • 批量修改Topic配置时,每次最多修改50个Topic的配置。

修改Topic配置

Kafka控制台支持修改单个Topic的配置,也支持批量修改Topic配置。批量修改Topic配置时,无法修改Topic描述信息。

  1. 登录Kafka控制台
  2. 在管理控制台左上角单击,选择Kafka实例所在的区域。
  3. 单击Kafka实例的名称,进入实例详情页面。
  4. 在左侧导航栏选择“实例管理 > Topic管理”,进入Topic列表页面。
  5. 通过以下任意一种方法,修改Topic配置。

    • 勾选Topic名称左侧的方框,可选一个或多个,单击信息栏左上侧的“编辑Topic”。
    • 在待修改配置的Topic所在行,单击“编辑”。

  6. 在“编辑Topic”对话框中,修改Topic的配置,单击“确定”。

    设置成功后,在Topic列表页面,查看修改后的配置。

  1. 登录Kafka控制台
  2. 在管理控制台左上角单击,选择Kafka实例所在的区域。
  3. 单击Kafka实例的名称,进入实例详情页面。
  4. 在左侧导航栏选择“实例管理 > Topic管理”,进入Topic列表页面。
  5. 勾选待修改配置的Topic,单击信息栏左上侧的“批量编辑Topic”,弹出“批量编辑Topic”对话框。
  6. 在“批量操作”区域,勾选如表2所示配置。在“批量数据预览”区域,查看修改前和修改后的配置信息。确认无误后,单击“确定”。

    图1 批量修改Topic配置
    表2 Topic配置参数

    参数名称

    操作说明

    同步复制

    勾选“同步复制”,并开启或关闭同步复制功能。

    同步落盘

    勾选“同步落盘”,并开启或关闭同步落盘功能。

    消息时间戳类型

    勾选“消息时间戳类型”,并在下拉框中选择“CreateTime”/“LogAppendTime”。

    批处理消息最大值(字节)

    勾选“批处理消息最大值(字节)”,并输入批处理消息最大值。

    设置成功后,在Topic列表页面,查看修改后的配置。

相关文档

如果您希望通过API修改Topic的配置,请参考修改Kafka实例Topic