> ## 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 — no-code приложение для продуктовой аналитики, нативное для хранилища данных.

# Подключение 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 — это no-code приложение для продуктовой аналитики, нативное для хранилища данных. Подобно таким инструментам, как Amplitude, Mixpanel и PostHog, Mitzu позволяет анализировать данные об использовании продукта без знания SQL или Python.

Однако, в отличие от этих платформ, Mitzu не дублирует данные компании об использовании продукта. Вместо этого оно напрямую генерирует нативные SQL-запросы в существующем хранилище данных или озере данных компании.

<div id="goal">
  ## Цель
</div>

В этом руководстве мы рассмотрим следующее:

* Продуктовую аналитику, нативную для хранилища данных
* Как интегрировать Mitzu с ClickHouse

<Tip>
  **Примеры наборов данных**

  Если у вас нет набора данных для работы с Mitzu, можно использовать данные NYC Taxi.
  Этот набор данных доступен в ClickHouse Cloud или [может быть загружен по этой инструкции](/ru/get-started/sample-datasets/nyc-taxi).
</Tip>

Это руководство — лишь краткий обзор использования Mitzu. Более подробную информацию можно найти в [документации Mitzu](https://docs.mitzu.io/).

<Steps>
  <Step title="Соберите сведения о подключении" id="1-gather-your-connection-details">
    Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:

    | Параметр(ы)               | Описание                                                                                                               |
    | ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
    | `HOST` and `PORT`         | Обычно используется порт 8443 при использовании TLS и 8123 без TLS.                                                    |
    | `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-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=dd441fc2272e292760011d48e81d43d4" 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-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=878b1fe94ea520377426f69503e38994" 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-postgresql-tls-support/sK1EDai1DhVYGATV/images/integrations/data-visualization/mitzu_01.webp?fit=max&auto=format&n=sK1EDai1DhVYGATV&q=85&s=0cff21a5d3627139b41754323f2512cb" alt="Страница входа Mitzu с полями email и пароля" 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-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" />
  </Step>

  <Step title="Подключите Mitzu к ClickHouse" id="4-connect-mitzu-to-clickhouse">
    Сначала выберите тип подключения 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="Страница настройки подключения Mitzu к ClickHouse с формой конфигурации" 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-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 найдёт все события и их свойства в указанных выше таблицах. Этот шаг может занять несколько минут в зависимости от размера вашего набора данных.
  </Step>

  <Step title="Выполняйте запросы сегментации" id="4-run-segmentation-queries">
    Сегментация пользователей в 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>
  </Step>

  <Step title="Выполнить запросы для воронки" id="5-run-funnel-queries">
    Выберите до 9 шагов для воронки. Укажите временной интервал, в течение которого пользователи могут пройти воронку.
    Получайте мгновенную информацию о коэффициенте конверсии, не написав ни одной строки SQL-кода.

    <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>
  </Step>

  <Step title="Выполнять запросы для анализа удержания" id="6-run-retention-queries">
    Выберите до 2 шагов для расчёта коэффициента удержания. Выберите окно удержания для повторяющегося периода.
    Получайте мгновенную аналитику по коэффициенту конверсии, не написав ни одной строки SQL-кода.

    <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>
  </Step>

  <Step title="Выполнять запросы для анализа путей пользователей" id="7-run-journey-queries">
    Выберите до 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 />
  </Step>

  <Step title="Выполнять запросы для анализа выручки" id="8-run-revenue-queries">
    Если настроены параметры выручки, 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="Панель мониторинга анализа выручки Mitzu с метриками MRR" border width="1634" height="820" data-path="images/integrations/data-visualization/mitzu_10.webp" />
  </Step>

  <Step title="Нативный SQL" id="9-sql-native">
    Mitzu поддерживает нативный SQL, то есть генерирует нативный SQL-код на основе выбранной вами конфигурации на странице Explore.

    <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="Экран генерации SQL-кода в Mitzu с нативным запросом к ClickHouse" border width="3814" height="1854" data-path="images/integrations/data-visualization/mitzu_11.webp" />

    <br />

    <Tip>
      **Продолжите работу в BI-инструменте**

      Если вы столкнулись с ограничением в интерфейсе Mitzu, скопируйте SQL-код и продолжите работу в BI-инструменте.
    </Tip>
  </Step>
</Steps>

<div id="mitzu-support">
  ## Поддержка Mitzu
</div>

Если у вас возникли трудности, свяжитесь с нами по адресу [support@mitzu.io](email://support@mitzu.io)

Или присоединяйтесь к нашему сообществу в Slack [здесь](https://join.slack.com/t/mitzu-io/shared_invite/zt-1h1ykr93a-_VtVu0XshfspFjOg6sczKg)

<div id="learn-more">
  ## Узнайте больше
</div>

Подробнее о Mitzu — на [mitzu.io](https://mitzu.io)

Посетите нашу страницу документации: [docs.mitzu.io](https://docs.mitzu.io)