> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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>;
};

<CommunityMaintainedBadge />

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/databrain_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=80e4fec7929d62f4a07f36d009cd8d37" 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>

<Steps>
  <Step title="接続情報を確認する" id="1-gather-your-connection-details">
    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** をクリックします。

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="ClickHouse Cloud サービスの接続ボタン" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="ClickHouse Cloud HTTPS 接続情報" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="DatabrainのIPアドレスを許可する（必要な場合）" id="2-allow-databrain-ip-addresses">
    ClickHouseインスタンスでIP filteringが有効になっている場合は、DatabrainのIPアドレスをホワイトリストに登録する必要があります。

    ClickHouse Cloudユーザーの場合:

    1. ClickHouse Cloud consoleで対象のserviceを開きます
    2. **Settings** → **Security**に移動します
    3. DatabrainのIPアドレスをallow listに追加します

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

  <Step title="DatabrainでClickHouseをデータソースとして追加する" id="3-add-clickhouse-as-a-data-source">
    1. Databrainアカウントにログインし、データソースを追加するワークスペースに移動します。

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

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/databrain_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=afa8be9262fbc8bace0e29c3446925a8" 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/PWQnWTwcu17exYX2/images/integrations/data-visualization/databrain_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=55c156b47f08a4bc2c9b8e2b2eb50078" 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/PWQnWTwcu17exYX2/images/integrations/data-visualization/databrain_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=b2b574e85c4094bde4df8260aa5a969a" 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**をクリックしてデータソースを追加します。
  </Step>

  <Step title="ユーザー権限を設定する" id="4-configure-user-permissions">
    接続に使用する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`は、実際のusernameおよびDatabase nameに置き換えてください。
  </Step>
</Steps>

<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/PWQnWTwcu17exYX2/images/integrations/data-visualization/databrain_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=5b9a984052f45b47abb2d2e32f0b8479" 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/PWQnWTwcu17exYX2/images/integrations/data-visualization/databrain_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=54ce6587126ab9eb24a8c7a2dac0fac0" 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/getting-started/core-concepts/dashboards)
* [メトリクスの構築](https://docs.usedatabrain.com/getting-started/core-concepts/metrics)