メインコンテンツまでスキップ
メインコンテンツまでスキップ

MetabaseをClickHouseに接続する

Community Maintained

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

目標​

このガイドでは、Metabaseを使用してClickHouseデータにいくつかの質問をし、その回答を視覚化します。その回答の一例を以下に示します：

Metabaseの円グラフの視覚化、ClickHouseからのデータを表示

データを追加する

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

1. 接続情報を集める​

To connect to ClickHouse with HTTP(S) you need this information:

  • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

  • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

  • The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS, and the details are available in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

以下は、ClickHouseにHTTP(S)で接続するために必要な情報です：

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

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

  • USERNAMEとPASSWORD: デフォルトでは、ユーザー名はdefaultです。使用ケースに適したユーザー名を使用します。

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

ClickHouse Cloud service connect button

HTTPSを選択すると、詳細はexample 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. http://hostname:3000でMetabaseにアクセスします。初回起動時にはウェルカム画面が表示され、一連の質問に答える必要があります。データベースの選択を求められた場合は、"後でデータを追加します"を選択します：

3. MetabaseをClickHouseに接続する​

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

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

  3. ドライバーのインストールが成功していれば、データベースタイプのドロップダウンメニューにClickHouseが表示されます：

    ClickHouseが選択肢として表示されるMetabaseのデータベース選択

  4. データベースに表示名を付けます。これはMetabaseの設定であり、好きな名前を使用できます。

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

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

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

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

  1. 右上のコーナーにある管理設定をクリックして管理を終了ボタンをクリックします。

  2. 右上のコーナーにある**+ 新規**メニューをクリックし、質問をしたり、SQLクエリを実行したり、ダッシュボードを作成したりできることに気づきます：

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

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

    UKの価格支払データに対するクエリを表示するMetabaseのSQLエディタ

5. 質問をする​

  1. + 新規をクリックして質問を選択します。データベースとテーブルから質問を構築できることに注意してください。例えば、以下の質問はdefaultデータベースのuk_price_paidというテーブルに対して行われています。以下は、グレーター・マンチェスターの町ごとの平均価格を計算する簡単な質問です：

    UK価格データを使用したMetabaseの質問ビルダーインターフェース

  2. 視覚化ボタンをクリックして、結果を表形式で確認します。

    町ごとの平均価格の表形式の結果を表示するMetabaseの視覚化

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

    グレーター・マンチェスターの町ごとの平均価格のMetabaseの円グラフ視覚化

詳しく知る​

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