まだN+1を手で探してるの?「sql-tap」が自動で見つけてくれる
- 公開
- 正式公開 2026-02-14
- 作り手
- mickamy(個人)
- 対応
- CLI(TUI、Go)・Web(ブラウザの画面)・Docker
- 価格
- 無料(MIT ライセンス)
- 評価
- GitHub のスター 1,593(2026-10-12)
どんなアプリか
sql-tap は、アプリケーションとデータベース(PostgreSQL、MySQL、TiDB)の間に入り、すべてのクエリを捕まえて対話型のターミナル画面に表示するツールです。クエリの中身やトランザクションを確かめたり、EXPLAIN を実行したりでき、アプリのコードを変える必要はありません。
Real-time SQL traffic viewer — proxy daemon + TUI / Web client.
mickamy さん、sql-tap の README(GitHub)
使い方は、プロキシのデーモン sql-tapd を起動し、アプリの接続先を DB のポートからプロキシのポートに切り替え、TUI を立ち上げる3段階です。sql-tapd は DB のワイヤープロトコルを解釈し、プリペアドステートメント、パラメータの値、トランザクション、実行時間、影響した行数、エラーを記録します。
起動時に –http=:8080 を付けると、ブラウザで見る画面も使えます。README によると、ブラウザの画面ではクエリのリアルタイム表示、EXPLAIN / EXPLAIN ANALYZE、文字での絞り込み、N+1 の検出、ガントチャート風のタイムライン表示などに対応しています。
同じ SELECT の形が短い時間に何度も実行される N+1 のパターンを自動で見つけ、初期設定で有効になっています。sql-tap -ci で動かすと、テストの実行中に N+1 や遅いクエリを集め、問題があれば終了コード 1 で終わるため、CI に組み込めます。
料金とデータの置き場所
GitHub で公開されているオープンソースで、ライセンスは MIT です。Homebrew、go install、Nix、Docker などで導入できます。
同じ分野のアプリ
| 名前 | 型 | 仕掛け | 対応 | 料金 |
|---|---|---|---|---|
| sql-tap | SQL の流れを見るプロキシ | アプリと DB の間に入り、流れる SQL をターミナルやブラウザでリアルタイムに表示 | CLI(TUI、Go)・Web | 無料(OSS, MIT) |
| sabiql | DB クライアント | 追加ドライバ不要、psql さえあれば使える PostgreSQL 用 TUI クライアント | CLI / TUI(Rust) | 無料(OSS) |
| sqluv | DB クライアント | RDBMS と CSV/TSV/LTSV をターミナルの画面から SQL で扱える | CLI(Go) | 無料(OSS, MIT) |
| DDV(Terminal DynamoDB Viewer) | DB ビューア | DynamoDB のテーブルとデータをターミナル上で閲覧 | CLI(Rust) | 無料(OSS, MIT) |
入れる前に
EXPLAIN を使うには、環境変数 DATABASE_URL(または -dsn-env で指定した変数)に接続先を設定しておく必要があります。設定しなくてもクエリの記録はできますが、EXPLAIN は使えません。
N+1 の検出が見るのは SELECT のクエリで、INSERT・UPDATE・DELETE やトランザクションの開始・確定などの命令は対象外です。
既知の制限として、検索や絞り込みの入力欄では [A、[B、[C、[D、[F、[H という2文字の並びを入力できません。矢印キーの入力が分割されて文字として入ってしまう問題を避けるための処置だと README に書かれています。