> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-560f2a74.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> RocketBI é uma plataforma de inteligência de negócios self-service que ajuda você a analisar dados rapidamente, criar visualizações com recurso de arrastar e soltar e colaborar com colegas diretamente no navegador.

# Objetivo: criar seu primeiro dashboard com o Rocket.BI

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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

Neste guia, você vai instalar e criar um dashboard simples com o Rocket.BI.
Este é o dashboard:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_01.gif?s=d06a11a5a5201753673a61e192fa7f12" alt="Dashboard do Rocket BI mostrando métricas de vendas com gráficos e KPIs" border width="1200" height="651" data-path="images/integrations/data-visualization/rocketbi_01.gif" />

<br />

Você pode conferir [o dashboard neste link.](https://demo.rocket.bi/dashboard/sales-dashboard-7?token=7eecf750-cbde-4c53-8fa8-8b905fec667e)

<div id="install">
  ## Instalação
</div>

Inicie o RocketBI com nossas imagens Docker prontas para uso.

Obtenha o docker-compose.yml e o arquivo de configuração:

```bash theme={null}
wget https://raw.githubusercontent.com/datainsider-co/rocket-bi/main/docker/docker-compose.yml
wget https://raw.githubusercontent.com/datainsider-co/rocket-bi/main/docker/.clickhouse.env
```

Edite o `.clickhouse.env` e adicione as informações do servidor ClickHouse.

Inicie o RocketBI executando o comando: `docker-compose up -d .`

Abra o navegador, acesse `localhost:5050` e faça login com esta conta: `hello@gmail.com/123456`

Para compilar a partir do código-fonte ou usar uma configuração avançada, consulte [Rocket.BI Readme](https://github.com/datainsider-co/rocket-bi/blob/main/README.md)

<div id="lets-build-the-dashboard">
  ## Vamos criar o dashboard
</div>

No Dashboard, você encontrará seus relatórios. Para começar a visualizar, clique em **+New**

Você pode criar **dashboards ilimitados** e gerar **gráficos ilimitados** em um dashboard.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_02.gif?s=666980791ce3af03c2e0ccd3f0b0c3a9" alt="Animação mostrando o processo de criação de um novo gráfico no Rocket BI" border width="800" height="434" data-path="images/integrations/data-visualization/rocketbi_02.gif" />

<br />

Veja o tutorial em alta resolução no YouTube: [https://www.youtube.com/watch?v=TMkdMHHfvqY](https://www.youtube.com/watch?v=TMkdMHHfvqY)

<div id="build-the-chart-controls">
  ### Configure os controles do gráfico
</div>

<div id="create-a-metrics-control">
  #### Criar um controle de métricas
</div>

Na aba Filtro, selecione os campos de métrica que deseja usar. Certifique-se de manter a opção de agregação marcada.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_03.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=b3f107482573ebb3db4cf57e99678def" alt="Painel de configuração do controle de métricas do Rocket BI mostrando os campos selecionados e as configurações de agregação" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_03.png" />

<br />

Renomeie os filtros e salve o controle no dashboard

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_04.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=8c838bad0aaf95ea0ad08210af2f576f" alt="Controle de métricas com filtros renomeados pronto para ser salvo no dashboard" border width="1156" height="138" data-path="images/integrations/data-visualization/rocketbi_04.png" />

<div id="create-a-date-type-control">
  #### Crie um controle do tipo data
</div>

Escolha um campo de data como coluna principal de data:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_05.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=2006909ad2da2ec2e916a89963cabe52" alt="Interface de seleção de campo de data no Rocket BI mostrando as colunas de data disponíveis" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_05.png" />

<br />

Adicione variantes duplicadas com diferentes granularidades. Por exemplo: anual, mensal, diária ou dia da semana.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_06.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=c7d14619494fea66566e715d1d87ff8b" alt="Configuração de intervalo de datas mostrando diferentes opções de período, como ano, mês e dia" border width="1646" height="863" data-path="images/integrations/data-visualization/rocketbi_06.png" />

<br />

Renomeie os filtros e salve o controle no dashboard

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_07.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=79df58831d8eb4d3dfdedf4c9a16a9f2" alt="Controle de intervalo de datas com filtros renomeados pronto para ser salvo no dashboard" border width="346" height="444" data-path="images/integrations/data-visualization/rocketbi_07.png" />

<div id="now-let-build-the-charts">
  ### Agora, vamos criar os gráficos
</div>

<div id="pie-chart-sales-metrics-by-regions">
  #### Gráfico de pizza: métricas de vendas por regiões
</div>

Escolha Adding new chart e, em seguida, Select Pie Chart

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_08.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=b1b9c2dacb99d357c51fcf803ecb6552" alt="Painel de seleção do tipo de gráfico com a opção de gráfico de pizza destacada" border width="1860" height="1312" data-path="images/integrations/data-visualization/rocketbi_08.png" />

<br />

Primeiro, arraste e solte a coluna "Region" do Dataset no Legend Field

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_09.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=98c5cd401a59bbcf4cba7d725e588e94" alt="Interface de arrastar e soltar mostrando a coluna Region sendo adicionada ao campo de legenda" border width="2562" height="1486" data-path="images/integrations/data-visualization/rocketbi_09.png" />

<br />

Em seguida, mude para a guia Chart Control

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_10.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=ef8cc63912205f0b4953ed9d9546cc9f" alt="Interface da guia Chart Control mostrando opções de configuração da visualização" border width="1420" height="918" data-path="images/integrations/data-visualization/rocketbi_10.png" />

<br />

Arraste e solte o Metrics Control no Value Field

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_11.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=301b7c262a5bad55acef98519cc10056" alt="Metrics Control sendo adicionado ao campo de valor do gráfico de pizza" border width="2532" height="1484" data-path="images/integrations/data-visualization/rocketbi_11.png" />

<br />

(você também pode usar o Metrics Control para ordenação)

Acesse Chart Setting para mais personalizações

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_12.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=881d388d2bb80e20c43108a78cae40c9" alt="Painel de configurações do gráfico mostrando opções de personalização para o gráfico de pizza" border width="1130" height="806" data-path="images/integrations/data-visualization/rocketbi_12.png" />

<br />

Por exemplo, altere Data label para Percentage

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_13.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=f9516a14bd76daf452c964724b886791" alt="Configurações do rótulo de dados sendo alteradas para mostrar porcentagens no gráfico de pizza" border width="2534" height="1468" data-path="images/integrations/data-visualization/rocketbi_13.png" />

<br />

Salve e adicione o gráfico ao dashboard

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_14.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=aa6deaad3cc9f2f1fb8fd66250f9735d" alt="Visualização do dashboard mostrando o gráfico de pizza recém-adicionado com outros controles" border width="1566" height="1056" data-path="images/integrations/data-visualization/rocketbi_14.png" />

<div id="use-date-control-in-a-time-series-chart">
  #### Use o controle de data em um gráfico de série temporal
</div>

Vamos usar um gráfico de colunas empilhadas

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_15.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=4c5906bd01db2bec0df491943fee5827" alt="Interface de criação de gráfico de colunas empilhadas com dados de série temporal" border width="1836" height="1332" data-path="images/integrations/data-visualization/rocketbi_15.png" />

<br />

No Chart Control, use o Metrics Control como eixo Y e o Date Range como eixo X

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_16.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=e9a32e38864ba58c29bbf7b71c183454" alt="Configuração do controle do gráfico mostrando métricas no eixo Y e intervalo de datas no eixo X" border width="2552" height="1496" data-path="images/integrations/data-visualization/rocketbi_16.png" />

<br />

Adicione a coluna Region ao Breakdown

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_17.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=e71dd0c9b4e19b6e1fbf0a458a2330db" alt="Coluna Region sendo adicionada como dimensão de detalhamento no gráfico de colunas empilhadas" border width="2552" height="1496" data-path="images/integrations/data-visualization/rocketbi_17.png" />

<br />

Adicione um gráfico de número como KPI e destaque mais o dashboard

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-560f2a74/HM7Rl-D1Ep0gqv6s/images/integrations/data-visualization/rocketbi_18.png?fit=max&auto=format&n=HM7Rl-D1Ep0gqv6s&q=85&s=906f49b73513bdb5935cb72bba6bf32b" alt="Dashboard completo com gráficos numéricos de KPI, gráfico de pizza e visualização de série temporal" border width="2788" height="1506" data-path="images/integrations/data-visualization/rocketbi_18.png" />

<br />

Agora, você criou com sucesso seu primeiro dashboard com rocket.BI
