> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/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>
            Community Maintained
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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](/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/).

<div id="1-gather-your-connection-details">
  ## 1. Reúna os detalhes da conexão
</div>

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**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/XFccO_5diusZJegS/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=XFccO_5diusZJegS&q=85&s=f555d1526a2876eb95ef44b43f880607" size="md" alt="botão Connect do serviço do ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/XFccO_5diusZJegS/images/_snippets/connection-details-https.png?fit=max&auto=format&n=XFccO_5diusZJegS&q=85&s=68e588332acd65725ce6198b020d9f66" size="md" alt="detalhes de conexão HTTPS do ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

<div id="2-sign-in-or-sign-up-to-mitzu">
  ## 2. Faça login ou cadastre-se no Mitzu
</div>

Para começar, acesse [https://app.mitzu.io](https://app.mitzu.io) para se cadastrar.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_01.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=3cf61dea0ae88d687e5160b8fd4041b0" alt="Página de login do Mitzu com campos de e-mail e senha" border width="1913" height="962" data-path="images/integrations/data-visualization/mitzu_01.png" />

<div id="3-configure-your-workspace">
  ## 3. Configure o seu workspace
</div>

Após 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-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_02.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=8bebab4cb2b624a4338ce67bd21f2f41" alt="Página de configuração do workspace do Mitzu mostrando as etapas de onboarding" border width="1919" height="967" data-path="images/integrations/data-visualization/mitzu_02.png" />

<div id="4-connect-mitzu-to-clickhouse">
  ## 4. Conecte o Mitzu ao ClickHouse
</div>

Primeiro, selecione ClickHouse como o tipo de conexão e defina 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-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_03.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=b56743fa05e4bba7bce500a61d7c6a44" alt="Página de configuração de conexão do Mitzu com o ClickHouse, com formulário de configuração" border width="1323" height="850" data-path="images/integrations/data-visualization/mitzu_03.png" />

<div id="5-configure-event-tables">
  ## 5. Configurar tabelas de eventos
</div>

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-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_04.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=0a7de942f3f062f22689dd65dc8f6f29" 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.png" />

<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-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_05.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=01ae6f145af045c6d6be5224d3353703" 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.png" />

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

<div id="4-run-segmentation-queries">
  ## 4. Executar consultas de segmentação
</div>

A segmentação de usuários no Mitzu é tão fácil quanto no Amplitude, Mixpanel ou PostHog.

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

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_06.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=be201a2aae7983c3a01530440f9cf2a0" 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.png" />

<br />

<Tip>
  **Filtros e detalhamento**

  A filtragem funciona da forma esperada: 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 os detalhamentos (veja abaixo como integrar propriedades de usuário).
</Tip>

<div id="5-run-funnel-queries">
  ## 5. Execute consultas de funil
</div>

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

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_07.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=3b3b33d10504eba53eb1392b598a704f" alt="Visualização da análise de funil no Mitzu mostrando taxas de conversão entre etapas" border width="1630" height="880" data-path="images/integrations/data-visualization/mitzu_07.png" />

<br />

<Tip>
  **Visualize tendências**

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

<div id="6-run-retention-queries">
  ## 6. Execute consultas de retenção
</div>

Selecione até 2 etapas para calcular a taxa de retenção. Escolha a janela de retenção para a janela recorrente para
Obtenha insights imediatos sobre a taxa de conversão sem escrever uma única linha de SQL.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_08.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=0624b30b6e3bae6fd36d3408e02f2525" alt="Análise de retenção do Mitzu mostrando taxas de retenção de coorte" border width="1634" height="828" data-path="images/integrations/data-visualization/mitzu_08.png" />

<br />

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

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

<div id="7-run-journey-queries">
  ## 7. Execute consultas de jornada
</div>

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 fornece um mapa visual de todos os caminhos que os usuários percorrem entre os eventos selecionados.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_09.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=6f7228131f93b4089298fe0ff067b591" 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.png" />

<br />

<Tip>
  **Detalhe as etapas**

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

<br />

<div id="8-run-revenue-queries">
  ## 8. Execute consultas de receita
</div>

Se as configurações de receita estiverem configuradas, 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-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_10.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=65ca8a476cb5478619158bb31ff84d0a" alt="Painel 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.png" />

<div id="9-sql-native">
  ## 9. SQL nativo
</div>

O Mitzu usa SQL nativo, o que significa que ele gera código SQL nativo com base na configuração escolhida na página Explore.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/WLPCujN9unulSjl4/images/integrations/data-visualization/mitzu_11.png?fit=max&auto=format&n=WLPCujN9unulSjl4&q=85&s=7ceddc1f50100755cba3b5317aa45894" alt="Visualização da geração de código SQL no Mitzu, mostrando uma consulta nativa do ClickHouse" border width="3814" height="1854" data-path="images/integrations/data-visualization/mitzu_11.png" />

<br />

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

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

<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)
