> ## 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 é um aplicativo de análise de produto sem código e warehouse-native.

# Como conectar o Mitzu ao 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>
            Mantido pela comunidade
        </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 é um aplicativo de análise de produto sem código e warehouse-native. Semelhante a ferramentas como Amplitude, Mixpanel e PostHog, o Mitzu permite que os usuários analisem dados de uso do produto sem exigir conhecimento de SQL ou Python.

No entanto, ao contrário dessas plataformas, o Mitzu não duplica os dados de uso do produto da empresa. Em vez disso, gera consultas SQL nativas diretamente no data warehouse ou data lake já existente da empresa.

<div id="goal">
  ## Objetivo
</div>

Neste guia, vamos abordar o seguinte:

* Análise de produto warehouse-native
* Como integrar o Mitzu ao ClickHouse

<Tip>
  **Conjuntos de dados de exemplo**

  Se você não tiver um conjunto de dados para usar com o Mitzu, pode trabalhar com o NYC Taxi Data.
  Esse conjunto de dados está disponível no ClickHouse Cloud ou [pode ser carregado seguindo estas instruções](/docs/pt-BR/get-started/sample-datasets/nyc-taxi).
</Tip>

Este guia é apenas uma breve visão geral de como usar o Mitzu. Você pode encontrar informações mais detalhadas na [documentação do Mitzu](https://docs.mitzu.io/).

<Steps>
  <Step title="Reúna seus dados de conexão" id="1-gather-your-connection-details">
    Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações:

    | Parâmetro(s)              | Descrição                                                                                                         |
    | ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
    | `HOST` and `PORT`         | Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.                                            |
    | `DATABASE NAME`           | Por padrão, há um banco de dados chamado `default`; use o nome do banco de dados ao qual você deseja se conectar. |
    | `USERNAME` and `PASSWORD` | Por padrão, o nome de usuário é `default`. Use o nome de usuário apropriado para o seu caso de uso.               |

    Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud.
    Selecione um serviço e clique em **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="botão Connect do serviço do ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

    Escolha **HTTPS**. Os detalhes de conexão são exibidos em um comando `curl` de exemplo.

    <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="detalhes de conexão HTTPS do ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

    Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.
  </Step>

  <Step title="Faça login ou cadastre-se no Mitzu" id="2-sign-in-or-sign-up-to-mitzu">
    Para começar, acesse [https://app.mitzu.io](https://app.mitzu.io) para se cadastrar.

    <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="Página de login do Mitzu com campos de email e senha" border width="1913" height="962" data-path="images/integrations/data-visualization/mitzu_01.webp" />
  </Step>

  <Step title="Configure seu workspace" id="3-configure-your-workspace">
    Depois de criar uma organização, siga o guia de onboarding `Set up your workspace` na barra lateral à esquerda. Em seguida, clique no link `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="Página de configuração do workspace do Mitzu com as etapas de onboarding" border width="1919" height="967" data-path="images/integrations/data-visualization/mitzu_02.webp" />
  </Step>

  <Step title="Conectar o Mitzu ao ClickHouse" id="4-connect-mitzu-to-clickhouse">
    Primeiro, selecione ClickHouse como o tipo de conexão e informe os detalhes da conexão. Em seguida, clique no botão `Test connection & Save` para salvar as configurações.

    <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="Página de configuração de conexão do Mitzu para ClickHouse com formulário de configuração" border width="1323" height="850" data-path="images/integrations/data-visualization/mitzu_03.webp" />
  </Step>

  <Step title="Configurar tabelas de eventos" id="5-configure-event-tables">
    Depois que a conexão for salva, selecione a aba `Event tables` e clique no botão `Add table`. No modal, selecione seu banco de dados e as tabelas que deseja adicionar ao Mitzu.

    Use as caixas de seleção para escolher pelo menos uma tabela e clique no botão `Configure table`. Isso abrirá uma janela modal na qual você poderá definir as colunas-chave de cada tabela.

    <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="Interface de seleção de tabelas do Mitzu mostrando tabelas do banco de dados" border width="1341" height="885" data-path="images/integrations/data-visualization/mitzu_04.webp" />

    <br />

    > Para executar análises de produto na sua configuração do ClickHouse, você precisa > especificar algumas colunas-chave da sua tabela.
    >
    > São elas:
    >
    > * **ID do usuário** - a coluna do identificador único dos usuários.
    > * **Hora do evento** - a coluna de timestamp dos seus eventos.
    > * Optional\[**Nome do evento**] - Esta coluna segmenta os eventos se a tabela contiver vários tipos de evento.

    <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="Configuração do catálogo de eventos do Mitzu mostrando opções de mapeamento de colunas" border width="1611" height="693" data-path="images/integrations/data-visualization/mitzu_05.webp" />

    <br />

    Quando todas as tabelas estiverem configuradas, clique no botão `Save & update event catalog`, e o Mitzu localizará todos os eventos e suas propriedades a partir da tabela definida acima. Esta etapa pode levar alguns minutos, dependendo do tamanho do seu dataset.
  </Step>

  <Step title="Executar consultas de segmentação" id="4-run-segmentation-queries">
    A segmentação de usuários no Mitzu é tão fácil quanto no Amplitude, Mixpanel ou PostHog.

    A página Explore tem uma área de seleção de eventos à esquerda, enquanto a seção superior permite configurar o horizonte de tempo.

    <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="Interface de consulta de segmentação do Mitzu com seleção de eventos e configuração de tempo" border width="1634" height="873" data-path="images/integrations/data-visualization/mitzu_06.webp" />

    <br />

    <Tip>
      **Filtros e detalhamento**

      A filtragem é feita como esperado: escolha uma propriedade (coluna do ClickHouse) e selecione, no menu suspenso, os valores pelos quais deseja filtrar.
      Você pode escolher qualquer propriedade de evento ou de usuário para detalhamentos (veja abaixo como integrar propriedades de usuário).
    </Tip>
  </Step>

  <Step title="Executar consultas de funil" id="5-run-funnel-queries">
    Selecione até 9 etapas para um funil. Escolha a janela de tempo em que seus usuários podem concluir o funil.
    Obtenha insights imediatos sobre a taxa de conversão sem escrever uma única linha de código SQL.

    <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="Visualização da análise de funil do Mitzu mostrando taxas de conversão entre etapas" border width="1630" height="880" data-path="images/integrations/data-visualization/mitzu_07.webp" />

    <br />

    <Tip>
      **Visualize tendências**

      Escolha `Funnel trends` para visualizar as tendências do funil ao longo do tempo.
    </Tip>
  </Step>

  <Step title="Executar consultas de retenção" id="6-run-retention-queries">
    Selecione até 2 etapas para calcular a taxa de retenção. Escolha a janela de retenção para a janela recorrente de
    Obtenha insights imediatos sobre a taxa de conversão sem escrever uma única linha de código 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="Análise de retenção do Mitzu mostrando taxas de retenção por coorte" border width="1634" height="828" data-path="images/integrations/data-visualization/mitzu_08.webp" />

    <br />

    <Tip>
      **Retenção por coorte**

      Escolha `Weekly cohort retention` para visualizar como suas taxas de retenção mudam ao longo do tempo.
    </Tip>
  </Step>

  <Step title="Executar consultas de jornada" id="7-run-journey-queries">
    Selecione até 9 etapas para um funil. Escolha a janela de tempo em que seus usuários podem concluir a jornada. O gráfico de jornada do Mitzu oferece um mapa visual de todos os caminhos que os usuários percorrem pelos eventos selecionados.

    <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="Visualização de jornada do Mitzu mostrando o fluxo do caminho do usuário entre eventos" border width="1630" height="885" data-path="images/integrations/data-visualization/mitzu_09.webp" />

    <br />

    <Tip>
      **Detalhar etapas**

      Você pode selecionar uma propriedade para o segmento `Break down` para diferenciar os usuários dentro da mesma etapa.
    </Tip>

    <br />
  </Step>

  <Step title="Executar consultas de faturamento" id="8-run-revenue-queries">
    Se as configurações de receita estiverem definidas, o Mitzu poderá calcular o MRR total e o número de assinaturas com base nos seus eventos de pagamento.

    <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="dashboard de análise de receita do Mitzu mostrando métricas de MRR" border width="1634" height="820" data-path="images/integrations/data-visualization/mitzu_10.webp" />
  </Step>

  <Step title="SQL nativo" id="9-sql-native">
    O Mitzu é SQL Native, o que significa que ele gera código SQL nativo a partir da configuração escolhida na página Explore.

    <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="Visualização da geração de código SQL no Mitzu mostrando consulta nativa do ClickHouse" border width="3814" height="1854" data-path="images/integrations/data-visualization/mitzu_11.webp" />

    <br />

    <Tip>
      **Continue o trabalho em uma ferramenta de BI**

      Se você encontrar alguma limitação na UI do Mitzu, copie o código SQL e continue o trabalho em uma ferramenta de BI.
    </Tip>
  </Step>
</Steps>

<div id="mitzu-support">
  ## Suporte da Mitzu
</div>

Se você estiver com dúvidas, fique à vontade para entrar em contato conosco pelo [support@mitzu.io](email://support@mitzu.io)

Ou acesse nossa comunidade no Slack [aqui](https://join.slack.com/t/mitzu-io/shared_invite/zt-1h1ykr93a-_VtVu0XshfspFjOg6sczKg)

<div id="learn-more">
  ## Saiba mais
</div>

Encontre mais informações sobre a Mitzu em [mitzu.io](https://mitzu.io)

Visite nossa documentação em [docs.mitzu.io](https://docs.mitzu.io)
