> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Mitzu は、ノーコードのウェアハウスネイティブなプロダクトアナリティクスアプリケーションです。

# Mitzu を 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>;
};

Mitzu は、ノーコードのウェアハウスネイティブなプロダクトアナリティクスアプリケーションです。Amplitude、Mixpanel、PostHog のようなツールと同様に、SQL や Python の専門知識がなくてもプロダクト利用データを分析できます。

ただし、これらのプラットフォームとは異なり、Mitzu は企業のプロダクト利用データを複製しません。代わりに、企業の既存のデータウェアハウスやデータレイクに対して、ネイティブ SQL クエリを直接生成します。

<div id="goal">
  ## 目標
</div>

このガイドでは、以下の内容を説明します。

* ウェアハウスネイティブなプロダクトアナリティクス
* Mitzu を ClickHouse と統合する方法

<Tip>
  **サンプルデータセット**

  Mitzu で使用できるデータセットがない場合は、NYC Taxi Data を利用できます。
  このデータセットは ClickHouse Cloud で利用できるほか、[こちらの手順](/ja/get-started/sample-datasets/nyc-taxi)に従って読み込むこともできます。
</Tip>

このガイドでは、Mitzu の使い方を簡単に紹介します。より詳しい情報については、[Mitzu のドキュメント](https://docs.mitzu.io/)を参照してください。

<div id="1-gather-your-connection-details">
  ## 1. 接続情報を確認する
</div>

HTTP(S) で ClickHouse に接続するには、次の情報が必要です。

| Parameter(s)              | Description                                               |
| ------------------------- | --------------------------------------------------------- |
| `HOST` and `PORT`         | 通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合は 8123 です。           |
| `DATABASE NAME`           | デフォルトでは `default` という名前のデータベースがあります。接続先のデータベース名を使用してください。 |
| `USERNAME` and `PASSWORD` | デフォルトのユーザー名は `default` です。用途に応じたユーザー名を使用してください。           |

ClickHouse Cloud サービスの詳細は、ClickHouse Cloud コンソールで確認できます。
サービスを選択し、**Connect** をクリックします。

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=dd441fc2272e292760011d48e81d43d4" size="md" alt="ClickHouse Cloud サービスの接続ボタン" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

**HTTPS** を選択します。接続情報は `curl` コマンドの例として表示されます。

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=878b1fe94ea520377426f69503e38994" size="md" alt="ClickHouse Cloud HTTPS 接続情報" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

<div id="2-sign-in-or-sign-up-to-mitzu">
  ## 2. Mitzu にサインインまたは新規登録する
</div>

まずは、[https://app.mitzu.io](https://app.mitzu.io) にアクセスして新規登録します。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_01.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=0cff21a5d3627139b41754323f2512cb" alt="メールアドレスとパスワードのフィールドがある Mitzu のサインインページ" border width="1913" height="962" data-path="images/integrations/data-visualization/mitzu_01.webp" />

<div id="3-configure-your-workspace">
  ## 3. ワークスペースを設定する
</div>

組織を作成したら、左側のサイドバーにある `Set up your workspace` オンボーディングガイドに従って設定を進めてください。次に、`Connect Mitzu with your data warehouse` リンクをクリックします。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_02.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=9d1a3a052e4d07c6935d699334fcabbb" alt="オンボーディング手順が表示された Mitzu のワークスペース設定ページ" border width="1919" height="967" data-path="images/integrations/data-visualization/mitzu_02.webp" />

<div id="4-connect-mitzu-to-clickhouse">
  ## 4. Mitzu を ClickHouse に接続する
</div>

まず、接続タイプとして ClickHouse を選択し、接続情報を設定します。続いて、`Test connection & Save` ボタンをクリックして設定を保存します。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_03.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=823b92ee6948a0069726ad5beb148a38" alt="ClickHouse 用の Mitzu 接続設定ページ（設定フォーム付き）" border width="1323" height="850" data-path="images/integrations/data-visualization/mitzu_03.webp" />

<div id="5-configure-event-tables">
  ## 5. イベントテーブルを設定する
</div>

接続を保存したら、`Event tables` タブを選択し、`Add table` ボタンをクリックします。モーダルで、データベースと Mitzu に追加するテーブルを選択します。

チェックボックスを使って少なくとも 1 つのテーブルを選択し、`Configure table` ボタンをクリックします。モーダルウィンドウが開き、各テーブルのキーカラムを設定できます。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_04.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=ca526fdf470095c4a14fcaf1403aeb15" alt="データベーステーブルを表示する Mitzu のテーブル選択インターフェイス" border width="1341" height="885" data-path="images/integrations/data-visualization/mitzu_04.webp" />

<br />

> ClickHouse 環境でプロダクトアナリティクスを実行するには、テーブル内の
> いくつかの重要なキーカラムを指定する必要があります。
>
> 該当するのは次のとおりです。
>
> * **User id** - ユーザーを一意に識別するためのカラム。
> * **Event time** - イベントのタイムスタンプカラム。
> * Optional\[**Event name**] - テーブルに複数のイベントタイプが含まれている場合、このカラムでイベントを分類します。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_05.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=5a26e68db25110015e65ba4ab6eb2d33" alt="カラムマッピングのオプションを表示する Mitzu のイベントカタログ設定" border width="1611" height="693" data-path="images/integrations/data-visualization/mitzu_05.webp" />

<br />

すべてのテーブルの設定が完了したら、`Save & update event catalog` ボタンをクリックします。すると Mitzu が、上で定義したテーブルからすべてのイベントとそのプロパティを検出します。この手順には、データセットのサイズによっては数分かかる場合があります。

<div id="4-run-segmentation-queries">
  ## 4. セグメンテーションクエリを実行する
</div>

Mitzu でのユーザーセグメンテーションは、Amplitude、Mixpanel、PostHog と同じように簡単に行えます。

Explore ページには、左側にイベントの選択エリアがあり、上部では対象期間を設定できます。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_06.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=5b455399fe06f7b12bc468872b44d34b" alt="イベント選択と期間設定を備えた Mitzu のセグメンテーションクエリのインターフェイス" border width="1634" height="873" data-path="images/integrations/data-visualization/mitzu_06.webp" />

<br />

<Tip>
  **フィルターとブレークダウン**

  フィルタリングは一般的な操作と同じです。プロパティ (ClickHouse のカラム) を選択し、ドロップダウンから絞り込みに使う値を選びます。
  ブレークダウンには、任意のイベントプロパティまたはユーザープロパティを使用できます (ユーザープロパティを統合する方法については以下を参照してください) 。
</Tip>

<div id="5-run-funnel-queries">
  ## 5. ファネルクエリを実行する
</div>

ファネルでは最大 9 つのステップを選択できます。ユーザーがファネルを完了するまでの時間枠を選択してください。
SQL コードを 1 行も書かずに、コンバージョン率をすぐに把握できます。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_07.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=4fe4d8c2fd42f4aec3c0587d3b5d1a1b" alt="ステップ間のコンバージョン率を表示する Mitzu のファネル分析ビュー" border width="1630" height="880" data-path="images/integrations/data-visualization/mitzu_07.webp" />

<br />

<Tip>
  **トレンドを可視化する**

  時間の経過に伴うファネルのトレンドを可視化するには、`Funnel trends` を選択します。
</Tip>

<div id="6-run-retention-queries">
  ## 6. リテンションクエリを実行する
</div>

リテンション率の計算に使用するステップを最大 2 つ選択します。繰り返しウィンドウのリテンション期間を選択してください。
SQL を 1 行も書かずに、コンバージョン率をすぐに把握できます。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_08.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=c5410abec66ff9bdff8cc9941d289df0" alt="コホートのリテンション率を示す Mitzu のリテンション分析" border width="1634" height="828" data-path="images/integrations/data-visualization/mitzu_08.webp" />

<br />

<Tip>
  **コホートリテンション**

  `Weekly cohort retention` を選択すると、リテンション率が時間の経過とともにどのように変化するかを可視化できます。
</Tip>

<div id="7-run-journey-queries">
  ## 7. ジャーニークエリを実行する
</div>

ファネルでは最大 9 つのステップを選択できます。ユーザーがジャーニーを完了できる時間枠を選択してください。Mitzu のジャーニーチャートでは、選択したイベント間でユーザーがたどるあらゆる経路を視覚的に把握できます。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_09.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=ed182bb15f1b2dec91f978e41178af9d" alt="イベント間のユーザーの経路フローを示す Mitzu のジャーニー可視化" border width="1630" height="885" data-path="images/integrations/data-visualization/mitzu_09.webp" />

<br />

<Tip>
  **ステップを内訳表示する**

  同じステップ内のユーザーを区別するには、セグメント `Break down` に使用するプロパティを選択できます。
</Tip>

<br />

<div id="8-run-revenue-queries">
  ## 8. 収益クエリを実行する
</div>

収益関連の設定が完了している場合、Mitzu は支払いイベントに基づいて合計 MRR とサブスクリプション数を計算できます。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_10.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=fa704b1d8c079a47b58044c3345b341d" alt="MRR メトリクスを表示する Mitzu の収益分析ダッシュボード" border width="1634" height="820" data-path="images/integrations/data-visualization/mitzu_10.webp" />

<div id="9-sql-native">
  ## 9. SQLネイティブ
</div>

Mitzu はSQLネイティブで、Explore ページで選択した設定からネイティブのSQLコードを生成します。

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_11.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=48a3aff465608f30bb9a8f58d530af78" alt="ネイティブの ClickHouse クエリを表示する Mitzu の SQL コード生成ビュー" border width="3814" height="1854" data-path="images/integrations/data-visualization/mitzu_11.webp" />

<br />

<Tip>
  **BI ツールで作業を続ける**

  Mitzu の UI に制限がある場合は、SQL コードをコピーして BI ツールで作業を続けてください。
</Tip>

<div id="mitzu-support">
  ## Mitzu サポート
</div>

お困りの際は、お気軽に [support@mitzu.io](email://support@mitzu.io) までお問い合わせください

または、[こちら](https://join.slack.com/t/mitzu-io/shared_invite/zt-1h1ykr93a-_VtVu0XshfspFjOg6sczKg) から Slack コミュニティにご参加ください

<div id="learn-more">
  ## 詳細情報
</div>

Mitzu の詳細については、[mitzu.io](https://mitzu.io) をご覧ください。

ドキュメントについては、[docs.mitzu.io](https://docs.mitzu.io) をご覧ください。