メインコンテンツへスキップ
メインコンテンツへスキップ

Metabase を ClickHouse に接続する

Partner Integration

Metabase は、データに関する疑問を解消するための、使いやすいオープンソースの UI ツールです。Metabase は Java アプリケーションであり、JAR ファイルをダウンロードして java -jar metabase.jar で実行するだけで起動できます。Metabase は、JDBC ドライバーを使用して ClickHouse に接続します。このドライバーをダウンロードして plugins フォルダに配置します。

目標​

このガイドでは、Metabase を使って ClickHouse のデータに対していくつかクエリを実行し、その結果を可視化します。可視化結果の 1 つは次のようになります：

ClickHouse のデータを表示している Metabase の円グラフ可視化

データを追加する

作業に使えるデータセットがない場合は、サンプルデータセットのいずれかを追加できます。このガイドでは UK Price Paid データセットを使用しているので、それを選んでもよいでしょう。同じドキュメントカテゴリ内に、他にもいくつか利用できるデータセットがあります。

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

HTTP(S) で ClickHouse に接続するには、次の情報が必要です。

Parameter(s)Description
HOST and PORT通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合のポートは 8123 です。
DATABASE NAME既定で default という名前のデータベースが用意されています。接続したいデータベースの名前を使用してください。
USERNAME and PASSWORD既定のユーザー名は default です。用途に応じて適切なユーザー名を使用してください。

ClickHouse Cloud サービスに関する詳細情報は、ClickHouse Cloud コンソールで確認できます。 サービスを選択し、Connect をクリックします。

ClickHouse Cloud サービスの Connect ボタン

HTTPS を選択します。接続情報は、サンプルの curl コマンド内に表示されます。

ClickHouse Cloud HTTPS 接続詳細

自己管理型の ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

2. Metabase 用の ClickHouse プラグインをダウンロードする​

  1. plugins フォルダがない場合は、metabase.jar を保存している場所のサブフォルダとして plugins フォルダを作成します。

  2. プラグインは clickhouse.metabase-driver.jar という名前の JAR ファイルです。最新版の JAR ファイルを https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest からダウンロードします。

  3. clickhouse.metabase-driver.jar を plugins フォルダに保存します。

  4. Metabase を起動（または再起動）して、ドライバが正しく読み込まれるようにします。

  5. http://hostname:3000 で Metabase にアクセスします。初回起動時にはウェルカム画面が表示され、いくつかの質問に順に回答する必要があります。データベースの選択を求められた場合は、「I'll add my data later」を選択します。

3. Metabase を ClickHouse に接続する​

  1. 右上の歯車アイコンをクリックし、Admin Settings を選択して、Metabase 管理ページに移動します。

  2. Add a database をクリックします。 または、Databases タブをクリックし、Add database ボタンを選択します。

  3. ドライバーのインストールが正しく行われていれば、Database type のドロップダウンメニューに ClickHouse が表示されます。

    ClickHouse がオプションとして表示されている Metabase のデータベース選択画面

  4. データベースに Display name を付けます。これは Metabase 側の設定なので、任意の名前を使用できます。

  5. ClickHouse データベースの接続情報を入力します。ClickHouse サーバーが SSL を使用するように構成されている場合は、安全な接続を有効にします。例:

    ClickHouse データベース用の Metabase 接続情報フォーム

  6. Save ボタンをクリックすると、Metabase がデータベース内のテーブルをスキャンします。

4. SQL クエリを実行する​

  1. 右上隅にある Exit admin ボタンをクリックして、Admin settings を閉じます。

  2. 右上隅の + New メニューをクリックすると、質問の作成、SQL クエリの実行、ダッシュボードの作成ができることを確認できます。

    Metabase の New メニューに、質問、SQL クエリ、ダッシュボードを作成するオプションが表示されている

  3. 例として、uk_price_paid というテーブルに対して、1995 年から 2022 年までの年ごとの平均支払価格を返す SQL クエリは次のようになります。

    UK price paid データに対するクエリを表示している Metabase の SQL エディタ

5. 質問を作成する​

  1. + New をクリックして、Question を選択します。データベースとテーブルを基点として質問を作成できることに注目してください。たとえば、次の質問は default データベース内の uk_price_paid というテーブルに対して作成されています。以下は、Greater Manchester 郡内の町ごとの平均価格を計算するシンプルな質問です。

    UK の価格データを用いた Metabase のクエスチョンビルダーインターフェース

  2. Visualize ボタンをクリックして、結果を表形式ビューで表示します。

    町ごとの平均価格の表形式結果を表示している Metabase の可視化

  3. 結果の下にある Visualization ボタンをクリックして、可視化を棒グラフ（または他の利用可能なオプション）に変更します。

    Greater Manchester における町ごとの平均価格を示す Metabase の円グラフ可視化

詳細はこちら​

Metabase の詳細やダッシュボードの作成方法については、Metabase ドキュメントをご覧ください。