metabase-sandbox

Docker と DuckDB を用いた、Metabase をローカルで試せる構成です。DuckDB はファイルベースの分析用データベースで、サンプル売上データを収録した .duckdb ファイルを Metabase から参照します。

前提

DuckDB ファイルを生成
```
make seed
```
duckdb/sample.duckdb にサンプルデータが作成されます。
Metabase を起動
```
make up
```
ブラウザで http://localhost:3000 を開き、管理者アカウントの初期設定を完了させます。
DuckDB を Metabase に登録
Metabase の管理画面から「データベースを追加」→「DuckDB」を選択し、以下の値を入力します。
- Database file: /app/duckdb/sample.duckdb
  その他の設定は既定のままで構いません。

API 経由で接続設定・カード・ダッシュボードを生成するには以下を実行します。

export MB_EMAIL="admin@example.com"   # Metabase で作成した管理者メール
export MB_PASSWORD="your_password"    # そのパスワード

make bootstrap

完了すると Metabase 上に以下が作成されます。

Metabase の Embedding SDK を使った React サンプルを embedding-demo/ に用意しています。Metabase の「アプリに埋め込み」機能を有効にし、埋め込みシークレットと埋め込み用ダッシュボード ID を取得した上で以下を実施してください。

依存関係のインストール（Bun 使用）
```
cd embedding-demo
cp .env.example .env.local
bun install
```
.env.local の METABASE_EMBED_SECRET とダッシュボード ID を実際の値に更新します（Vite 用 VITE_ 付き変数も同じ値に揃えてください）。
署名サーバーを起動
```
bun run server
```
4000 番ポートで /api/metabase-embed-jwt エンドポイントが立ち上がり、埋め込みトークンを生成します。
別ターミナルでフロントエンドを起動
```
bun run dev
```
ブラウザで http://localhost:5173 を開くと、Metabase のダッシュボードが React コンポーネントとしてレンダリングされます。

コード整形は bun run format、lint チェックは bun run lint で実行できます。

必要に応じて METABASE_SITE_URL をホストに合わせて変更してください。Metabase が Basic 認証や VPN の裏にある場合は、署名サーバーからアクセス可能であることを確認してください。