创建 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 配置时修改了分区副本数,后端服务会自动创建一个后台任务,任务类型为更改Topic副本数,用于监控此设置的执行情况。您可以在后台任务页签中查看任务详情。详细说明请参考后台任务管理。
- 如果任务状态为已执行,表示任务执行成功,副本数已成功修改。
- 如果任务状态为执行失败,您可以在任务详情中查看错误原因等信息。