Luzmo と ClickHouse の連携

Community Maintained

1. ClickHouse 接続をセットアップする

ClickHouse に接続するには、Connections ページに移動し、New Connection を選択してから、「New Connection」モーダルで ClickHouse を選択します。

host、username、password を入力するよう求められます:

• Host: ClickHouse データベースが公開されているホストです。通信を安全に行うため、ここでは https のみが許可されています。ホスト URL の構造は次の形式になります: https://url-to-clickhouse-db:port/database デフォルトでは、プラグインは default データベースおよびポート 443 に接続します。/ の後ろにデータベース名を指定することで、接続先のデータベースを変更できます。
• Username: ClickHouse クラスターへの接続に使用するユーザー名です。
• Password: ClickHouse クラスターへの接続に使用するパスワードです。

API 経由でClickHouse への接続を作成する方法については、開発者向けドキュメントのサンプルを参照してください。

2. データセットを追加する

ClickHouse への接続が完了したら、こちらの記事で説明されている手順に従ってデータセットを追加できます。ClickHouse で利用可能な 1 つまたは複数のデータセットを選択し、Luzmo 内でリンクすることで、ダッシュボード内で組み合わせて利用できるようにします。また、分析のためのデータ準備に関するこの記事も必ず確認してください。

API を使用してデータセットを追加する方法については、開発者ドキュメント内のこのサンプルを参照してください。

これで、データセットを使用して美しい（埋め込み型）ダッシュボードを構築したり、クライアントの質問に回答できる AI Data Analyst（Luzmo IQ）を活用したりできます。

使用上の注意事項

1. Luzmo ClickHouse コネクタは、接続のために HTTP API インターフェース（通常ポート 8123 で稼働）を使用します。

2. Distributed テーブルエンジンを使用している場合、distributed_product_mode が deny に設定されていると、一部の Luzmo チャートが失敗する可能性があります。ただし、これはテーブルを別のテーブルにリンクし、そのリンクをチャート内で使用している場合にのみ発生します。その場合は、ClickHouse クラスター内で要件に合致する別のオプションに distributed_product_mode を設定してください。ClickHouse Cloud を使用している場合は、この設定は無視しても問題ありません。

3. 例えば Luzmo アプリケーションのみが ClickHouse インスタンスにアクセスできるようにするために、ホワイトリストとして Luzmo の静的 IP アドレス範囲 を登録することを強く推奨します。また、技術的な読み取り専用 USER を使用することも推奨します。

4. ClickHouse コネクタは現在、以下のデータ型をサポートしています:

   ClickHouse Type	Luzmo Type
   UInt	numeric
   Int	numeric
   Float	numeric
   Decimal	numeric
   Date	datetime
   DateTime	datetime
   String	hierarchy
   Enum	hierarchy
   FixedString	hierarchy
   UUID	hierarchy
   Bool	hierarchy