java -jar metabase.jar を実行するだけで起動できます。Metabase は、ダウンロードして plugins フォルダーに配置した JDBC ドライバー を使って ClickHouse に接続します。
目的
1
接続情報を確認する
HTTP(S) で ClickHouse に接続するには、次の情報が必要です。
ClickHouse Cloud サービスの詳細は、ClickHouse Cloud コンソールで確認できます。
サービスを選択し、Connect をクリックします。
curl コマンドの例として表示されます。2
Metabase 用の ClickHouse プラグインをダウンロードする
-
pluginsフォルダがない場合は、metabase.jarを保存している場所のサブフォルダとして作成します。 -
プラグインは
clickhouse.metabase-driver.jarという名前の JAR ファイルです。最新バージョンの JAR ファイルを https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest からダウンロードします。 -
clickhouse.metabase-driver.jarをpluginsフォルダに保存します。 - ドライバーが正しく読み込まれるように、Metabase を起動します (または再起動します) 。
- http://hostname:3000 で Metabase にアクセスします。初回起動時にはウェルカム画面が表示され、いくつかの質問に順に答える必要があります。データベースの選択を求められた場合は、「I’ll add my data later」を選択します。
3
Metabase を ClickHouse に接続する
- 右上の歯車アイコンをクリックし、Admin Settings を選択して、Metabase の管理ページを開きます。
- Add a database をクリックします。別の方法として、Databases タブをクリックし、Add database ボタンを選択することもできます。
- ドライバーのインストールに成功していれば、Database type のドロップダウンメニューに ClickHouse が表示されます。
- データベースの Display name を設定します。これは Metabase 側の設定なので、名前は任意で構いません。
- ClickHouse データベースの接続情報を入力します。ClickHouseサーバーが SSL を使用するように設定されている場合は、セキュア接続を有効にします。例:
- Save ボタンをクリックすると、Metabase がデータベース内のテーブルをスキャンします。
4
SQL クエリを実行する
- 右上の Exit admin ボタンをクリックして、Admin settings を終了します。
- 右上の + New メニューをクリックすると、質問の作成、SQL クエリの実行、ダッシュボードの作成ができることがわかります。
-
たとえば、次は
uk_price_paidという名前のテーブルに対して実行した SQL クエリで、1995 年から 2022 年までの年ごとの平均価格を返します。
5
質問する
-
+ New をクリックし、Question を選択します。データベースとテーブルを起点に質問を作成できることがわかります。たとえば、次の質問は
defaultデータベース内のuk_price_paidという名前のテーブルに対して行っています。これは Greater Manchester の county 内で、town ごとの平均価格を計算するシンプルな質問です。 - Visualize ボタンをクリックすると、結果を表形式で表示できます。
- 結果の下にある Visualization ボタンをクリックして、可視化 を棒グラフ (または利用可能な他のオプション) に変更します。