このプロジェクトについて

dbt Charts(dbt Labs提供、パッケージ名`dbt-charts`、CLI名`dct`)は、YAMLのボード定義を、多様な形式のインタラクティブなダッシュボードやレポートにコンパイルします。SQLは「どのデータを見るか」を定義し、YAMLは「どのように表示するか」を宣言します。これは、場当たり的にコーディングされたダッシュボードの混乱を、明確で監査可能な構文で解決します。 **始め方:** Python 3.10〜3.13が必要です。`uv tool install dbt-charts`または`pip install dbt-charts`でインストールします。ウェアハウスアダプターは追加機能として組み込みます(BigQuery、Snowflake、PostgreSQLなど。DuckDBは内蔵)。コマンド: `dct init`、`dct validate`、`dct serve`(ライブプレビュー用)。play.dbtcharts.comのプレイグラウンドで、インストールなしで試せます。 **CLI(`dct`):** 検証、HTML/PDF/PNG/SVG/JSONへのレンダリング、クエリ実行、ボード検索、列インパクトのトレース、オフラインのYAMLリファレンスを含みます。動詞: `validate`、`serve`、`render`、`query`、`search`、`impact`、`docs`、`examples`。 **エージェントスキルとMCP:** バンドルされたスキル(`dct skills intro`)と、VS Code、Cursor、Claude Desktopなど用のローカルMCPサーバーが同梱されています。`dct init mcp`でセットアップします。 **VS Code拡張機能:** 構文ハイライト、オートコンプリート、診断、ライブプレビューを追加します(CLIが必要)。MarketplaceとOpen VSXで利用可能です。 **機能:** ローカルソース(CSV、Parquet、JSON、DuckDB)と、dbtアダプター経由のウェアハウスをサポート。16種類のコアチャートタイプ(棒、折れ線、面、散布、ヒートマップ、円、ドーナツ、KPI、テーブル、地図など)に加え、13種類のセマンティックタイプ(ロリポップ、弾丸、傾斜、漏斗、スモールマルチプル)。カスタムYAML拡張による5つの組み込みテーマ。実用的なエラーコード付きの検証。`dct init ci`でGitHub Actionsワークフローを追加。古い構文の移行は自動で処理されます。 **dbt統合:** オプション。ボードは単独で使用するか、dbtプロジェクト内に置いて`ref()`を使用し、資格情報を共有し、CI検証を受けることができます。Pydantic、Jinja2、Vega-Lite、FastAPI上に構築。Apache License 2.0。読み取り専用ミラー。問題報告は歓迎、PRは受け付けていません。