Skip to main content
Apache Superset は、Python 製のオープンソースのデータ探索・可視化プラットフォームです。Superset は、ClickHouse が提供する Python ドライバーを使用して ClickHouse に接続します。では、その仕組みを見ていきましょう…

​
目標

このガイドでは、ClickHouse データベースのデータを使って Superset でダッシュボードを作成します。ダッシュボードは次のようになります。
データを追加する使用するデータセットがない場合は、例のいずれかを追加できます。このガイドでは UK Price Paid データセットを使用しているため、それを選ぶとよいでしょう。同じドキュメントカテゴリには、ほかにもいくつかあります。

​
1. 接続情報を確認する

HTTP(S) で ClickHouse に接続するには、次の情報が必要です。 ClickHouse Cloud サービスの詳細は、ClickHouse Cloud コンソールで確認できます。 サービスを選択し、Connect をクリックします。 HTTPS を選択します。接続情報は curl コマンドの例として表示されます。 セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

​
2. ドライバーをインストールする

  1. Superset は ClickHouse に接続するために clickhouse-connect ドライバーを使用します。clickhouse-connect の詳細は https://pypi.org/project/clickhouse-connect/ を参照してください。インストールには次のコマンドを実行します。
Docker Compose のセットアップDocker ベースのインストールの場合、コンテナーに clickhouse-connect を追加する手順については、Superset database configuration guide を参照してください。
  1. Superset を起動します (または再起動します) 。

​
3. Superset を ClickHouse に接続する

  1. Superset で、上部メニューから Data を選択し、次にドロップダウンメニューから Databases を選択します。+ Database ボタンをクリックして、新しいデータベースを追加します。

  1. 最初のステップで、データベースの種類として ClickHouse Connect を選択します。

  1. 2 番目のステップでは、以下を行います。
  • SSL をオンまたはオフに設定します。
  • 先ほど収集した接続情報を入力します。
  • DISPLAY NAME を指定します。これは任意の名前で構いません。複数の ClickHouse データベースに接続する場合は、よりわかりやすい名前にしてください。

  1. CONNECT をクリックし、続けて FINISH ボタンをクリックしてセットアップウィザードを完了します。完了すると、データベースの一覧に追加したデータベースが表示されます。

​
4. データセットを追加する

  1. Superset で ClickHouse のデータを操作するには、データセット を定義する必要があります。Superset の上部メニューで Data を選択し、ドロップダウンメニューから Datasets を選択します。
  2. データセットを追加するボタンをクリックします。新しく作成したデータベースをデータソースとして選択すると、そのデータベースで定義したテーブルが表示されます。

  1. ダイアログウィンドウの下部にある ADD ボタンをクリックすると、テーブルがデータセットの一覧に表示されます。これでダッシュボードを作成し、ClickHouse のデータを分析する準備は完了です。

​
5. Superset でチャートとダッシュボードを作成する

Superset に慣れているなら、この次のセクションもすぐに理解できるはずです。Superset を初めて使う場合でも、まあ……世の中にある多くの優れた可視化ツールと同じです。使い始めるのは簡単ですが、細かな違いやコツは、実際に使いながら少しずつ身についていきます。
  1. まずはダッシュボードから始めます。Superset の上部メニューで Dashboards を選択します。右上のボタンをクリックして、新しいダッシュボードを追加します。以下のダッシュボード名は UK property prices です。

  1. 新しいチャートを作成するには、上部メニューから Charts を選択し、新しいチャートを追加するボタンをクリックします。多数のオプションが表示されます。次の例では、CHOOSE A DATASET ドロップダウンから uk_price_paid データセットを選び、Pie Chart チャートを使用しています。

  1. Superset の円グラフでは Dimension と Metric が必要で、それ以外の設定は任意です。Dimension と Metric には任意のフィールドを選べます。この例では、ClickHouse のフィールド district を Dimension、AVG(price) を Metric としています。

  1. 円グラフではなくドーナツチャートにしたい場合は、CUSTOMIZE でそのほかのオプションとあわせて設定できます。

  1. SAVE ボタンをクリックしてチャートを保存し、次に ADD TO DASHBOARD ドロップダウンで UK property prices を選択します。その後、SAVE & GO TO DASHBOARD をクリックすると、チャートが保存され、ダッシュボードに追加されます。

  1. 以上です。ClickHouse のデータを基に Superset でダッシュボードを構築すれば、超高速なデータ分析の世界が大きく広がります。

最終更新日 2026年7月3日