Chartbrew を ClickHouse に接続する

Community Maintained

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

目標

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

データを追加

作業に使えるデータセットがない場合は、サンプルを追加できます。このガイドでは、UK Price Paid データセットを使用します。

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

HTTPS を選択します。接続情報は、サンプルの curl コマンド内に表示されます。

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

2. Chartbrew を ClickHouse に接続する

1. Chartbrew にログインし、Connections タブを開きます。

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

   

3. ClickHouse データベースへの接続情報を入力します。

   • Display Name: Chartbrew 内でこの接続を識別するための名前。
   • Host: ClickHouse サーバーのホスト名または IP アドレス。
   • Port: HTTPS 接続の場合は通常 8443。
   • Database Name: 接続したいデータベース名。
   • Username: ClickHouse のユーザー名。
   • Password: ClickHouse のパスワード。
   

4. Test connection をクリックして、Chartbrew から ClickHouse に接続できることを確認します。

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

   

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

1. Create dataset ボタンをクリックするか、Datasets タブに移動して新しいデータセットを作成します。
2. 先ほど作成した ClickHouse 接続を選択します。

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

  SELECT toYear(date) AS year, avg(price) AS avg_price
  FROM uk_price_paid
  GROUP BY year
  ORDER BY year;

データを取得するために Run query ボタンをクリックします。

クエリの書き方に迷う場合は、データベーススキーマに基づいて SQL クエリを生成できる Chartbrew の AI アシスタント を利用できます。

データが取得できたら、可視化パラメータを設定するために Configure dataset ボタンをクリックします。

4. 可視化を作成する

1. 可視化用に、メトリック（数値）とディメンション（カテゴリ値）を定義します。
2. データセットをプレビューして、クエリ結果の構造が正しいことを確認します。
3. チャートの種類（例: 折れ線グラフ、棒グラフ、円グラフ）を選択し、ダッシュボードに追加します。
4. Complete dataset をクリックしてセットアップを完了します。

データのさまざまな側面を可視化するために、必要なだけデータセットを作成できます。これらのデータセットを使って複数のダッシュボードを作成し、異なるメトリックを継続的に追跡できます。

5. データ更新を自動化する

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

1. データセットの更新ボタンの横にあるカレンダーアイコンをクリックします。
2. 更新間隔を設定します（例: 毎時、毎日）。
3. 設定を保存して自動更新を有効にします。

さらに詳しく知る

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