# sql-tap - 터미널 UI 기반 실시간 SQL 트래픽 뷰어

> Clean Markdown view of GeekNews topic #26884. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=26884](https://news.hada.io/topic?id=26884)
- GeekNews Markdown: [https://news.hada.io/topic/26884.md](https://news.hada.io/topic/26884.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-02-22T09:31:02+09:00
- Updated: 2026-02-22T09:31:02+09:00
- Original source: [github.com/mickamy](https://github.com/mickamy/sql-tap)
- Points: 9
- Comments: 0

## Summary

터미널에서 **PostgreSQL·MySQL·TiDB**의 쿼리 흐름을 실시간으로 시각화하는 도구 **sql-tap**은 애플리케이션과 DB 사이에 위치한 프록시가 모든 SQL 요청을 가로채 gRPC 스트림으로 전달합니다. 코드 수정 없이 트래픽을 관찰할 수 있는 비침투형 구조로, 쿼리 실행·트랜잭션·오류를 한눈에 파악하고 `EXPLAIN ANALYZE` 분석까지 바로 수행할 수 있습니다.

## Topic Body

- **PostgreSQL**, **MySQL**, **TiDB** 등 주요 데이터베이스의 쿼리 흐름을 **실시간으로 모니터링** 및 시각화   
- **애플리케이션과 DB 사이 프록시(sql-tapd)** 가 모든 SQL 요청을 가로채고, 이를 **gRPC 스트림**으로 **TUI 클라이언트(sql-tap)** 에 전달  
  - **코드 수정 없이** 데이터베이스 트래픽을 관찰할 수 있는 **비침투형 설계**  
  - **sql-tapd**는 데이터베이스의 **wire protocol**을 직접 파싱하여 쿼리를 추적하고,  
    **Prepared statement**, **파라미터 바인딩**, **트랜잭션 흐름**까지 세밀하게 기록  
  - **sql-tap** 클라이언트는 gRPC를 통해 프록시와 연결되어 **실시간 스트림 형태로 쿼리 표시**  
- 쿼리 목록, 트랜잭션, 실행 시간, 오류, 영향받은 행 수 등을 **직관적으로 표시하는 인터랙티브 UI**  
- **EXPLAIN / EXPLAIN ANALYZE** 기능을 통해 쿼리 실행 계획을 즉시 분석 가능  
- **키보드 단축키**: `j/k`로 이동, `/`로 검색, `x/X`로 실행 계획 확인, `a`로 분석 뷰 전환 등  
- **Analytics 뷰**에서 쿼리별 총 실행 횟수, 평균 시간 등 **성능 통계 시각화**  
- Go로 작성 됨. MIT 라이선스

## Comments



_No public comments on this page._