> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Luzmo は、ソフトウェアおよび SaaS アプリケーション向けに設計された、ClickHouse とネイティブに連携できる埋め込み型分析プラットフォームです。

# Luzmo と ClickHouse の連携

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            コミュニティ管理
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

<Steps>
  <Step title="ClickHouse 接続を設定する" id="1-setup-a-clickhouse-connection">
    ClickHouse に接続するには、**Connections page** に移動し、**New Connection** を選択してから、New Connection モーダルで ClickHouse を選択します。

    <Image img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/luzmo_01.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=967e6102cd8c64b737019bc319980003" size="md" alt="ClickHouse が選択された Create a New Connection ダイアログを表示する Luzmo インターフェイス" border width="720" height="497" data-path="images/integrations/data-visualization/luzmo_01.webp" />

    **host**、**username**、**password** の入力が求められます。

    <Image img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/luzmo_02.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=0441f2efee476fc353d914bc808a73e8" size="md" alt="ClickHouse の host、username、password のフィールドが表示された Luzmo の接続設定フォーム" border width="462" height="454" data-path="images/integrations/data-visualization/luzmo_02.webp" />

    * **Host**: これは、ClickHouse データベースが公開されているホストです。データを安全に転送するため、ここでは `https` のみ使用できます。host URL は次の形式を想定しています: `https://url-to-clickhouse-db:port/database`
      デフォルトでは、プラグインは 'default' データベースの 443 ポートに接続します。'/' の後にデータベースを指定すると、接続先のデータベースを設定できます。
    * **Username**: ClickHouse クラスターへの接続に使用する username です。
    * **Password**: ClickHouse クラスターに接続するための password です

    API 経由で [ClickHouse への接続を作成する](https://developer.luzmo.com/api/createAccount?exampleSection=AccountCreateClickhouseRequestBody) 方法については、開発者向けドキュメントの例を参照してください。
  </Step>

  <Step title="データセットを追加する" id="2-add-datasets">
    ClickHouse に接続したら、[こちら](https://academy.luzmo.com/article/ldx3iltg) の説明に従ってデータセットを追加できます。ClickHouse で利用可能な 1 つ以上のデータセットを選択し、Luzmo でそれらを [リンク](https://academy.luzmo.com/article/gkrx48x5) することで、ダッシュボード内でまとめて使用できるようになります。あわせて、[分析向けにデータを準備する](https://academy.luzmo.com/article/u492qov0) 方法についての記事もご確認ください。

    API を使用してデータセットを追加する方法については、[開発者向けドキュメントのこの例](https://developer.luzmo.com/api/createDataprovider?exampleSection=DataproviderCreateClickhouseRequestBody) を参照してください。

    これで、データセットを使って美しい (埋め込み) ダッシュボードを作成したり、顧客からの質問に答えられる AI データアナリスト ([Luzmo IQ](https://luzmo.com/iq)) を活用したりできます。

    <Image img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/luzmo_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=4b66ae70e426978f43f8d82e1abed64c" size="md" alt="ClickHouse のデータの複数の可視化を表示する Luzmo ダッシュボードの例" border width="956" height="693" data-path="images/integrations/data-visualization/luzmo_03.webp" />
  </Step>
</Steps>

<div id="usage-notes">
  ## 使用上の注意
</div>

1. Luzmo ClickHouse コネクタは、接続に HTTP API インターフェイス (通常はポート 8123 で稼働) を使用します。
2. `Distributed` テーブルエンジンを使用するテーブルを使っている場合、`distributed_product_mode` が `deny` に設定されていると、一部の Luzmo チャートが正常に動作しないことがあります。ただし、これはそのテーブルを別のテーブルにリンクし、そのリンクをチャート内で使用した場合にのみ発生します。その場合は、ClickHouse クラスター内で `distributed_product_mode` を環境に適した別のオプションに設定してください。ClickHouse Cloud を使用している場合は、この設定は無視して問題ありません。
3. たとえば Luzmo アプリケーションのみが ClickHouse インスタンスにアクセスできるようにするには、[Luzmo の静的 IP アドレス範囲](https://academy.luzmo.com/article/u9on8gbm)を**許可リストに追加**することを強く推奨します。また、技術用の読み取り専用ユーザーを使用することも推奨します。
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 |