> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Metabaseは、データについて手軽に質問できる、使いやすいオープンソースのUIツールです。
# MetabaseをClickHouseに接続する
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
Metabase は、データについて手軽に分析や質問ができる、使いやすいオープンソースの UI ツールです。Metabase は Java アプリケーションで、JAR ファイルをダウンロードし、`java -jar metabase.jar` を実行するだけで起動できます。Metabase は、ダウンロードして `plugins` フォルダーに配置した JDBC ドライバー を使って ClickHouse に接続します。
## 目的
このガイドでは、Metabase を使って ClickHouse のデータにいくつか質問し、その結果を可視化します。表示結果の 1 つは次のようになります。
**データを追加する**
使用できるデータセットがない場合は、サンプルの 1 つを追加できます。このガイドでは [UK Price Paid](/ja/get-started/sample-datasets/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](https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest) からダウンロードします。
3. `clickhouse.metabase-driver.jar` を `plugins` フォルダーに保存します。
4. ドライバーが正しく読み込まれるように、Metabase を起動または再起動します。
5. [http://hostname:3000](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 のドキュメントをご覧ください。