> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Apache Superset は、オープンソースのデータ探索・可視化プラットフォームです。
# Superset を ClickHouse に接続
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Apache Superset は、Python 製のオープンソースのデータ探索・可視化プラットフォームです。Superset は、ClickHouse が提供する Python ドライバーを使用して ClickHouse に接続します。では、その仕組みを見ていきましょう...
## 目標
このガイドでは、ClickHouse データベースのデータを使って Superset でダッシュボードを作成します。ダッシュボードは次のようになります。
**データを追加する**
使用するデータセットがない場合は、例のいずれかを追加できます。このガイドでは [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. ドライバーをインストールする
1. Superset は ClickHouse に接続するために `clickhouse-connect` ドライバーを使用します。`clickhouse-connect` の詳細は [https://pypi.org/project/clickhouse-connect/](https://pypi.org/project/clickhouse-connect/) を参照してください。インストールには次のコマンドを実行します。
```console theme={null}
pip install clickhouse-connect
```
**Docker Compose のセットアップ**
Docker ベースのインストールの場合、コンテナーに `clickhouse-connect` を追加する手順については、[Superset database configuration guide](https://superset.apache.org/docs/configuration/databases/#clickhouse) を参照してください。
2. Superset を起動します (または再起動します) 。
## 3. Superset を ClickHouse に接続する
1. Superset で、上部メニューから **Data** を選択し、次にドロップダウンメニューから **Databases** を選択します。**+ Database** ボタンをクリックして、新しいデータベースを追加します。
2. 最初のステップで、データベースの種類として **ClickHouse Connect** を選択します。
3. 2 番目のステップでは、以下を行います。
* SSL をオンまたはオフに設定します。
* 先ほど収集した接続情報を入力します。
* **DISPLAY NAME** を指定します。これは任意の名前で構いません。複数の ClickHouse データベースに接続する場合は、よりわかりやすい名前にしてください。
4. **CONNECT** をクリックし、続けて **FINISH** ボタンをクリックしてセットアップウィザードを完了します。完了すると、データベースの一覧に追加したデータベースが表示されます。
## 4. データセットを追加する
1. Superset で ClickHouse のデータを操作するには、***データセット*** を定義する必要があります。Superset の上部メニューで **Data** を選択し、ドロップダウンメニューから **Datasets** を選択します。
2. データセットを追加するボタンをクリックします。新しく作成したデータベースをデータソースとして選択すると、そのデータベースで定義したテーブルが表示されます。
3. ダイアログウィンドウの下部にある **ADD** ボタンをクリックすると、テーブルがデータセットの一覧に表示されます。これでダッシュボードを作成し、ClickHouse のデータを分析する準備は完了です。
## 5. Superset でチャートとダッシュボードを作成する
Superset に慣れているなら、この次のセクションもすぐに理解できるはずです。Superset を初めて使う場合でも、まあ……世の中にある多くの優れた可視化ツールと同じです。使い始めるのは簡単ですが、細かな違いやコツは、実際に使いながら少しずつ身についていきます。
1. まずはダッシュボードから始めます。Superset の上部メニューで **Dashboards** を選択します。右上のボタンをクリックして、新しいダッシュボードを追加します。以下のダッシュボード名は **UK property prices** です。
2. 新しいチャートを作成するには、上部メニューから **Charts** を選択し、新しいチャートを追加するボタンをクリックします。多数のオプションが表示されます。次の例では、**CHOOSE A DATASET** ドロップダウンから **uk\_price\_paid** データセットを選び、**Pie Chart** チャートを使用しています。
3. Superset の円グラフでは **Dimension** と **Metric** が必要で、それ以外の設定は任意です。Dimension と Metric には任意のフィールドを選べます。この例では、ClickHouse のフィールド `district` を Dimension、`AVG(price)` を Metric としています。
5. 円グラフではなくドーナツチャートにしたい場合は、**CUSTOMIZE** でそのほかのオプションとあわせて設定できます。
6. **SAVE** ボタンをクリックしてチャートを保存し、次に **ADD TO DASHBOARD** ドロップダウンで **UK property prices** を選択します。その後、**SAVE & GO TO DASHBOARD** をクリックすると、チャートが保存され、ダッシュボードに追加されます。
7. 以上です。ClickHouse のデータを基に Superset でダッシュボードを構築すれば、超高速なデータ分析の世界が大きく広がります。