Como usar gráficos

Published: 2025-07-15

Este tutorial mostra como usar o DbGate para criar gráficos bonitos e ricos em informações. Presumo que você já esteja conectado a um banco de dados com o DbGate e seja capaz de executar consultas SQL ou usar o designer de consultas para obter dados de tabelas SQL.

Você também pode usar bancos de dados de exemplo no DbGate Online Demo. Usarei a tabela Invoice do banco de dados de exemplo Chinook para fins de ilustração.

Gráfico de linha do tempo

Um dos gráficos básicos é o gráfico de linha do tempo. É um gráfico de linha com o tempo no eixo X.

Se você executar a seguinte consulta:

SELECT InvoiceDate, Total from Invoice

O DbGate detecta 2 gráficos:

Dica: tente escolher apenas as colunas que você precisa para o gráfico. A detecção automática procura todas as combinações de gráficos, algumas delas não fazem sentido. Esses gráficos são oferecidos se você executar uma consulta simples, com todas as colunas incluídas:

Como você pode ver, o DbGate detecta mais gráficos, mas provavelmente apenas 2 deles você poderia usar.

Personalização de gráficos

Após clicar em um dos gráficos detectados, você pode usar o botão “Personalizar” para alterar o gráfico. Estas são as opções de personalização mais importantes:

• Tipo de gráfico
  • Barra
  • Linha
  • Linha do tempo - é um caso especial de gráfico de linha, com o tempo no eixo X
  • Pizza
  • Área polar
• Campo do eixo X
• Campo de agrupamento. O agrupamento é um recurso poderoso de gráficos, explicarei abaixo
• Campo do eixo Y. Você pode ter mais campos no eixo Y, então mais gráficos serão mostrados
  • Há um campo especial disponível para cada conjunto de dados, “Contagem”, que conta as linhas
• Função de agregação - Soma, Mínimo, Máximo, Média, Primeiro Valor, Último Valor

A configuração do gráfico é armazenada na consulta, no início do arquivo SQL. Assim, se você executar a mesma consulta novamente, o mesmo gráfico será mostrado. Você também pode editar diretamente a configuração no formato YAML, se estiver confortável com isso.

Agrupamento

O agrupamento pode ser usado se você precisar exibir mais gráficos de um conjunto de dados. Eu gostaria de exibir o faturamento total por ano, agrupado por país.

Então, temos que adicionar a coluna Country ao conjunto de resultados:

SELECT InvoiceDate, Total, BillingCountry from Invoice where BillingCountry in ('USA', 'Canada', 'Brazil', 'France', 'Germany')

O algoritmo de detecção automática agora detecta 6 gráficos, clique no gráfico “Total por Data da Fatura”, agrupado por país, e depois clique em “Personalizar”.

Você verá algo assim, que não parece muito utilizável:

Mas quando você muda o “Tipo de gráfico” para “Barra” e “Transformação do eixo X” para “Data (Ano)”, o gráfico fica muito melhor agora.

Como você pode ver, o agrupamento por data pode ser feito no mecanismo de gráficos, não é necessário fazer isso em SQL. No entanto, para resultados maiores, é claro que o agrupamento feito nativamente por SQL será mais eficaz, pois isso será feito diretamente no servidor de banco de dados.

O número de grupos é limitado a 32, não faz sentido ter um número maior de linhas/barras em um gráfico. Se esse limite for excedido, o gráfico não é exibido.

Conclusão

Mostrei o uso básico do recurso de gráficos do DbGate. Você pode deixar comentários sobre este tópico no X tweet. Você pode encontrar mais informações sobre gráficos na documentação.