kubectlで複雑な条件の検索に困っていませんか。SQLで書ける「kuqu」

kuqu
Kubernetes クラスタ内のリソースを表として扱い、SQL で絞り込み・集計・結合できるコマンドラインツール
GitHub
公開
正式公開 2025-07-04
作り手
ynqa(個人)
対応
CLI
言語
英語
価格
無料(Apache-2.0 ライセンス)
評価
GitHub のスター 44(2026-10-15)

どんなアプリか

kuqu is a tool that allows you to query Kubernetes resources using SQL-like syntax.

ynqa さん、kuqu の GitHub の README

kuqu は、Kubernetes クラスタの中のリソースを表のデータとして扱い、SQL で絞り込み・集計・結合ができるコマンドラインツールです。クエリの実行には Apache DataFusion を使っています。README では、従来の kubectl コマンドでは難しい複雑な条件での検索や集計を、データベースを扱うのと同じ感覚でできるようにする、と説明しています。

README の例では、実行中の Pod の一覧、名前に redis を含む Service の検索、spec.replicas と status.readyReplicas が一致する Deployment の一覧のほか、Pod と Node を JOIN して Pod ごとのノード名とインスタンスタイプを表示する使い方が紹介されています。spec.nodeName のような JSON のフィールドを直接指定でき、カスタムリソース(CRD)にも対応しています。

テーブル名にはリソース名をそのまま書き、‘pods/kube-system’ のように名前空間を付けて指定することもできます。pods・pod・po のような複数形・単数形・短縮名や、deployments.apps のようなグループ付きの名前も使えます。

同じ分野のアプリ

名前型仕掛け対応料金
kuquクエリ(CLI)Kubernetes のリソースを表として SQL で絞り込み・集計・結合CLI無料(Apache-2.0)
mqクエリ(CLI)jq のような書き方で Markdown を絞り込み・抽出・変換CLI(Rust)、Web プレイグラウンド無料(OSS, MIT)
Liam ERDスキーマ可視化スキーマ定義から操作できる ER 図を自動生成Web・CLI(npm)無料(Apache-2.0)
Container GUIコンテナ管理Apple 純正の container コマンドを docker-compose.yml 単位で GUI 管理Mac(macOS 26 + Apple Silicon)無料(OSS)

入れる前に

インストールは Homebrew(brew install ynqa/tap/kuqu)、Cargo(cargo install kuqu)、シェルのインストーラーの3通りが README に載っています。

SQL の書き方は DataFusion に準じますが、DataFusion の SQL の機能をすべて試しているわけではないため、うまく動かないクエリがあり得ると README に書かれています。その場合はより基本的な書き方にするか、GitHub の Issue で報告するよう案内しています。

スキーマは /openapi/v3 を使わず、実際のリソースのデータからクエリのたびに推定します。そのため独自のラベルや注釈にも問い合わせられますが、リソースが多いときや構造が複雑なときは時間がかかることがある、と README に書かれています。

名前空間を書かないときは default の名前空間が対象になります。README の機能一覧では、すべての名前空間をまとめて扱う機能、クエリ結果の書き出し、kubectl プラグインとしての提供、REPL などは未実装の項目になっています。