LuzmoをClickHouseに統合する
1. ClickHouse接続の設定
ClickHouseに接続するには、Connectionsページに移動し、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）を活用したりできます。
使用上の注意
-
LuzmoのClickHouseコネクタは、HTTP APIインターフェース（通常はポート8123で実行）を使用して接続します。
-
Distributedテーブルエンジンを使用しているテーブルの場合、distributed_product_modeがdenyのときに一部のLuzmoチャートが失敗することがあります。ただし、これはテーブルを別のテーブルにリンクさせ、そのリンクをチャートで使用する場合にのみ発生します。その場合、ClickHouseクラスター内であなたに合った別のオプションにdistributed_product_modeを設定してください。ClickHouse Cloudを使用している場合、この設定は無視しても安全です。 -
例えばLuzmoアプリケーションのみがあなたのClickHouseインスタンスにアクセスできるようにするために、Luzmoの静的IPアドレスの範囲をホワイトリストに追加することを強く推奨します。また、技術的な読み取り専用ユーザーの使用も推奨します。
-
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
