本文へスキップ

Apache Kafka クライアント

トピックのメッセージやコンシューマーの遅延を確認し、TablePro 独自のコマンド言語 KafkaQL でテストメッセージを送信できます。

概要

クエリ言語
KafkaQL
ドライバー
初回使用時にダウンロード
接続方法
ホストとポート, SSH トンネル, SSL/TLS
既定のポート
9092
最低バージョン
0.11
Apache Kafka に接続した Mac 上の TablePro。トピックのメッセージが一覧表示されています。

接続

ブートストラップブローカーのホストとポートを入力し、Additional Bootstrap Servers で予備のブローカーを追加します。各接続は一つのクラスターにつながり、サイドバーにトピックを表示します。

Security Protocol は PLAINTEXT、SSL、SASL_PLAINTEXT、SASL_SSL、SASL Mechanism は PLAIN、SCRAM-SHA-256、SCRAM-SHA-512 から選びます。PLAIN は Confluent Cloud、SCRAM は Amazon MSK と自己ホストのブローカー向けです。SSL または SASL_SSL で SSL モードを選ばない場合は、証明書チェーンとホスト名を検証します。プライベート CA は CA Certificate に入れ、クライアント証明書と鍵で相互 TLS を使えます。

SSH トンネル経由では接続がブートストラップブローカーに留まるため、そのブローカーがリーダーのパーティションだけを読みます。Import from URL… は kafka:// URL を受け付けます。macOS はこの URL をリンクとして開きません。

読み取り、確認、送信

最近のメッセージを、パーティション、オフセット、タイムスタンプ、キー、値、ヘッダーとともに参照できます。複数のパーティションのメッセージはタイムスタンプ順に並び、UTF-8 以外の値は 16 進で表示し、トゥームストーンは空のメッセージと区別します。

KafkaQL は最新または最古のメッセージ、オフセット、ISO 8601 のタイムスタンプから読み取り、パーティションに限定することもできます。SHOW はトピック、ブローカー、グループ、クラスター情報を一覧表示し、DESCRIBE TOPIC はトピックを調べます。DESCRIBE GROUP は遅延レポートで、パーティションごとにコミット済みオフセット、末尾オフセット、その差を示します。グループが一度もコミットしていないパーティションは、ゼロから数えた数値ではなく遅延なしと表示します。

PRODUCE INTO は、任意のキー、ヘッダー、パーティションを指定してメッセージを書き込みます。キーがありパーティションを指定しないメッセージは、Kafka 自身の producer と同じ場所に送ります。gzip、snappy、lz4、zstd のバッチは読み取り時に展開します。

メッセージを一件ずつ編集・削除することはできません。新しいメッセージが届いても、ページ送りは前の位置から続きます。

トピック

サイドバーまたは DROP TOPIC によるトピックの削除が、唯一の破壊的な操作です。クラスターは後からログを削除するため、トピックがしばらく一覧に残ることがあります。Kafka は保持期間かパーティションごとのオフセットでレコードを削除し、どちらもトピックを空にしないため、Truncate はありません。

このページでは Apache Kafka 固有の内容を扱います。Safe Mode、AI アシスタント、MCP サーバーなど TablePro のその他の機能は機能ページで紹介しています。

その他

  • データの移動

    インポートはありません。メッセージは PRODUCE INTO でトピックに書き込みます。クエリで読んだメッセージを CSV、JSON、SQL、XLSX、Markdown、HTML と XML でエクスポートできます。

  • 制限

    • Schema Registry を読まないため、Avro と Protobuf の値は生のバイトとして表示します。
    • トピックの作成、トピック設定の編集、コンシューマーグループのオフセットのリセットは非対応です。
    • メッセージ数は概算です。
  • トピックは読み込めるのに、メッセージがタイムアウトするのはなぜですか?

    クラスターが、コンテナのホスト名やプライベート IP など、この Mac から届かないアドレスを通知しています。advertised.listeners を修正するか、Broker Addresses をブートストラップアドレスだけを使う設定にしてください。

  • Amazon MSK の IAM ログインに対応しますか?

    対応しません。SASL 方式は PLAIN、SCRAM-SHA-256、SCRAM-SHA-512 なので、MSK クラスターで SCRAM ユーザーを作成し、SASL_SSL で接続してください。

TablePro を入手

このページの機能はすべて無料です。