ClickHouseとのLuzmo統合

1. ClickHouse接続の設定

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

ホスト、ユーザー名、およびパスワードを提供するよう求められます：

• ホスト: これはあなたのClickHouseデータベースが公開されているホストです。ここでは、データを安全に転送するためにhttpsのみが許可されています。ホストのURLの構造は次のようになります: https://url-to-clickhouse-db:port/database プラグインはデフォルトで'default'データベースと443ポートに接続します。'/'の後にデータベースを指定することで、どのデータベースに接続するかを設定できます。
• ユーザー名: あなたのClickHouseクラスターに接続するために使用されるユーザー名。
• パスワード: あなたのClickHouseクラスターに接続するためのパスワード。

私たちの開発者ドキュメントの例を参照して、私たちのAPIを介してClickHouseへの接続を作成する方法を見つけてください。

2. データセットの追加

ClickHouseに接続したら、こちらで説明されているようにデータセットを追加できます。あなたのClickHouseで利用可能な1つまたは複数のデータセットを選択し、Luzmoでそれらをリンクして、ダッシュボードで一緒に使用できるようにします。また、分析のためのデータ準備に関するこのアーティクルもぜひご覧ください。

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

データセットを使用して、美しい（埋め込み）ダッシュボードを作成したり、クライアントの質問に答えることができるAIデータアナリスト（Luzmo IQ）を動かしたりすることができます。

使用上の注意

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

2. Distributedテーブルエンジンを使用する場合、distributed_product_modeがdenyであると、一部のLuzmoチャートが失敗することがあります。これは、テーブルを別のテーブルにリンクして、そのリンクをチャートで使用する場合にのみ発生するべきです。その場合は、ClickHouseクラスター内で自分に適した他のオプションにdistributed_product_modeを設定してください。ClickHouse Cloudを使用している場合、この設定は無視しても安全です。

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

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