MetabaseをClickHouseに接続する

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

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

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

セルフマネージド ClickHouse を使用している場合、接続情報は 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」を選択します。

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 がデータベース内のテーブルをスキャンします。

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

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

   

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

   

1. + New をクリックし、Question を選択します。データベースとテーブルを起点に質問を作成できることがわかります。たとえば、次の質問は default データベース内の uk_price_paid という名前のテーブルに対して行っています。これは Greater Manchester の county 内で、town ごとの平均価格を計算するシンプルな質問です。

   

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

   

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