> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.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>
            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>;
};

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-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" size="md" alt="botão Connect do serviço do ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="detalhes de conexão HTTPS do ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_01.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=e74fc42d7b77b1e8e538922bace52649" 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.webp" />

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_02.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=2940dddad984866769bd668f8a7e0949" 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.webp" />

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_03.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=fad22f49f5fe2a443d4cd3d86520b71b" 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.webp" />

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_04.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=7a4ba406034ad78ac841723635d9524b" 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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_05.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=1afb707063ab188ec182dfe39043d532" 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.

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_06.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=04a4d23489723a9fa9655a2d6db0e523" 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 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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_07.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=2fbe3a7fea6a4ac8bf98b2f9b94576f9" 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.webp" />

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_08.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=3a43ba46c40de2a7fd6bfda0bd0fc989" 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.webp" />

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_09.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=1def458f1552a4daae5a48d4a3b0c5b1" 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>
  **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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_10.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=0223bfc7ef3f9c8fc74bdbc0ce7f1449" 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.webp" />

<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-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/mitzu_11.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=7ace45bb834ab225238256eb2b2a07c6" 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.webp" />

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