> ## 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.

> Mitzu는 노코드 warehouse-native 제품 분석 애플리케이션입니다.

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

<CommunityMaintainedBadge />

Mitzu는 코드 작성 없이 사용할 수 있는 warehouse-native 제품 분석 애플리케이션입니다. Amplitude, Mixpanel, PostHog와 같은 도구와 마찬가지로, Mitzu를 사용하면 SQL이나 Python 전문 지식 없이도 제품 사용 데이터를 분석할 수 있습니다.

하지만 이러한 플랫폼과 달리 Mitzu는 회사의 제품 사용 데이터를 복제하지 않습니다. 대신 회사의 기존 데이터 웨어하우스나 데이터 레이크에서 직접 네이티브 SQL 쿼리를 생성합니다.

<div id="goal">
  ## 목표
</div>

이 가이드에서는 다음 내용을 살펴봅니다.

* warehouse-native 제품 분석
* Mitzu를 ClickHouse와 통합하는 방법

<Tip>
  **예시 데이터셋**

  Mitzu에 사용할 데이터셋이 없다면 NYC Taxi Data를 사용할 수 있습니다.
  이 데이터셋은 ClickHouse Cloud에서 사용할 수 있으며, [다음 안내에 따라 로드할 수도 있습니다](/docs/ko/get-started/sample-datasets/nyc-taxi).
</Tip>

