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

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、TLSを使用しない場合は8123です。

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

  • USERNAMEとPASSWORD: デフォルトでは、ユーザー名はdefaultです。ご利用のケースに適したユーザー名を使用してください。

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

ClickHouse Cloud service connect button

HTTPSを選択すると、詳細が例のcurlコマンドで提供されます。

ClickHouse Cloud HTTPS connection details

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

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

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

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

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

    • Zing Data で ClickHouse データに対話するには、データソース を定義する必要があります。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. サンプルチャートは次のようになります。質問は三点リーダーメニューを使用して保存できます。チャートにコメントを追加したり、チームメンバーをタグ付けしたり、リアルタイムアラートを作成したり、チャートの種類を変更したりできます。

    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