> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.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 = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
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) データセットを使用しているので、それを選ぶとよいでしょう。同じドキュメントカテゴリには、ほかにもいくつかあります。
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 管理者によって設定されます。
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**」を選択します。
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** ボタンをクリックして、可視化 を棒グラフ (または利用可能な他のオプション) に変更します。
## 詳細情報
Metabase の詳細やダッシュボードの作成方法については、Metabase のドキュメントをご覧ください。
