kafka主题管理详解 - kafka-topics.sh

目录

      • 基本语法
      • 常用命令选项
        • [1. 创建主题(create)](#1. 创建主题(create))
          • [注意: 复制因子不能大于可用的 broker 数量](#注意: 复制因子不能大于可用的 broker 数量)
        • [2. 查看所有主题(list)](#2. 查看所有主题(list))
        • [3. 查看主题详情(describe)](#3. 查看主题详情(describe))
        • [4. 修改主题配置(alter)](#4. 修改主题配置(alter))
        • [5. 删除主题(delete)](#5. 删除主题(delete))
        • [6. 其他有用选项](#6. 其他有用选项)
      • 常见配置参数

在 Kafka 的 KRaft 模式(无 ZooKeeper)中, kafka-topics.sh 工具用于管理主题(topics),包括创建、查看、修改和删除等操作。以下是其详细使用方法:

基本语法

bash 复制代码
kafka-topics.sh --bootstrap-server <kafka-broker-host:port> [命令选项]

注意:在 KRaft 模式下,不再使用 --zookeeper 参数,而是通过 --bootstrap-server 连接到 Kafka broker。

常用命令选项

1. 创建主题(create)
bash 复制代码
kafka-topics.sh --bootstrap-server localhost:9092 \
  --create \
  --topic <topic-name> \
  --partitions <num-partitions> \
  --replication-factor <replication-factor> \
  [--config <key=value>]  # 可选的主题配置

示例:

bash 复制代码
# 创建一个名为 "user-tracking" 的主题,3个分区,1个副本
kafka-topics.sh --bootstrap-server localhost:9092 \
  --create \
  --topic user-tracking \
  --partitions 3 \
  --replication-factor 1 \
  --config retention.ms=86400000  # 数据保留1天
注意: 复制因子不能大于可用的 broker 数量

在 Kafka 中,复制因子不能大于可用的 broker 数量,因为每个副本需要存储在不同的 broker 上以保证高可用性。

否则会报错:

Error while executing topic command : Unable to replicate the partition 2 time(s): The target replication factor of 2 cannot be reached because only 1 broker(s) are registered.

2. 查看所有主题(list)
bash 复制代码
kafka-topics.sh --bootstrap-server localhost:9092 --list

执行演示:

3. 查看主题详情(describe)
bash 复制代码
kafka-topics.sh --bootstrap-server localhost:9092 \
  --describe \
  --topic <topic-name>  # 不指定则查看所有主题详情

示例:

4. 修改主题配置(alter)
bash 复制代码
kafka-topics.sh --bootstrap-server localhost:9092 \
  --alter \
  --topic <topic-name> \
  [--partitions <new-num-partitions>]  # 只能增加分区数
  [--config <key=value>]  # 添加或修改配置
  [--delete-config <key>]  # 删除配置
增加分区数

示例:

bash 复制代码
# 增加分区数到5
kafka-topics.sh --bootstrap-server localhost:9092 \
  --alter \
  --topic user-tracking \
  --partitions 5

演示:

5. 删除主题(delete)
bash 复制代码
kafka-topics.sh --bootstrap-server localhost:9092 \
  --delete \
  --topic <topic-name>

注意:删除主题需要 broker 配置 delete.topic.enable=true(默认已开启)。

删除操作是异步的,执行完这条命令不代表主题立即就被删除了。它仅仅是被标记成"已删除"状态而已。Kafka 会在后台默默地开启主题删除操作。

演示:

6. 其他有用选项
  • --if-exists:操作仅在主题存在时执行(如删除、修改)
  • --if-not-exists:操作仅在主题不存在时执行(如创建)

示例:

bash 复制代码
# 仅在主题存在时删除
kafka-topics.sh --bootstrap-server localhost:9092 \
  --delete \
  --topic user-tracking \
  --if-exists

常见配置参数

可以通过 --config 选项设置的常用主题配置:

  • retention.ms:数据保留时间(毫秒)
  • retention.bytes:每个分区保留的数据量上限
  • cleanup.policy:清理策略(deletecompact
  • max.message.bytes:单条消息的最大字节数
相关推荐
Insist7534 小时前
基于OpenEuler部署kafka消息队列
分布式·docker·kafka
在未来等你5 小时前
Elasticsearch面试精讲 Day 20:集群监控与性能评估
大数据·分布式·elasticsearch·搜索引擎·面试
励志成为糕手7 小时前
Kafka选举机制深度解析:分布式系统中的民主与效率
分布式·kafka·linq·controller·isr机制
echoyu.9 小时前
微服务-分布式追踪 / 监控工具大全
分布式·微服务·架构
飞鱼&10 小时前
Kafka-保证消息消费的顺序性及高可用机制
分布式·kafka
shallwe小威11 小时前
SpringBoot集成Kafka
spring boot·后端·kafka
2351611 小时前
【Redis】缓存击穿、缓存穿透、缓存雪崩的解决方案
java·数据库·redis·分布式·后端·缓存·中间件
Lbwnb丶11 小时前
通过kafka-connect 实现debezium数据监听采集
分布式·kafka
syty202011 小时前
kafka vs rocketmq
分布式·kafka·rocketmq
飞鱼&12 小时前
Kafka-消息不丢失
分布式·kafka