首页/数据/数据工程与 ETL 速查/kafka-topics.sh 创建主题
本包目录(311 条)
管道基础52 条
Kafka64 条
调度与编排40 条数仓建模52 条数据质量50 条CDC 与同步53 条

kafka-topics.sh 创建主题

创建主题时显式指定分区数、副本因子与关键配置(保留、最小同步副本),避免依赖集群默认值在环境间产生差异。

工具bin/kafka-topics.sh(部分发行版为 kafka-topics)
必填--bootstrap-server、--create、--topic
常用--partitions、--replication-factor、--config、--if-not-exists

创建主题

创建主题
kafka-topics.sh --bootstrap-server broker1:9092 \
  --create --topic orders \
  --partitions 6 --replication-factor 3 \
  --config retention.ms=604800000 \
  --config min.insync.replicas=2

kafka-topics.sh --bootstrap-server broker1:9092 \
  --create --topic orders --if-not-exists \
  --partitions 6 --replication-factor 3
副本因子不能超过 Broker 数量,超过会直接报错;跨机房集群要确认机架感知配置。

易错点

  • 依赖集群默认分区数(常为 1)会创建出单分区主题,后续只能增不能减
  • 用 --if-not-exists 时不会校验已有主题配置,自动化脚本要另行核对

数据来源与参考

  • Apache Kafka 官方文档:Topic Configs 与 kafka-topics.sh
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