Apache SupersetをDockerでセルフホスト：MySQLとPostgreSQLに対応した「安価で高機能」なBIソリューション – ITFROMZERO

Table of Contents

現実的な課題：データベースに眠るデータと、上司からの急なレポート依頼

ECスタートアップを半年以上運営して、データの断片化という現実に直面しました。取引情報はPostgreSQLに、ユーザープロファイルはMySQLに保存されています。ビジネスサイドから成長レポートを求められるたび、エンジニアチームは開発を止めてSQLを書き、Excelにエクスポートする作業に追われていました。

この繰り返しは非常に時間の無駄です。リアルタイムでのデータ閲覧ニーズが高まる中、TableauやPower BIに年間2,000ドル以上のライセンス料を払うのは、スタートアップにとって大きな負担です。そこで、セキュリティを確保しつつ拡張性も備えた、セルフホスト可能なオープンソースのビジネスインテリジェンス（BI）プラットフォームが必要になりました。

なぜ自前でダッシュボードを構築するのは「苦行」なのか？

「ReactやVueで適当にダッシュボードを作って、DBからAPIでデータを取得すればいい」と考えがちですが、現実はそれほど甘くありません。データが1,000万〜2,000万行に達すると、本番環境のDBに直接クエリを投げるだけでCPU使用率が90%に跳ね上がり、システム全体が遅延します。

柔軟性の欠如：グラフの色を変えたり、カラムを1つ追加したりするだけで、コードを書き直してビルド、デプロイし直す必要があります。
権限管理の悪夢：「ユーザーAは拠点Xのデータのみ閲覧可能」といったロジックを手動で実装するのは非常に手間がかかります。
データの統合：MySQLとPostgreSQLという異なるサーバーのデータを1つのグラフに統合するのは、専用ツールなしでは極めて困難な課題です。

主要なソリューションの比較

Apache Supersetを選ぶ前に、いくつかのツールを試しました：

Metabase：UIが非常に美しく、導入も簡単です。しかし、深いカスタマイズや複雑なグラフが必要になると、限界が見えてきます。
Grafana：サーバー監視やログ管理には最強です。しかし、ビジネス向けの深い分析レポートを作成するには、UIが少し「硬く」、非エンジニアには使いにくい面があります。
Redash：純粋なSQLを書くことに長けています。難点はダッシュボードのUIが少し古く、最新のツールに比べると操作感がスムーズではありません。

Apache Superset：オープンソース界の「決定版」

半年間の運用を経て、Supersetが最もバランスの取れた選択肢だと確信しました。SQLAlchemyを通じてほぼすべてのデータベースをサポートしています。ドラッグ＆ドロップ（ノーコード）のインターフェースにより、マーケティング担当者でもエンジニアの手を借りずに自分でグラフを作成できます。特に、権限管理システム（RBAC）はデータ1行単位まで詳細に設定可能です。

古いレポートファイルからデータを素早く処理したい場合は、toolcraft.app/ja/tools/data/csv-to-json のコンバーターを試してみてください。ブラウザ上でCSVをJSONに変換でき、安全にインポートテストが行えます。

DockerによるApache Supersetのインストール手順

Docker Composeを使用するのが、安定した環境を構築する最短ルートです。Redis（キャッシュ用）やPostgreSQL（Supersetのメタデータ保存用）も一括で管理できます。

ステップ1：環境の準備

サーバーは最低4GBのRAMが必要です。重いグラフが多いダッシュボードを運用する場合は、8GB以上のRAMがあると安心です。

# 公式リポジトリをクローン
git clone --depth=1 https://github.com/apache/superset.git
cd superset

ステップ2：セキュリティ設定

本番環境では、デフォルト設定を絶対に使用しないでください。セッションを暗号化するための独自のSecret Keyを生成する必要があります。

# ランダムなシークレットキーを生成
openssl rand -base64 42

生成されたキーを .env-non-dev ファイルにコピーします。その後、以下のコマンドでシステムを起動します：

docker-compose -f docker-compose-non-dev.yml up -d

ステップ3：管理者アカウントの設定

コンテナが安定して起動したら、管理者アカウントと内部データベースを初期化します：

# 管理者ユーザーを作成
docker exec -it superset_app superset fab create-admin \
              --username admin \
              --firstname Superset \
              --lastname Admin \
              --email [email protected] \
              --password admin

# データベースを更新し、権限を初期化
docker exec -it superset_app superset db upgrade
docker exec -it superset_app superset init

MySQLとPostgreSQLへの接続

ポート 8088 にアクセスし、Settings -> Database Connections を選択します。

PostgreSQLの場合、接続文字列は通常次のようになります：postgresql://user:pass@host:5432/db_name。

MySQLの場合、文字化けを防ぐために mysql+mysqlconnector ドライバを使用することをお勧めします：mysql://user:pass@host:3306/db_name?charset=utf8mb4。

注意：DBがDockerと同じサーバー上にある場合は、localhost の代わりに 172.17.0.1 というIPを使用してください。

システムをスムーズに運用するための実践的なアドバイス

Redisをキャッシュレイヤーとして設定することを忘れないでください。実際、キャッシュがないと10枚のグラフを持つダッシュボードは、ページを読み込むたびにDBに対して10個のクエリを同時に実行します。Redisを導入すれば、2回目以降の閲覧ではロード時間を5秒から1秒未満に短縮できます。

次に、行レベルセキュリティ（RLS）を活用しましょう。これにより、「同じダッシュボードを使いながら、北部の営業チームには北部のデータのみを表示させる」といった課題を解決できます。

最後に、Dockerコンテナのリソース制限を設定してください。Supersetは巨大なヒートマップなどを処理する際、かなりRAMを消費します。制限を設けることで、重いクエリが実行された際でも、同じサーバー上の他のサービスがダウンするのを防げます。

Supersetを導入したことで、エンジニアチームは「レポート作成依頼」からほぼ解放されました。データが必要な人の手に直接届くようになり、すべてのビジネス上の意思決定が、勘ではなく実際の数値に基づいて行われるようになりました。