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

ChartbrewをClickHouseに接続する

Community Maintained

Chartbrewは、ユーザーがダッシュボードを作成し、リアルタイムでデータを監視できるデータ可視化プラットフォームです。ClickHouseを含む複数のデータソースをサポートしており、チャートやレポートを作成するためのノーコードインターフェースを提供します。

目標

このガイドでは、ChartbrewをClickHouseに接続し、SQLクエリを実行し、視覚化を作成します。最後には、あなたのダッシュボードは次のようになるかもしれません:

Chartbrewダッシュボード
データを追加する

作業するデータセットがない場合は、例の一つを追加できます。このガイドでは、UK Price Paidデータセットを使用します。

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の管理者によって設定されます。

2. ChartbrewをClickHouseに接続する

  1. Chartbrewにログインし、Connectionsタブに移動します。

  2. Create connectionをクリックし、利用可能なデータベースオプションからClickHouseを選択します。

    ChartbrewでClickHouse接続を選択
  3. ClickHouseデータベースの接続情報を入力します:

    • Display Name: Chartbrew内で接続を識別するための名前。
    • Host: ClickHouseサーバーのホスト名またはIPアドレス。
    • Port: 通常はHTTPS接続のために8443
    • Database Name: 接続したいデータベース。
    • Username: あなたのClickHouseユーザー名。
    • Password: あなたのClickHouseパスワード。
    ChartbrewでのClickHouse接続設定
  4. Test connectionをクリックして、ChartbrewがClickHouseに接続できるか確認します。

  5. テストが成功した場合は、Save connectionをクリックします。ChartbrewはClickHouseからスキーマを自動的に取得します。

    ChartbrewのClickHouse JSONスキーマ

3. データセットを作成し、SQLクエリを実行する

  1. Create datasetボタンをクリックするか、Datasetsタブに移動して作成します。

  2. 前に作成したClickHouse接続を選択します。

    データセット用のClickHouse接続を選択

可視化するデータを取得するためのSQLクエリを書きます。たとえば、このクエリはuk_price_paidデータセットから年ごとの平均支払価格を計算します:

ChartbrewのClickHouse SQLクエリ

Run queryをクリックしてデータを取得します。

クエリの書き方がわからない場合は、ChartbrewのAIアシスタントを使用して、データベーススキーマに基づいたSQLクエリを生成できます。

ChartbrewのClickHouse AI SQLアシスタント

データが取得されたら、Configure datasetをクリックして、視覚化パラメータを設定します。

4. 視覚化を作成する

  1. 視覚化のためのメトリック(数値)とディメンション(カテゴリカル値)を定義します。

  2. データセットをプレビューして、クエリ結果が正しく構造化されていることを確認します。

  3. チャートタイプ(例:折れ線グラフ、棒グラフ、円グラフ)を選択し、それをダッシュボードに追加します。

  4. Complete datasetをクリックして、設定を確定します。

    ClickHouseデータを使用したChartbrewダッシュボード

    データの異なる側面を視覚化するために、希望するだけ多くのデータセットを作成できます。これらのデータセットを使用して、異なるメトリックを管理するための複数のダッシュボードを作成できます。

    ClickHouseデータを使用したChartbrewダッシュボード

5. データの自動更新を設定する

ダッシュボードを最新の状態に保つためには、データの自動更新をスケジュールできます:

  1. データセットの更新ボタンの横にあるカレンダーアイコンをクリックします。

  2. 更新間隔を設定します(例:毎時、毎日)。

  3. 設定を保存して、自動更新を有効にします。

    Chartbrewデータセット更新設定

もっと学ぶ

詳細については、ChartbrewとClickHouseに関するブログ記事をご覧ください。