You need to enable JavaScript to run this app.
导航
修改 Topic 配置
最近更新时间:2024.11.08 15:14:41首次发布时间:2022.01.12 14:13:31

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

前提条件

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

注意事项

  • 分区数量只能调大,不能调小,修改时请合理规划分区数量。
  • 不支持修改 Topic 名称。

操作步骤

  1. 登录消息队列 Kafka版控制台

  2. 在顶部菜单栏中选择地域,并在左侧导航栏中单击实例列表

  3. 找到目标实例,单击实例名称。

  4. 在页签栏中单击Topic管理

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

  6. 填写相关配置参数。

    参数

    说明

    分区数

    此 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 生效。

  7. 在弹出对话框中确认风险提示,并单击确定

相关操作

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

  • 如果任务状态为已执行,表示任务执行成功,副本数已成功修改。
  • 如果任务状态为执行失败,您可以在任务详情中查看错误原因等信息。