> ## 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.

> Databrain は、ClickHouse とシームレスに連携し、顧客向けのダッシュボード、メトリクス、データの可視化を構築できる組み込み型分析プラットフォームです。

# Databrain を ClickHouse に接続する

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            コミュニティ管理
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

[Databrain](https://usedatabrain.com) は埋め込み型分析プラットフォームで、顧客向けにインタラクティブなダッシュボード、メトリクス、データの可視化を構築して共有できます。Databrain は HTTPS インターフェイスを使用して ClickHouse に接続するため、モダンで使いやすいインターフェイスで ClickHouse のデータを簡単に可視化し、分析できます。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_01.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=fbd9fa67d77d18f8a224b237e7c8ddaa" alt="ClickHouse のデータ可視化を表示する Databrain のダッシュボードインターフェイス" border width="3408" height="1820" data-path="images/integrations/data-visualization/databrain_01.webp" />

<br />

このガイドでは、Databrain を ClickHouse インスタンスに接続する手順を説明します。

<div id="pre-requisites">
  ## 前提条件
</div>

* ご自身のインフラストラクチャ上、または [ClickHouse Cloud](https://clickhouse.com/) でホストされている ClickHouse データベース。
* [Databrain アカウント](https://app.usedatabrain.com/users/sign-up)。
* データソースを接続するための Databrain ワークスペース。

<div id="steps-to-connect-databrain-to-clickhouse">
  ## Databrain を ClickHouse に接続する手順
</div>

<div id="1-gather-your-connection-details">
  ### 1. 接続情報を確認する
</div>

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** をクリックします。

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" size="md" alt="ClickHouse Cloud サービスの接続ボタン" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

**HTTPS** を選択します。接続情報は `curl` コマンドの例として表示されます。

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="ClickHouse Cloud HTTPS 接続情報" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

<div id="2-allow-databrain-ip-addresses">
  ### 2. Databrain の IP アドレスを許可する (必要な場合)
</div>

ClickHouse インスタンスで IP フィルタリングが有効になっている場合は、Databrain の IP アドレスを許可リストに追加する必要があります。

ClickHouse Cloud ユーザーの場合:

1. ClickHouse Cloud console で対象のサービスに移動します
2. **Settings** → **Security** を開きます
3. Databrain の IP アドレスを許可リストに追加します

<Tip>
  許可リストに追加する最新の IP アドレス一覧については、[Databrain の IP ホワイトリストに関するドキュメント](https://docs.usedatabrain.com/guides/datasources/allow-access-to-our-ip)を参照してください。
</Tip>

<div id="3-add-clickhouse-as-a-data-source">
  ### 3. DatabrainでClickHouseをデータソースとして追加する
</div>

1. Databrainアカウントにログインし、データソースを追加するワークスペースに移動します。

2. ナビゲーションメニューで**Data Sources**をクリックします。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_02.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=bc07a26ef4c913c70e2224543c010fde" alt="Databrainのデータソースメニュー" border width="3420" height="1830" data-path="images/integrations/data-visualization/databrain_02.webp" />

3. **Add a Data Source**または**Connect Data Source**をクリックします。

4. 利用可能なコネクタの一覧から**ClickHouse**を選択します。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_03.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=36f67acbc3a08c6af32258b0e5678db2" alt="ClickHouseオプションが表示されたDatabrainのコネクタ選択画面" border width="1920" height="917" data-path="images/integrations/data-visualization/databrain_03.webp" />

5. 接続情報を入力します。
   * **Destination Name**: この接続を識別しやすい名前を入力します (例: "Production ClickHouse" または "Analytics DB")
   * **Host**: ClickHouseホストのURLを入力します (例: `https://your-instance.region.aws.clickhouse.cloud`)
   * **Port**: `8443`を入力します (ClickHouseのデフォルトのHTTPSポート)
   * **Username**: ClickHouseのユーザー名を入力します
   * **Password**: ClickHouseのパスワードを入力します

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_04.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=8de8629878fec2d481b2530eb4d67ba9" alt="設定フィールドが表示されたDatabrainのClickHouse接続フォーム" border width="1917" height="914" data-path="images/integrations/data-visualization/databrain_04.webp" />

6. **Test Connection**をクリックし、DatabrainがClickHouseインスタンスに接続できることを確認します。

7. 接続に成功したら、**Save**または**Connect**をクリックしてデータソースを追加します。

<div id="4-configure-user-permissions">
  ### 4. ユーザー権限を設定する
</div>

接続に使用する ClickHouse ユーザーに必要な権限が付与されていることを確認してください。

```sql theme={null}
-- スキーマ情報を読み取るための権限を付与する
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- データベースとテーブルへの読み取りアクセスを付与する
GRANT SELECT ON your_database.* TO your_databrain_user;
```

`your_databrain_user` と `your_database` を、実際のユーザー名とデータベース名に置き換えてください。

<div id="using-databrain-with-clickhouse">
  ## ClickHouse で Databrain を使う
</div>

<div id="explore-your-data">
  ### データを確認する
</div>

1. 接続したら、Databrain のワークスペースに移動します。

2. データエクスプローラーに ClickHouse のテーブル一覧が表示されます。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_05.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=1f160f054eb7b97b7bfe32f5c02283e6" alt="ClickHouse のテーブル一覧を表示する Databrain のデータエクスプローラー" border width="1919" height="920" data-path="images/integrations/data-visualization/databrain_05.webp" />

3. テーブルをクリックすると、スキーマを確認したり、データをプレビューしたりできます。

<div id="create-metrics-and-visualizations">
  ### メトリクスと可視化を作成する
</div>

1. **Create Metric** をクリックして、ClickHouse のデータから可視化の作成を開始します。

2. ClickHouse のデータソースを選択し、可視化するテーブルを選びます。

3. Databrain の直感的なインターフェイスを使って、次の操作を行えます。
   * 次元とメジャーを選択する
   * フィルターと集計を適用する
   * 可視化タイプ (棒グラフ、折れ線グラフ、円グラフ、テーブルなど) を選択する
   * 高度な分析のためにカスタム SQL クエリを追加する

4. メトリクスを保存して、複数のダッシュボードで再利用できます。

<div id="build-dashboards">
  ### ダッシュボードを作成する
</div>

1. **Create Dashboard** をクリックして、ダッシュボードの作成を始めます。

2. 保存済みのメトリクスをドラッグ＆ドロップして、ダッシュボードに追加します。

3. ダッシュボードのレイアウトや外観をカスタマイズします。

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/databrain_06.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=c215e38acb4d6e9edaa988338d268969" alt="複数の ClickHouse 可視化を含む Databrain ダッシュボード" border width="1918" height="888" data-path="images/integrations/data-visualization/databrain_06.webp" />

4. ダッシュボードをチームで共有したり、アプリケーションに埋め込んだりできます。

<div id="advanced-features">
  ### 高度な機能
</div>

Databrain では、ClickHouse と連携する際にいくつかの高度な機能を利用できます。

* **Custom SQL Console**: ClickHouse データベースに対してカスタム SQL クエリを直接記述して実行できます
* **マルチテナンシーとシングルテナンシー**: シングルテナント構成とマルチテナント構成の両方で ClickHouse データベースを接続できます
* **レポートのスケジュール設定**: 自動レポートをスケジュールし、関係者にメールで送信できます
* **AI を活用したインサイト**: AI を使用してデータから要約やインサイトを生成できます
* **Embedded Analytics**: ダッシュボードとメトリクスをアプリケーションに直接埋め込めます
* **セマンティックレイヤー**: 再利用可能なデータモデルとビジネスロジックを作成できます

<div id="troubleshooting">
  ## トラブルシューティング
</div>

<div id="connection-fails">
  ### 接続できない場合
</div>

ClickHouse に接続できない場合は、次の点を確認してください。

1. **認証情報を確認**: ユーザー名、パスワード、ホスト URL に誤りがないか再確認します
2. **ポートを確認**: HTTPS には `8443` ポートを使用していることを確認します (SSL を使用しない HTTP の場合は `8123`)
3. **IP ホワイトリスト**: Databrain の IP アドレスが ClickHouse のファイアウォールまたはセキュリティ設定で許可されていることを確認します
4. **SSL/TLS**: HTTPS を使用している場合は、SSL/TLS が正しく設定されていることを確認します
5. **ユーザー権限**: ユーザーに `information_schema` と対象データベースに対する SELECT 権限があることを確認します

<div id="slow-query-performance">
  ### クエリのパフォーマンスが低い場合
</div>

クエリの実行が遅い場合:

1. **クエリを最適化する**: フィルターと集計を効率的に活用します
2. **materialized view を作成する**: 頻繁に参照される集計については、ClickHouse で materialized view を作成することを検討してください
3. **適切なデータ型を使用する**: ClickHouse のスキーマで最適なデータ型を使用していることを確認します
4. **索引を最適化する**: ClickHouse の主キーとスキッピング索引を活用します

<div id="learn-more">
  ## 詳しく知る
</div>

Databrain の機能や、高度な分析を構築する方法について詳しくは、以下をご覧ください。

* [Databrain ドキュメント](https://docs.usedatabrain.com/)
* [ClickHouse 連携ガイド](https://docs.usedatabrain.com/guides/datasources/connecting-data-sources-to-databrain/clickhouse)
* [ダッシュボードの作成](https://docs.usedatabrain.com/guides/dashboards/create-a-dashboard)
* [メトリクスの構築](https://docs.usedatabrain.com/guides/metrics/create-metrics)