LuzmoをClickHouseと統合する

Community Maintained

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に接続を作成する方法については、開発者ドキュメントの例を参照してください。ClickHouseへの接続を作成する。

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

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

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

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

使用上の注意

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

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

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

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

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