DigitalBase Docs

ダッシュボード

社内データベースに接続し、自然言語での問い合わせ・SQL 実行・ダッシュボード作成・外部 BI への連携（BI キー）を行います。

データセットとは

データセットは、DigitalBase に内蔵されたデータの保管庫です。パイプラインで取り込み・加工したデータがデータセットとして蓄積され、外部 DB を別途用意しなくても、そのまま分析・可視化できます。

  • 蓄積 — パイプラインの load_postgres_dataset などのオペレータで、収集・変換した結果をデータセットに書き込みます。チャットの回答に表が出たときは、表の下の 「データセット」 ボタンからも保存できます（数値に見える列は自動で数値型として保存されます）。保存後は「SQLで開く」でこの画面に、「エージェントを続ける」で元のチャットに戻れます。
  • 参照 — SQL 画面の内蔵 データセット接続から、登録した外部 DB と同じようにクエリできます。
  • AI から利用 — チャットのツール（query_dataset）でも読み取り専用 SQL で参照できます。
  • 外部 BI へ公開 — BI キー（bk-）で Looker Studio / Metabase などから読み取れます（後述）。

「パイプラインで集める → データセットに貯まる → SQL / ダッシュボード / AI / 外部 BI から使う」という流れの中心になる保管庫です。

データベースに接続する

SQL 画面で接続を登録します。接続はユーザーごとに管理され、本人のみが参照・編集できます。

対応データソース

種別既定ポート
PostgreSQL5432
MySQL3306
MariaDB3306
SQL Server1433
Oracle1521
Amazon Redshift5439
SQLite（データベース欄にファイルパス）
補足

BigQuery は SQL 接続ではなく、パイプラインの接続として扱います（サービスアカウント JSON 認証）。

接続情報

項目既定必須説明
名前—✔接続の表示名
種別postgresql—上表のデータソース。変更するとポートが自動で切り替わります
ホストlocalhost—DB ホスト
ポート5432—種別に応じた既定値
データベース—✔DB 名（SQLite はファイルパス）
ユーザー—✔DB ユーザー
パスワード——DB パスワード
スキーマpublic—既定スキーマ

登録後、「接続テスト」で疎通を確認できます。なお、パイプラインで作成したデータは内蔵の データセット 接続から参照できます。

自然言語でクエリする（SQL Agent）

「何を知りたいか」を日本語で書くと、SQL を生成します。

  1. 対象テーブルを選びます（選んだテーブルの列情報とサンプルが文脈になります）。
  2. 指示を入力します（例:「先月の売上を支店別に集計して」）。
  3. 生成された SQL を確認します（まず生成のみ。実行はしません）。
  4. Run で実行します。 → 結果が表・グラフで表示されます。
  5. うまくいかなければ、続けて指示を追加して精緻化できます（マルチターン）。
項目既定説明
指示—自然言語の指示（必須）
対象テーブル—文脈にする 1 つ以上のテーブル
モデル—使う LLM（クラウド / vLLM）
Temperature0.3生成の安定性（低いほど確定的）
補足

複数テーブルを結合したい場合は、生成後の SQL エディタで JOIN を手書きします。生成 SQL は「Run Query」で直接実行・編集できます。表データはその場で編集・保存（INSERT / UPDATE / DELETE）も可能です。

ダッシュボードを作る

クエリ結果をチャートとして保存し、ダッシュボードに並べます。

  1. クエリ実行後、「ダッシュボードに追加」 を選びます（既存に追加 / 新規作成）。
  2. ダッシュボード詳細画面で、ドラッグ＆リサイズして配置します（12 カラムグリッド）。
  3. 「再読込」 で全チャートを再実行します。

各チャートは SQL を保持し、表示のたびに接続先で実行されます。

チャート設定

項目選択肢 / 既定説明
種別棒 / 折れ線 / 円 / ピボット / 散布 / パレート / ヒストグラム（既定 棒）チャートの種類。パレートは件数の降順＋累積%を自動計算、ヒストグラムは数値列を区間分割
X 軸 / Y 軸列を選択軸に使う列。棒 / 折れ線は複数系列(Y)可
折れ線を重ねる棒に系列を追加棒グラフに折れ線系列を重ね（第2軸も可）、複合グラフにできます
集約合計 / 平均 / 件数 / 最小 / 最大X が重複するときの集約方法
表示点数既定 50表示する最大データ点数
積み上げ / エリアon/off棒の積み上げ、折れ線のエリア化
データラベルon/off値ラベルの表示（散布図は各点の Y 値）
基準線 / しきい値線（上限・下限）数値目標値や規格限界の線を引く（管理図風の表示に）
配色標準(色覚安全) / 淡色 / モノクロ / ブランドカラーパレット。ブランドカラーは組織のブランド色から自動生成
系列ごとの色色を個別指定各系列（円は各スライス）の色をスウォッチ／任意色で上書き。「不良は赤」など意味を持たせた配色が可能

チャートは PNG でダウンロードできます。各チャートの SQL は接続名つきでコピー・.sql ダウンロードでき、他の BI ツール（Tableau / Power BI / Excel）へ移行できます。

データの自動更新

データ自体はワークフローで自動更新できます。 パイプラインをスケジュール実行してデータセットを定期的に更新すると、各チャートは表示・再読込のたびに最新データで SQL を再実行するため、結果は自動的に新しくなります。

補足

未対応なのは、ダッシュボード画面そのものの自動リフレッシュ（開いたまま一定間隔で再描画）だけです。画面の更新は「再読込」ボタンによる手動です（更新間隔の項目は将来対応のため予約）。データの鮮度はワークフローのスケジュールで保てます。

BI キーで外部 BI に接続する

データセットを、Looker Studio / Metabase / Tableau / Excel などの外部 BI から読めるようにする専用キー（bk-）です。

発行する

  1. SQL 画面の 「データセット管理」 を開きます。
  2. BI 接続トークンを発行します。 → bk-... のトークンが発行時に 1 回だけ表示されます。安全に保管してください（後から再表示も可能）。
  3. 公開するデータセットを選びます（未指定なら自分の全データセット）。失効日・有効/無効も設定できます。

接続する（2 通り）

A. REST で取得

# データセット一覧
curl -H "Authorization: Bearer bk-..." http://<ホスト>:8000/v1/data/datasets

# データ取得（読み取り専用）
curl -H "Authorization: Bearer bk-..." \
  -H "Content-Type: application/json" \
  -X POST http://<ホスト>:8000/v1/data/query \
  -d '{"dataset":"<名前>","limit":1000}'

B. PostgreSQL として直結（Metabase / Tableau / Excel など）

補足

PostgreSQL 直結は既定では無効です。サーバーの .env に BIKEY_PG_PROXY_ENABLED=1 を設定して再起動すると、ポート 5434 で待ち受けます（ポート / 待受アドレスは BIKEY_PG_PROXY_PORT / BIKEY_PG_PROXY_HOST で変更可）。別マシンの BI ツールから繋ぐ場合はファイアウォールでポート 5434 の開放も必要です。REST での取得（A）は設定不要で常時利用できます。

項目値
ホスト画面に表示されるホスト名
ポート5434
データベースdigitalbase
ユーザーbikey（任意）
パスワードbk-...（発行したトークン）

接続文字列の例: postgresql://bikey:bk-...@<ホスト>:5434/digitalbase

補足

BI キー方式は、旧来のユーザーごとの DB ロール発行（bi-credential）に代わるものです。データベースのロール作成や権限付与は不要で、公開データセットだけが読み取り専用で見えます。

関連