DuckDB + YouPlotでCUIのグラフ表示
2024-12-20
DuckDBの公式ドキュメントにCUIでの可視化ツールの紹介が載っていた
CLI Charting with YouPlot – DuckDB
YouPlot
red-data-tools/YouPlot: A command line tool that draw plots on the terminal.
Ruby製らしい
内部的にUnicodePlotを使っているらしい、どちらもPlotライブラリなので役割がどう違うのかイメージが付いていない…
サンプルでは次の流れでCUIのグラフ化を行っている
- APIを叩いてデータを取得
- DuckDBに流して集計
- 結果をCSVフォーマットにしてstdoutへ出力
- youplotで可視化
こういうの好きなんだよなー、とりあえず試してみる
install
gem install youplot試す
GitHubのイベントデータのサンプルを実行してみた
これは!!
curl -sL "https://api.github.com/users/swfz/events?per_page=100" \
| duckdb -s "COPY (SELECT type, count(*) AS event_count FROM read_json_auto('/dev/stdin') GROUP BY 1 ORDER BY 2 DESC LIMIT 10) TO '/dev/stdout' WITH (FORMAT 'csv', HEADER)" \
| uplot bar -d, -H -t "GitHub Events for @swfz"
GitHub Events for @swfz
┌ ┐
PullRequestEvent ┤■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ 34.0
PushEvent ┤■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ 32.0
DeleteEvent ┤■■■■■■■■■■■■■■■■■■ 18.0
CreateEvent ┤■■■■■■■■■■■■■■■■ 16.0
CSV出力
途中出力のCSV形式はこんな感じ
$ curl -sL "https://api.github.com/users/swfz/events?per_page=100" | duckdb -s "COPY (SELECT type, count(*) AS event_count FROM read_json_auto('/dev/stdin') GROUP BY 1 ORDER BY 2 DESC LIMIT 10) TO '/dev/stdout' WITH (FORMAT 'csv', HEADER)"
type,event_count
PullRequestEvent,34
PushEvent,32
DeleteEvent,18
CreateEvent,16まぁわかりやすい
YouPlotのチャート種別によっても必要な形式は異なる
GitHubのREADMEに各種チャートのサンプルコマンドが載っているがやはりローカルでワンショットの可視化とかの使い方がよさそう
使い方習熟したらログ調査とかは捗りそう
たまに見たいパターンの場合でも、わざわざデータをBQに入れてLookerStudioで可視化して…とまでやるには重いよな…って場合、簡易的なツールとして使えそう
ただ、timeseriesデータは扱えないみたい…これが一番欲しい感ある…
Feature suggestion: Support for timeseries data · Issue #52 · red-data-tools/YouPlot
Rubyなら自分でコード書いてPR出せるかな?
余裕ができたらやってみたいと思う
