メインコンテンツまでスキップ
メインコンテンツまでスキップ

Connect Zing Data to ClickHouse

Community Maintained

Zing Data はデータ探索および可視化プラットフォームです。Zing Data は ClickHouse の提供する JS ドライバーを使用して ClickHouse に接続します。

How to connect

  1. 接続詳細を収集します。

To connect to ClickHouse with HTTP(S) you need this information:

  • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

  • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

  • The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS, and the details are available in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.


以下は、ClickHouseにHTTP(S)で接続するために必要な情報です:

  • HOSTとPORT: 通常、TLSを使用する場合はポートが8443、使用しない場合は8123です。

  • DATABASE NAME: デフォルトでは、defaultという名前のデータベースがあります。接続したいデータベースの名前を使用します。

  • USERNAMEとPASSWORD: デフォルトでは、ユーザー名はdefaultです。使用ケースに適したユーザー名を使用します。

ClickHouse Cloudサービスの詳細は、ClickHouse Cloudコンソールで確認できます。 接続するサービスを選択し、Connectをクリックしてください:

ClickHouse Cloud service connect button

HTTPSを選択すると、詳細はexample curlコマンドで確認できます。

ClickHouse Cloud HTTPS connection details

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

  1. Zing Data をダウンロードまたは訪問します。

    • モバイルで Zing Data と Clickhouse を使用するには、Google Play Store または Apple App Store から Zing Data アプリをダウンロードします。

    • ウェブで Zing Data と Clickhouse を使用するには、Zing ウェブコンソール にアクセスし、アカウントを作成します。

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

    • Zing Data で ClickHouse データと対話するには、datasource を定義する必要があります。Zing Data のモバイルアプリメニューで Sources を選択し、次に Add a Datasource をクリックします。

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

    Zing Data interface showing New Datasource button and ClickHouse option in the dropdown menu

  3. 接続詳細を入力し、Check Connection をクリックします。

    ClickHouse connection configuration form in Zing Data with fields for server, port, database, username and password

  4. 接続が成功した場合、Zing はテーブル選択に進みます。必要なテーブルを選択し、Save をクリックします。Zing がデータソースに接続できない場合は、認証情報を確認して再試行するように求めるメッセージが表示されます。認証情報を確認して再試行してもなお問題が発生する場合は、こちらから Zing サポートにお問い合わせください。

    Zing Data table selection interface showing available ClickHouse tables with checkboxes

  5. Clickhouse データソースが追加されると、あなたの Zing 組織内の全員が Data Sources / Sources タブで利用できるようになります。

Creating charts and dashboards in Zing Data

  1. Clickhouse データソースが追加された後、ウェブで Zing App をクリックするか、モバイルでデータソースをクリックしてチャートを作成します。

  2. チャートを作成するには、テーブルのリストの下にあるテーブルをクリックします。

    Zing Data interface showing the table list with available ClickHouse tables

  3. ビジュアルクエリビルダーを使用して、希望するフィールド、集約などを選択し、Run Question をクリックします。

    Zing Data visual query builder interface with field selection and aggregation options

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

    SQL editor mode in Zing Data showing SQL query writing interface
    SQL query results in Zing Data with data displayed in tabular format
  5. 例として、チャートは以下のようになります。質問は3点メニューを使用して保存できます。チャートにコメントを付けたり、チームメンバーにタグを付けたり、リアルタイムアラートを作成したり、チャートの種類を変更したりできます。

    Example chart visualization in Zing Data showing data from ClickHouse with options menu

  6. ダッシュボードは、ホーム画面の Dashboards の下にある "+" アイコンを使用して作成できます。既存の質問をドラッグしてダッシュボードに表示できます。

    Zing Data dashboard view showing multiple visualizations arranged in a dashboard layout