Skip to main content
Edit this page

MetabaseをClickHouseに接続する

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

目的​

このガイドでは、Metabaseを使用してClickHouseのデータに関するいくつかの質問をして、回答を視覚化します。その回答の一例は次のようになります：

Pie Chart

データを追加する

作業するデータセットがない場合は、例のデータセットを追加できます。このガイドではUK Price Paidデータセットを使用するため、それを選ぶこともできます。同じドキュメンテーションカテゴリには他にもいくつかの選択肢があります。

1. 接続の詳細を集める​

HTTP(S) を使用して ClickHouse に接続するには、以下の情報が必要です：

  • HOST と PORT: 通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合は 8123 です。

  • データベース名: デフォルトで default という名前のデータベースがありますが、接続したいデータベースの名前を使用してください。

  • ユーザー名とパスワード: デフォルトでユーザー名は default です。使用ケースに適したユーザー名を使用してください。

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

ClickHouse Cloud service connect button

HTTPS を選択すると、サンプルの curl コマンドで詳細が確認できます。

ClickHouse Cloud HTTPS connection details

セルフマネージドの 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. Metabaseをhttp://hostname:3000でアクセスします。初回起動時にはウェルカム画面が表示され、一連の質問を通過する必要があります。データベースの選択を促された場合は、「後でデータを追加します」を選択してください：

3. MetabaseをClickHouseに接続する​

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

  2. データベースを追加をクリックします。または、データベースタブをクリックして、データベースを追加ボタンを選択します。

  3. ドライバーのインストールが正常に行われた場合は、ドロップダウンメニューのデータベースタイプとしてClickHouseが表示されます：

    Add a ClickHouse database

  4. データベースに表示名を付けます。これはMetabaseの設定であるため、任意の名前を使用できます。

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

    Connection details

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

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

  1. 右上のExit adminボタンをクリックして管理設定を終了します。

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

    New menu

  3. 例えば、1995年から2022年までの年ごとの平均価格を返すuk_price_paidテーブルに対して実行されたSQLクエリは次の通りです：

    Run a SQL query

5. 質問をする​

  1. + Newをクリックし、Questionを選択します。データベースとテーブルを基に質問を構築できます。例えば、以下の質問はdefaultデータベース内のuk_price_paidテーブルに関するものです。グレーター・マンチェスター郡内の町ごとの平均価格を計算する簡単な質問です：

    New question

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

    New question

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

    Pie Chart visualization

詳しく学ぶ​

Metabaseおよびダッシュボードの構築方法についての詳細は、Metabaseのドキュメンテーションを訪問してください。

関連コンテンツ​