\n```\n\nリンクについても同様のアプローチが適用されます。詳細は [Evidence base paths docs](https://docs.evidence.dev/deployment/configuration/base-paths#custom-components) を参照してください。"}},{"@type":"Question","name":"なぜEvidence DuckDB sourceは、最初の行にNULL値が含まれていると 'Error: Unsupported object type: null' を返すのですか?","acceptedAnswer":{"@type":"Answer","text":"このエラーは、EvidenceのDuckDBコネクタがソースクエリに対してDESCRIBEクエリを実行してカラム型を判別しようとするために発生します。DESCRIBEが失敗した場合(例:一時テーブル、CTE、複雑なクエリなど)、JavaScriptのtypeofを使用して最初の行から型を推測するフォールバックが行われます。最初の行にNULLが含まれていると、typeofはNULLに対して'object'を返すため、このエラーが発生します。回避策:最初の行に非NULL値が含まれるようにします。行の並び替え(ORDER BY column IS NOT NULL DESC)や、COALESCEを使用してNULLをプレースホルダーに置き換え、その後Evidence内で処理します。恒久的な修正としては、DuckDBのネイティブなステートメント記述を使用してカラム型を取得する方式がEvidenceリポジトリで追跡されています。修正がリリースされたら、Evidenceをアップグレードすることで解決する可能性があります。"}}]}]}Evidence
オープンソースBIツール。SQL+Markdownでレポートを記述し、ドラッグ&ドロップ式レポートを代替。
スマートダウンロード
プロジェクトのホームページへ
インストーラはまだありません — ソースリポジトリをご覧ください
コードでBIレポートを書き、SQLでデータを照会し、Markdownでレイアウトして、ウェブサイトを生成します。
主な機能
- Markdown内に直接SQLクエリを記述し、実行後に自動的にグラフとテーブルを生成
- 複数のデータソースをサポート:PostgreSQL、MySQL、Snowflake、BigQueryなど
- テンプレート化されたページ:1つのMarkdownテンプレートから複数ページのレポートを生成可能(顧客別、日付別など)
- 条件ロジックとループ:レポート内でif/elseやforループを使用して表示内容を制御
- 完全な静的サイト出力:セルフホスト可能、サーバーサイドのランタイム不要
できないこと
- •SQLとMarkdownへの習熟が必要で、コード経験がまったくないユーザーには適していません。チャートの種類は現時点では少なく、高度な可視化にはカスタマイズが必要です。複雑なデータクレンジングはレポート層で行うのには適していません。
使用例
- データチームが社内ダッシュボードや週次レポートを迅速に作成し、Gitでバージョン管理
- アナリストが事業部門向けにインタラクティブな営業・運営レポートを生成
- オープンソースプロジェクトのドキュメントに動的なデータ例(GitHub Starsのトレンドなど)を埋め込む
- Tableau/Power BIのシンプルなレポートを代替し、コストを削減
Evidence は、オープンソースのコード駆動型ビジネスインテリジェンス(BI)ツールで、従来のドラッグ&ドロップ式レポートツールを SQL と Markdown で置き換えます。Markdown ファイルに SQL クエリを埋め込み、PostgreSQL、MySQL、BigQuery などのデータソースに接続して、グラフ、表、動的ページを自動生成できます。最終的な出力は、そのままデプロイ可能な静的ウェブサイトです(Netlify、Vercel などに対応)。コードに慣れたデータチームに適しており、レポートのバージョン管理と再現性を実現でき、有料の BI ツールは不要です。SQL と Markdown を書ける必要がありますが、習得は簡単です。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
ステップ1:VS Codeをインストールし、「Evidence」拡張機能を検索してインストールします
ステップ2:F1を押してコマンドパレットを開き、「Evidence: New Evidence Project」と入力して新しいプロジェクトを作成します
ステップ3:プロジェクト内に .md ファイルを作成し、SQL コードブロックでクエリを記述して保存すると、ブラウザでレポートをプレビューできます
- ステップ1:VS Codeをインストールし、「Evidence」拡張機能を検索してインストールします
- ステップ2:F1を押してコマンドパレットを開き、「Evidence: New Evidence Project」と入力して新しいプロジェクトを作成します
- ステップ3:プロジェクト内に .md ファイルを作成し、SQL コードブロックでクエリを記述して保存すると、ブラウザでレポートをプレビューできます
チェックサムがありません
このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません
SHA256 チェックサム
チェックサムなし
GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
VS Codeの拡張機能管理でEvidence拡張機能をアンインストールし、その後プロジェクトフォルダーを削除するだけです。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生?以下のFAQを確認
5 FAQs