> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Zing Data は、iOS、Android、ウェブ向けに作られた、ClickHouse 用のシンプルなソーシャルビジネスインテリジェンスです。

# Zing Data を 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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<a href="https://www.zingdata.com/" target="_blank">Zing Data</a> は、データ探索と可視化のためのプラットフォームです。Zing Data は、ClickHouse が提供する JS ドライバーを使用して ClickHouse に接続します。

<div id="how-to-connect">
  ## 接続方法
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" size="md" alt="ClickHouse Cloud サービスの接続ボタン" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" size="md" alt="ClickHouse Cloud HTTPS 接続情報" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

2. Zing Dataをダウンロードするか、アクセスします

   * モバイルでClickHouseをZing Dataと一緒に使用するには、[Google Play Store](https://play.google.com/store/apps/details?id=com.getzingdata.android) または [Apple App Store](https://apps.apple.com/us/app/zing-data-collaborative-bi/id1563294091) からZing Dataアプリをダウンロードします。

   * WebでClickHouseをZing Dataと一緒に使用するには、[Zing Webコンソール](https://console.getzingdata.com/) にアクセスしてアカウントを作成します。

3. データソースを追加します

   * Zing DataでClickHouseのデータを操作するには、***データソース*** を定義する必要があります。Zing Dataのモバイルアプリメニューで **Sources** を選択し、**Add a Datasource** をクリックします。

   * Webでデータソースを追加するには、上部メニューの **Data Sources** をクリックし、**New Datasource** をクリックして、ドロップダウンメニューから **ClickHouse** を選択します

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_01.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=7fb5a2b7fd87172386ec50a50c8ee1e2" alt="New Datasourceボタンと、ドロップダウンメニュー内のClickHouseオプションが表示されたZing Dataのインターフェイス" border width="2420" height="278" data-path="images/integrations/data-visualization/zing_01.png" />

   <br />

4. 接続情報を入力し、**Check Connection** をクリックします。

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_02.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=a7be494629d23d432a96b749c0e22566" alt="server、port、database、username、passwordのフィールドが表示された、Zing DataのClickHouse接続設定フォーム" border width="2242" height="2210" data-path="images/integrations/data-visualization/zing_02.png" />

   <br />

5. 接続が成功すると、Zingはテーブル選択画面に進みます。必要なテーブルを選択して **Save** をクリックします。Zingがデータソースに接続できない場合は、認証情報を確認して再試行するよう求めるメッセージが表示されます。認証情報を確認して再試行しても問題が解決しない場合は、<a id="contact_link" href="mailto:hello@getzingdata.com">こちらからZingサポートにお問い合わせください。</a>

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_03.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=f15734c9b26e823f8c396ec2eecb3e15" alt="利用可能なClickHouseテーブルがチェックボックス付きで表示された、Zing Dataのテーブル選択インターフェイス" border width="2248" height="1232" data-path="images/integrations/data-visualization/zing_03.png" />

   <br />

6. ClickHouseデータソースを追加すると、Zing組織内の全員が **Data Sources** / **Sources** タブで利用できるようになります。

<div id="creating-charts-and-dashboards-in-zing-data">
  ## Zing Data でチャートとダッシュボードを作成する
</div>

1. ClickHouse データソースを追加したら、Web では **Zing App** をクリックし、モバイルではデータソースをタップして、チャートの作成を開始します。

2. チャートを作成するには、テーブル一覧からテーブルをクリックします。

   <Image size="sm" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_04.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=fe2c639c0a0f2c42bcf0a9cd871e3c66" alt="利用可能な ClickHouse テーブルを含むテーブル一覧を表示している Zing Data インターフェイス" border width="836" height="422" data-path="images/integrations/data-visualization/zing_04.png" />

   <br />

3. ビジュアルクエリビルダーを使用して、必要なフィールドや集計などを選択し、**Run Question** をクリックします。

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_05.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=1a6f9fe6c73999e8422a5d88745d3c55" alt="フィールド選択と集計オプションを備えた Zing Data のビジュアルクエリビルダーインターフェイス" border width="2624" height="1734" data-path="images/integrations/data-visualization/zing_05.png" />

   <br />

4. SQL に慣れている場合は、カスタム SQL を記述してクエリを実行し、チャートを作成することもできます。

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_06.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=68ad3961bfe1cf9ab2bbddc49ea0e60d" alt="SQL クエリ記述インターフェイスを表示している Zing Data の SQL エディタモード" border width="2636" height="140" data-path="images/integrations/data-visualization/zing_06.png" />

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_07.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=1740d0de0d38a74ecd3f21b94ffa48b2" alt="表形式でデータが表示された Zing Data の SQL クエリ結果" border width="2632" height="1030" data-path="images/integrations/data-visualization/zing_07.png" />

5. チャートの例は次のとおりです。作成したクエリは三点メニューから保存できます。また、チャートにコメントしたり、チームメンバーにタグを付けたり、リアルタイムアラートを作成したり、チャートの種類を変更したりできます。

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_08.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=dc6be47919f4cb9adcdf1cd90c5aed25" alt="オプションメニュー付きで ClickHouse のデータを表示している Zing Data のチャート例" border width="2634" height="1252" data-path="images/integrations/data-visualization/zing_08.png" />

   <br />

6. ダッシュボードは、ホーム画面の **Dashboards** の下にある「+」アイコンから作成できます。既存のクエリはドラッグしてダッシュボードに表示できます。

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/SuhGaqX11zhHEe0p/images/integrations/data-visualization/zing_09.png?fit=max&auto=format&n=SuhGaqX11zhHEe0p&q=85&s=98bd88e53ecc37204c4eef2f76aa50e2" alt="ダッシュボードレイアウトに複数の可視化が配置された Zing Data のダッシュボードビュー" border width="2606" height="764" data-path="images/integrations/data-visualization/zing_09.png" />

   <br />

<div id="related-content">
  ## 関連コンテンツ
</div>

* [ドキュメント](https://docs.getzingdata.com/docs/)
* [クイックスタート](https://getzingdata.com/quickstart/)
* [ダッシュボードの作成](https://getzingdata.com/blog/new-feature-create-multi-question-dashboards/)ガイド
