Apache Kafka 클라이언트
토픽 메시지와 소비자 지연을 확인하거나, TablePro의 명령 언어 KafkaQL로 테스트 메시지를 생성하세요.
한눈에 보기
- 쿼리 언어
- KafkaQL
- 드라이버
- 처음 사용할 때 다운로드
- 연결 방식
- 호스트 및 포트, SSH 터널, SSL/TLS
- 기본 포트
- 9092
- 최소 버전
- 0.11


연결
부트스트랩 브로커의 호스트와 포트를 입력하고, 추가 부트스트랩 서버 (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 터널을 통하면 연결이 부트스트랩 브로커에만 머물므로 그 브로커가 리더인 파티션만 읽습니다. URL에서 가져오기… (Import from URL…)는 kafka:// URL을 받지만, macOS는 이 URL을 링크로 열지 않습니다.
읽기, 검사 및 생성
최근 메시지를 파티션, 오프셋, 타임스탬프, 키, 값, 헤더와 함께 탐색하세요. 여러 파티션의 메시지는 타임스탬프 순으로 섞여 표시되고, UTF-8이 아닌 값은 16진수로 표시되며, tombstone은 빈 메시지와 구분됩니다.
KafkaQL은 최신 또는 최초 메시지, 특정 오프셋, ISO 8601 타임스탬프부터 소비하며, 파티션을 지정할 수도 있습니다. SHOW는 토픽, 브로커, 그룹, 클러스터 정보를 나열하고, DESCRIBE TOPIC은 토픽을 조회합니다. DESCRIBE GROUP은 파티션별 커밋 오프셋, 끝 오프셋, 그 차이를 보여 주는 지연 보고입니다. 그룹이 커밋한 적 없는 파티션은 0부터 센 숫자 대신 지연 없음으로 표시됩니다.
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 값은 원시 바이트로 표시됩니다.
- 토픽 생성, 토픽 설정 편집 및 컨슈머 그룹 오프셋 초기화는 지원하지 않습니다.
- 메시지 수는 근삿값입니다.
토픽은 열리는데 메시지는 시간 초과되는 이유는 무엇인가요?
클러스터가 컨테이너 호스트 이름이나 사설 IP처럼 이 Mac이 접근할 수 없는 주소를 알립니다.
advertised.listeners를 고치거나, 브로커 주소 (Broker Addresses)를 부트스트랩 주소만 쓰도록 설정하세요.Amazon MSK IAM 로그인이 되나요?
아니요. SASL 메커니즘은 PLAIN, SCRAM-SHA-256, SCRAM-SHA-512이므로 MSK 클러스터에 SCRAM 사용자를 만들고 SASL_SSL로 연결하세요.