MetabaseをClickHouseに接続する

Metabaseは、データについて手軽に質問できる、使いやすいオープンソースのUIツールです。

Metabase は、データについて手軽に分析や質問ができる、使いやすいオープンソースの UI ツールです。Metabase は Java アプリケーションで、JAR ファイルをダウンロードし、java -jar metabase.jar を実行するだけで起動できます。Metabase は、ダウンロードして plugins フォルダーに配置した JDBC ドライバー を使って ClickHouse に接続します。

​

目的

このガイドでは、Metabase を使って ClickHouse のデータにいくつか質問し、その結果を可視化します。表示結果の 1 つは次のようになります。

データを追加する

使用できるデータセットがない場合は、サンプルの 1 つを追加できます。このガイドでは 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 をクリックします。

HTTPS を選択します。接続情報は curl コマンドの例として表示されます。

セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

​

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

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

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 が表示されます。

4. データベースの Display name を設定します。これは Metabase 側の設定なので、名前は任意で構いません。

5. ClickHouse データベースの接続情報を入力します。ClickHouseサーバーが SSL を使用するように設定されている場合は、セキュア接続を有効にします。例:

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

​

4. SQL クエリを実行する

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

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

3. たとえば、以下は uk_price_paid という名前のテーブルに対して実行する SQL クエリで、1995 年から 2022 年までの各年の平均支払価格を返します。

​

5. 質問する

1. + New をクリックして Question を選択します。database と table を起点に質問を作成できることがわかります。たとえば、次の質問は default database の uk_price_paid という table に対して行っています。以下は、Greater Manchester の county 内で町ごとの平均価格を計算するシンプルな質問です。

2. Visualize ボタンをクリックすると、結果を表形式で確認できます。

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

​

詳細情報

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