跳转到正文

Apache Kafka 客户端

检查主题消息和消费者延迟,或使用 TablePro 自己的命令语言 KafkaQL 发送测试消息。

概览

查询语言
KafkaQL
驱动
首次使用时下载
连接方式
主机和端口, SSH 隧道, SSL/TLS
默认端口
9092
最低版本
0.11
Mac 上的 TablePro 已连接 Apache Kafka,列出一个主题的消息。

连接

输入一个引导代理的主机和端口,并在 额外的 Bootstrap 服务器 (Additional Bootstrap Servers) 中添加备用代理。每个连接访问一个集群,侧边栏显示其主题。

安全协议 (Security Protocol) 可选 PLAINTEXT、SSL、SASL_PLAINTEXT 或 SASL_SSL,SASL 机制 (SASL Mechanism) 可选 PLAIN、SCRAM-SHA-256 或 SCRAM-SHA-512:PLAIN 适合 Confluent Cloud,SCRAM 适合 Amazon MSK 和自托管代理。使用 SSL 或 SASL_SSL 且未选择 SSL 模式时,会验证证书链和主机名。私有 CA 填入 CA 证书 (CA Certificate),客户端证书和密钥提供双向 TLS。

通过 SSH 隧道连接时,连接停留在引导代理上,因此只读取该代理作为 leader 的分区。从 URL 导入… (Import from URL…) 接受 kafka:// URL,macOS 不会将其作为链接打开。

读取、检查和生成

浏览近期消息及其分区、偏移量、时间戳、键、值和标头。来自多个分区的消息按时间戳交错显示,非 UTF-8 值显示为十六进制,墓碑消息与空消息保持区分。

KafkaQL 可从最新或最早的消息、某个偏移量或 ISO 8601 时间戳开始消费,也可限定分区。SHOW 列出主题、代理、组和集群详情,DESCRIBE TOPIC 检查主题。DESCRIBE GROUP 是延迟报告:逐分区显示已提交偏移量、末端偏移量及其差值。组从未提交过的分区显示无延迟,而不是从零算起的数字。

PRODUCE INTO 写入消息,可选键、标头和分区;有键但未指定分区的消息会落在 Kafka 自身生产者会选择的位置。gzip、snappy、lz4 和 zstd 批次会在读取时解压。

消息不能逐条编辑或删除,新消息到达时,分页从上次的位置继续。

主题

从侧边栏或用 DROP TOPIC 删除主题是唯一的破坏性操作。集群随后才移除日志,因此主题可能会在列表中短暂停留。不提供 Truncate:Kafka 按保留策略或按各分区的偏移量移除记录,两者都不会清空主题。

本页介绍 Apache Kafka 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。

其他

  • 移动数据

    不提供导入:请用 PRODUCE INTO 向主题写入消息。将查询读取的消息导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。

  • 限制

    • 不读取 Schema Registry,因此 Avro 和 Protobuf 值显示为原始字节。
    • 不支持创建主题、编辑主题配置或重置消费者组偏移量。
    • 消息数量为近似值。
  • 为什么主题能加载,但消息会超时?

    集群公布了此 Mac 无法访问的地址,例如容器主机名或私有 IP。请修正 advertised.listeners,或设置 Broker 地址 (Broker Addresses) 以仅使用引导地址。

  • 支持 Amazon MSK IAM 登录吗?

    不支持。SASL 机制为 PLAIN、SCRAM-SHA-256 和 SCRAM-SHA-512,因此请在 MSK 集群上创建 SCRAM 用户,并以 SASL_SSL 连接。

获取 TablePro

本页功能全部免费。