SQL / BI
社内データベースに接続し、自然言語での問い合わせ・SQL 実行・ダッシュボード作成・外部 BI への連携（BI キー）を行います。
データベースに接続する
SQL 画面で接続を登録します。接続はユーザーごとに管理され、本人のみが参照・編集できます。
対応データソース
| 種別 | 既定ポート |
|---|---|
| PostgreSQL | 5432 |
| MySQL | 3306 |
| MariaDB | 3306 |
| SQL Server | 1433 |
| Oracle | 1521 |
| Amazon Redshift | 5439 |
| SQLite | （データベース欄にファイルパス） |
BigQuery は SQL 接続ではなく、パイプラインの接続として扱います（サービスアカウント JSON 認証）。
接続情報
| 項目 | 既定 | 必須 | 説明 |
|---|---|---|---|
| 名前 | — | ✔ | 接続の表示名 |
| 種別 | postgresql | — | 上表のデータソース。変更するとポートが自動で切り替わります |
| ホスト | localhost | — | DB ホスト |
| ポート | 5432 | — | 種別に応じた既定値 |
| データベース | — | ✔ | DB 名（SQLite はファイルパス） |
| ユーザー | — | ✔ | DB ユーザー |
| パスワード | — | — | DB パスワード |
| スキーマ | public | — | 既定スキーマ |
登録後、「接続テスト」で疎通を確認できます。なお、パイプラインで作成したデータは内蔵の Data Lake 接続から参照できます。
自然言語でクエリする（SQL Agent）
「何を知りたいか」を日本語で書くと、SQL を生成します。
- 対象テーブルを選びます（選んだテーブルの列情報とサンプルが文脈になります）。
- 指示を入力します（例:「先月の売上を支店別に集計して」）。
- 生成された SQL を確認します（まず生成のみ。実行はしません）。
- Run で実行します。 → 結果が表・グラフで表示されます。
- うまくいかなければ、続けて指示を追加して精緻化できます（マルチターン）。
| 項目 | 既定 | 説明 |
|---|---|---|
| 指示 | — | 自然言語の指示（必須） |
| 対象テーブル | — | 文脈にする 1 つ以上のテーブル |
| モデル | — | 使う LLM（クラウド / vLLM） |
| Temperature | 0.3 | 生成の安定性（低いほど確定的） |
複数テーブルを結合したい場合は、生成後の SQL エディタで JOIN を手書きします。生成 SQL は「Run Query」で直接実行・編集できます。表データはその場で編集・保存（INSERT / UPDATE / DELETE）も可能です。
ダッシュボードを作る
クエリ結果をチャートとして保存し、ダッシュボードに並べます。
- クエリ実行後、「ダッシュボードに追加」 を選びます（既存に追加 / 新規作成）。
- ダッシュボード詳細画面で、ドラッグ＆リサイズして配置します（12 カラムグリッド）。
- 「再読込」 で全チャートを再実行します。
各チャートは SQL を保持し、表示のたびに接続先で実行されます。
チャート設定
| 項目 | 選択肢 / 既定 | 説明 |
|---|---|---|
| 種別 | bar / line / pie / pivot / scatter（既定 bar） | チャートの種類 |
| X 軸 / Y 軸 | 列を選択 | 軸に使う列。bar / line は複数系列(Y)可 |
| 集約 | sum / avg / count / min / max | X が重複するときの集約方法 |
| 表示点数 | 既定 50 | 表示する最大データ点数 |
| 積み上げ / エリア | on/off | 棒の積み上げ、折れ線のエリア化 |
| データラベル | on/off | 値ラベルの表示 |
| 目標線 | 数値 | bar / line に目標値の線を引く |
| パレット | default / office / pastel / vivid / mono | 配色 |
チャートは PNG でダウンロードできます。各チャートの SQL は接続名つきでコピー・.sql ダウンロードでき、他の BI ツール（Tableau / Power BI / Excel）へ移行できます。
クエリの自動化（定期更新）
現状、ダッシュボードの自動定期更新（スケジュール実行）は未対応です。更新は「再読込」ボタンによる手動です（更新間隔の項目は将来対応のため予約されています）。
BI キーで外部 BI に接続する
Data Lake のデータを、Looker Studio / Metabase / Tableau / Excel などの外部 BI から読めるようにする専用キー（bk-）です。
発行する
- SQL 画面の 「DataLake 管理」 を開きます。
- BI 接続トークンを発行します。
→
bk-...のトークンが発行時に 1 回だけ表示されます。安全に保管してください（後から再表示も可能）。 - 公開するデータセットを選びます（未指定なら自分の全データセット）。失効日・有効/無効も設定できます。
接続する（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 など）
| 項目 | 値 |
|---|---|
| ホスト | 画面に表示されるホスト名 |
| ポート | 5434 |
| データベース | digitalbase |
| ユーザー | bikey（任意） |
| パスワード | bk-...（発行したトークン） |
接続文字列の例: postgresql://bikey:bk-...@<ホスト>:5434/digitalbase
BI キー方式は、旧来のユーザーごとの DB ロール発行（bi-credential）に代わるものです。データベースのロール作成や権限付与は不要で、公開データセットだけが読み取り専用で見えます。
関連
- パイプライン(ETL) — Data Lake へのデータ蓄積・BigQuery
- 外部データソース接続