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:单条消息的最大字节数
相关推荐
楠枬27 分钟前
zookeeper 实现分布式锁
分布式·zookeeper
milanyangbo3 小时前
“卧槽,系统又崩了!”——别慌,这也许是你看过最通俗易懂的分布式入门
分布式·后端·云原生·架构
失散133 小时前
分布式专题——1.1 Redis单机、主从、哨兵、集群部署
java·数据库·redis·分布式·架构
你我约定有三6 小时前
软件启动时加配置文件 vs 不加配置文件
java·分布式·zookeeper
励志成为糕手8 小时前
ZooKeeper架构深度解析:分布式协调服务的核心设计与实现
大数据·分布式·zookeeper·架构·一致性
瑞瑞绮绮10 小时前
分布式事务的Java实践
java·分布式·springcloud
孤独的复仇者10 小时前
RabbitMQ高级:延迟消息
分布式·rabbitmq
AMiner:AI科研助手12 小时前
警惕!你和ChatGPT的对话,可能正在制造分布式妄想
人工智能·分布式·算法·chatgpt·deepseek
码luffyliu15 小时前
消息队列 :Kafka 核心要点总结
分布式·kafka·消息队列·mq
运维老司机20 小时前
Kafka 开启 SASL_PLAINTEXT 双监听器认证(内网/外网)
分布式·kafka·linq