分布式消息服务KAFKA版-约束与限制:Topic

时间:2025-06-20 17:27:36

Topic

表2 Topic约束与限制

限制项

约束与限制

Topic总分区数

Topic总分区数和实例规格有关,具体请参考Kafka集群实例

Kafka以分区为粒度管理消息,分区多导致生产、存储、消费都碎片化,影响性能稳定性。在使用过程中,当Topic的总分区数达到上限后,用户无法继续创建Topic。

单个Topic分区数

  • 按照开源Kafka现有逻辑,单个Topic分区数只支持增加,不支持减少。
  • 出于性能考虑,建议单个Topic的分区数设置为200以内。

Topic数量

Topic数量和Topic总分区数、每个Topic的分区数有关,具体请参考Kafka集群实例

是否支持自动创建Topic

支持。开启自动创建Topic表示生产或消费一个未创建的Topic时,系统会自动创建此Topic,此Topic的默认参数值如下:

  • 单机实例分区数为1,集群实例分区数为3。
  • 单机实例副本数为1,集群实例副本数为3。
  • 老化时间为72小时。
  • 不开启同步复制和同步落盘。
  • 消息时间戳类型为CreateTime。
  • 批处理消息最大值为10485760字节。

集群实例如果在“配置参数”中修改“log.retention.hours”(老化时间)、“default.replication.factor”(副本数)或“num.partitions”(分区数)的参数值,此后自动创建的Topic参数值为修改后的参数值。单机实例不支持修改配置参数。

例如:“num.partitions”修改为“5”,自动创建的Topic参数值如下:

  • 分区数为5。
  • 副本数为3。
  • 老化时间为72小时。
  • 不开启同步复制和同步落盘。
  • 消息时间戳类型为CreateTime。
  • 批处理消息最大值为10485760字节。

同步复制

Topic副本数为1时,不能选择同步复制功能。

副本数

集群实例不建议使用单副本。实例节点出现故障的情况下,单副本Topic查询消息时可能会报“内部服务错误”,因此不建议使用单副本Topic。

老化时间

如果Topic已经设置了老化时间,此时“配置参数”中的log.retention.hours值将不对此Topic生效。仅在Topic中未设置老化时间时,“配置参数”中的log.retention.hours值才会对此Topic生效。

例如:Topic01设置的老化时间为60小时,“配置参数”中的log.retention.hours值为72小时,此时Topic01实际的老化时间为60小时。

批量导入/导出Topic

支持批量导出,不支持批量导入。

Topic名称

Topic名称开头包含特殊字符,例如#号“#”,会导致监控数据无法展示。

是否支持延迟队列

不支持

代理故障场景

实例中部分代理故障时,无法创建、修改和删除Topic,只能查询Topic。

support.huaweicloud.com/productdesc-kafka/kafka-pd-190605003.html