【Kafka基础】topic命令行工具kafka-topics.sh：基础操作命令解析

Kafka作为分布式流处理平台的核心组件，其主题管理是每个开发者必须掌握的关键技能。本文将详细解析kafka-topics.sh工具的使用技巧，从基础操作操作开始，助您轻松驾驭Kafka主题管理。

1 创建主题

/export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --create \
    --bootstrap-server 192.168.10.33:9092 \
    --topic testtopic \
    --partitions 3 \
    --replication-factor 2

参数说明：

• --create：创建新主题
• --bootstrap-server：指定Kafka服务器地址（格式为host:port）
• --topic：要创建的主题名称
• --partitions：主题的分区数量（决定并行度）

• --replication-factor：副本因子（决定数据冗余度）

  示例

  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --create \

  --bootstrap-server 192.168.10.33:9092 \
  --topic testtopic \
  --partitions 3 \
  --replication-factor 2

  Created topic testtopic.
  [root@node6 bin]#

2 列出所有主题

/export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --list \
    --bootstrap-server 192.168.10.33:9092

参数说明：

• --list：列出集群中所有可用主题

  示例

  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --list \

  --bootstrap-server 192.168.10.33:9092

  __consumer_offsets
  test_topic
  testtopic
  [root@node6 bin]#

3 查看主题详情

/export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --describe \
    --bootstrap-server 192.168.10.33:9092 \
    --topic testtopic

参数说明：

• --describe：显示主题的详细信息

• --topic：指定要查看的主题

  示例

  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --describe \

  --bootstrap-server 192.168.10.33:9092 \
  --topic testtopic

  Topic: testtopic PartitionCount: 3 ReplicationFactor: 2 Configs: compression.type=producer,min.insync.replicas=2,segment.jitter.ms=30000,cleanup.policy=delete,segment.bytes=1073741824,max.message.bytes=10485760,unclean.leader.election.enable=false
  Topic: testtopic Partition: 0 Leader: 1 Replicas: 1,2 Isr: 1,2
  Topic: testtopic Partition: 1 Leader: 2 Replicas: 2,3 Isr: 2,3
  Topic: testtopic Partition: 2 Leader: 3 Replicas: 3,1 Isr: 3,1
  [root@node6 bin]#

4 增加分区数

/export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --alter \
    --bootstrap-server 192.168.10.33:9092 \
    --topic testtopic \
    --partitions 4

参数说明：

• --alter：修改主题配置

• --partitions：新的分区数（注意：只能增加不能减少）

  示例

  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --alter \

  --bootstrap-server 192.168.10.33:9092 \
  --topic testtopic \
  --partitions 4

  [root@node6 bin]#
  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --describe --bootstrap-server 192.168.10.33:9092 --topic testtopic
  Topic: testtopic PartitionCount: 4 ReplicationFactor: 2 Configs: compression.type=producer,min.insync.replicas=2,segment.jitter.ms=30000,cleanup.policy=delete,segment.bytes=1073741824,max.message.bytes=10485760,unclean.leader.election.enable=false
  Topic: testtopic Partition: 0 Leader: 1 Replicas: 1,2 Isr: 1,2
  Topic: testtopic Partition: 1 Leader: 2 Replicas: 2,3 Isr: 2,3
  Topic: testtopic Partition: 2 Leader: 3 Replicas: 3,1 Isr: 3,1
  Topic: testtopic Partition: 3 Leader: 1 Replicas: 1,3 Isr: 1,3
  [root@node6 bin]#

5 删除主题

/export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --delete \
    --bootstrap-server 192.168.10.33:9092 \
    --topic testtopic

参数说明：

• --delete：删除指定主题（需确保 delete.topic.enable=true）

  示例

  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --delete \

  --bootstrap-server 192.168.10.33:9092 \
  --topic testtopic

  [root@node6 bin]# /export/home/kafka_zk/kafka_2.13-2.7.1/bin/kafka-topics.sh --list \

  --bootstrap-server 192.168.10.33:9092

  __consumer_offsets
  test_topic
  [root@node6 bin]#