メインコンテンツへスキップ

1. ClickHouse 接続を設定する

ClickHouse に接続するには、Connections page に移動し、New Connection を選択してから、New Connection モーダルで ClickHouse を選択します。 hostusernamepassword の入力が求められます。
  • Host: これは、ClickHouse データベースが公開されているホストです。データを安全に転送するため、ここでは https のみ使用できます。host URL は次の形式を想定しています: https://url-to-clickhouse-db:port/database デフォルトでは、プラグインは ‘default’ データベースの 443 ポートに接続します。’/’ の後にデータベースを指定すると、接続先のデータベースを設定できます。
  • Username: ClickHouse クラスターへの接続に使用する username です。
  • Password: ClickHouse クラスターに接続するための password です
API 経由で ClickHouse への接続を作成する 方法については、開発者向けドキュメントの例を参照してください。

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

ClickHouse への接続が完了したら、こちらで説明されているようにデータセットを追加できます。ClickHouse で利用可能な 1 つ以上のデータセットを選択し、Luzmo でそれらをリンクすることで、ダッシュボード内でまとめて利用できるようになります。あわせて、分析向けにデータを準備する こちらの記事もご確認ください。 API を使用してデータセットを追加する方法については、開発者向けドキュメントのこちらの例を参照してください。 これで、データセットを使って美しい (埋め込み) ダッシュボードを構築したり、クライアントの質問に回答できる AI データアナリスト (Luzmo IQ) を活用したりできるようになります。

使用上の注意

  1. Luzmo ClickHouse コネクタは、接続に HTTP API インターフェイス (通常はポート 8123 で稼働) を使用します。
  2. Distributed テーブルエンジンを使用するテーブルを使っている場合、distributed_product_modedeny に設定されていると、一部の Luzmo チャートが正常に動作しないことがあります。ただし、これはそのテーブルを別のテーブルにリンクし、そのリンクをチャート内で使用した場合にのみ発生します。その場合は、ClickHouse クラスター内で distributed_product_mode を環境に適した別のオプションに設定してください。ClickHouse Cloud を使用している場合は、この設定は無視して問題ありません。
  3. たとえば Luzmo アプリケーションのみが ClickHouse インスタンスにアクセスできるようにするには、Luzmo の静的 IP アドレス範囲許可リストに追加することを強く推奨します。また、技術用の読み取り専用ユーザーを使用することも推奨します。
  4. ClickHouse コネクタは現在、次のデータ型をサポートしています。
最終更新日 2026年6月25日