이 가이드는 Mitzu 사용 방법을 간략히 소개합니다. 자세한 내용은 [Mitzu 문서](https://docs.mitzu.io/)에서 확인할 수 있습니다.

<Steps>
  <Step title="연결 정보 준비하기" id="1-gather-your-connection-details">
    HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.

    | 매개변수                      | 설명                                                         |
    | ------------------------- | ---------------------------------------------------------- |
    | `HOST` and `PORT`         | 일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다.      |
    | `DATABASE NAME`           | 기본적으로 `default`라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오. |
    | `USERNAME` and `PASSWORD` | 기본 사용자 이름은 `default`입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.         |

    ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다.
    서비스를 선택한 다음 **Connect**를 클릭하십시오.

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="ClickHouse Cloud 서비스 연결 버튼" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

    **HTTPS**를 선택하십시오. 연결 정보가 예시 `curl` 명령으로 표시됩니다.

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="ClickHouse Cloud HTTPS 연결 정보" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

    자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.
  </Step>

  <Step title="Mitzu에 로그인하거나 가입하세요" id="2-sign-in-or-sign-up-to-mitzu">
    먼저 가입하려면 [https://app.mitzu.io](https://app.mitzu.io)로 이동하십시오.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_01.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=0e5e192401de2a9f2c030c465a6ffa92" alt="이메일 및 비밀번호 필드가 있는 Mitzu 로그인 페이지" border width="1913" height="962" data-path="images/integrations/data-visualization/mitzu_01.webp" />
  </Step>

  <Step title="워크스페이스 구성하기" id="3-configure-your-workspace">
    조직을 생성한 후 왼쪽 사이드바에서 `Set up your workspace` 온보딩 가이드를 따르십시오. 그런 다음 `Connect Mitzu with your data warehouse` 링크를 클릭하십시오.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_02.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=03f37ed110a4ae2f9a9e99993809be8e" alt="온보딩 단계를 보여주는 Mitzu 워크스페이스 설정 페이지" border width="1919" height="967" data-path="images/integrations/data-visualization/mitzu_02.webp" />
  </Step>

  <Step title="Mitzu를 ClickHouse에 연결하기" id="4-connect-mitzu-to-clickhouse">
    먼저 연결 유형으로 ClickHouse를 선택하고 연결 정보를 입력하십시오. 그런 다음 `Test connection & Save` 버튼을 클릭하여 설정을 저장하십시오.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=67d24d93585e89f878e4588f4997cd81" alt="구성 양식이 표시된 ClickHouse용 Mitzu 연결 설정 페이지" border width="1323" height="850" data-path="images/integrations/data-visualization/mitzu_03.webp" />
  </Step>

  <Step title="이벤트 테이블 구성" id="5-configure-event-tables">
    연결이 저장되면 `Event tables` 탭을 선택하고 `Add table` 버튼을 클릭하십시오. 모달에서 데이터베이스와 Mitzu에 추가할 테이블을 선택하십시오.

    체크박스를 사용해 테이블을 하나 이상 선택한 다음 `Configure table` 버튼을 클릭하십시오. 그러면 각 테이블의 키 컬럼을 설정할 수 있는 모달 창이 열립니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_04.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=75dc4dd93e81cad52c6d77d06d7bd3f0" alt="데이터베이스 테이블을 보여주는 Mitzu 테이블 선택 인터페이스" border width="1341" height="885" data-path="images/integrations/data-visualization/mitzu_04.webp" />

    <br />

    > ClickHouse 설정에서 제품 분석을 실행하려면 테이블에서 몇 가지 핵심 컬럼을 지정해야 합니다.
    >
    > 다음과 같습니다:
    >
    > * **사용자 ID** - 사용자의 고유 식별자를 나타내는 컬럼입니다.
    > * **이벤트 시간** - 이벤트의 타임스탬프 컬럼입니다.
    > * 선택 사항\[**이벤트 이름**] - 테이블에 여러 이벤트 타입이 포함된 경우 이 컬럼을 사용해 이벤트를 구분합니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_05.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=9cad0b3fc31dad912322148649a7c7d3" alt="컬럼 매핑 옵션을 보여주는 Mitzu 이벤트 카탈로그 구성" border width="1611" height="693" data-path="images/integrations/data-visualization/mitzu_05.webp" />

    <br />

    모든 테이블 구성이 완료되면 `Save & update event catalog` 버튼을 클릭하십시오. 그러면 Mitzu가 위에서 정의한 테이블에서 모든 이벤트와 해당 속성을 찾습니다. 이 단계는 데이터셋 크기에 따라 몇 분 정도 걸릴 수 있습니다.
  </Step>

  <Step title="세분화 쿼리 실행하기" id="4-run-segmentation-queries">
    Mitzu에서 사용자 세분화는 Amplitude, Mixpanel, PostHog에서처럼 쉽게 할 수 있습니다.

    `Explore` 페이지의 왼쪽에는 이벤트 선택 영역이 있고, 상단 섹션에서는 시간 범위를 구성할 수 있습니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_06.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=f1ad961bcf12ea9c5bc3aa445b874165" alt="이벤트 선택 및 시간 구성을 갖춘 Mitzu 세분화 쿼리 인터페이스" border width="1634" height="873" data-path="images/integrations/data-visualization/mitzu_06.webp" />

    <br />

    <Tip>
      **필터 및 분류**

      필터링은 예상한 방식대로 수행됩니다. 속성(ClickHouse 컬럼)을 선택한 다음, 필터링할 값을 드롭다운에서 선택하면 됩니다.
      분류 기준으로는 이벤트 속성이나 사용자 속성을 모두 선택할 수 있습니다(사용자 속성을 통합하는 방법은 아래를 참조하십시오).
    </Tip>
  </Step>

  <Step title="퍼널 쿼리 실행" id="5-run-funnel-queries">
    퍼널에 대해 최대 9단계까지 선택할 수 있습니다. 사용자가 퍼널을 완료할 수 있는 시간 범위를 선택하십시오.
    한 줄의 SQL code도 작성하지 않고 즉시 전환율에 대한 인사이트를 얻을 수 있습니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_07.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=ff22390fa046df390ca196095108b5df" alt="단계 간 전환율을 보여주는 Mitzu 퍼널 분석 화면" border width="1630" height="880" data-path="images/integrations/data-visualization/mitzu_07.webp" />

    <br />

    <Tip>
      **추세 시각화**

      시간 경과에 따른 퍼널 추세를 시각화하려면 `Funnel trends`를 선택하십시오.
    </Tip>
  </Step>

  <Step title="리텐션 쿼리 실행" id="6-run-retention-queries">
    유지율 계산을 위해 최대 2개의 단계를 선택하십시오. 반복 윈도우의 유지 기간을 선택하십시오.
    단 한 줄의 SQL도 작성하지 않고 즉시 전환율 인사이트를 얻으십시오.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=0329e40a07eeabfc56a390cd1b86f4f1" alt="코호트 유지율을 보여주는 Mitzu 유지 분석" border width="1634" height="828" data-path="images/integrations/data-visualization/mitzu_08.webp" />

    <br />

    <Tip>
      **코호트 유지율**

      시간 경과에 따라 유지율이 어떻게 변하는지 시각화하려면 `Weekly cohort retention`을 선택하십시오.
    </Tip>
  </Step>

  <Step title="여정 쿼리 실행하기" id="7-run-journey-queries">
    퍼널에서 최대 9개의 단계를 선택하십시오. 사용자가 여정을 완료할 수 있는 시간 범위를 선택하십시오. Mitzu 여정 chart는 선택한 이벤트를 기준으로 사용자가 거치는 모든 경로를 시각적으로 보여줍니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_09.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=d6475a7685b47267a3e45ca1d3dd9262" alt="이벤트 간 사용자 경로 흐름을 보여주는 Mitzu 여정 시각화" border width="1630" height="885" data-path="images/integrations/data-visualization/mitzu_09.webp" />

    <br />

    <Tip>
      **단계 세분화**

      동일한 단계 내의 사용자를 구분하려면 세그먼트 `Break down`에 사용할 속성을 선택할 수 있습니다.
    </Tip>

    <br />
  </Step>

  <Step title="매출 관련 쿼리 실행" id="8-run-revenue-queries">
    수익 관련 설정이 구성되어 있으면 Mitzu는 결제 이벤트를 기반으로 총 MRR과 구독 수를 계산할 수 있습니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_10.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=b10acdbb9a074ad32a66be91d8a18b90" alt="MRR 메트릭을 보여주는 Mitzu 수익 분석 대시보드" border width="1634" height="820" data-path="images/integrations/data-visualization/mitzu_10.webp" />
  </Step>

  <Step title="네이티브 SQL" id="9-sql-native">
    Mitzu는 SQL 네이티브이므로 Explore 페이지에서 선택한 구성을 바탕으로 네이티브 SQL 코드를 생성합니다.

    <Image size="lg" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/mitzu_11.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=8113a0fa500a5f051895f5da5b8daf1b" 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>
  </Step>
</Steps>

<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)에서 확인하실 수 있습니다.