> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/explorer-for-iotquery/custom-analysis-sql-configurator/creating-custom-visualizations.md).

# Criando visualizações personalizadas

Crie gráficos interativos a partir dos resultados da consulta SQL usando configuração de arrastar e soltar. Adicione filtros, altere os tipos de gráfico e organize painéis lado a lado

Transforme os resultados de consultas SQL em gráficos interativos por meio de operações de arrastar e soltar. A interface de visualização converte dados brutos em insights visuais sem necessidade de programação.

## Acessando a interface de visualização

Depois de executar consultas SQL, duas abas aparecem acima dos seus resultados:

| **Aba**          | **Finalidade**                                        |
| ---------------- | ----------------------------------------------------- |
| **Dados**        | Revise os resultados da consulta em formato de tabela |
| **Visualização** | Crie gráficos interativos                             |

Clique em **Visualização** para acessar o construtor de gráficos imediatamente após a execução da consulta.

## Visão geral da interface

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-5b324fb5f104043d6e90b5ce4e2eb7d1008b2737%2Fimage-20250819-101042.png?alt=media" alt="Query execution results showing Data and Visualization tabs with transition to chart builder"><figcaption></figcaption></figure>

A área de trabalho de visualização consiste em três áreas coordenadas:

**Lista de campos** (painel esquerdo):

* **Dimensões** - dados categóricos com ícones no estilo de documento
* **Medidas** - dados numéricos com ícones de hashtag
* **Tempo** - campos temporais para análise de tendências

**Prateleiras de configuração** (centro):

* **Eixo X/Eixo Y** - estrutura principal do gráfico
* **Linhas/Colunas** - comparações em vários painéis
* **Filtros** - subconjunto de dados
* **Cor/Tamanho/Opacidade** - codificação visual

**Tela** (direita):

* Exibição de gráficos em tempo real com atualizações imediatas
* Capacidades interativas de zoom, deslocamento e exploração

## Controles essenciais

![](https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-0cb320c900f3f8a3d2eb023fef91d244da088372%2Fimage-20250819-101740.png?alt=media)

Expanda a seção abaixo para ver os principais botões da barra de ferramentas que aceleram a criação de gráficos.

<details>

<summary>Veja a descrição dos controles principais</summary>

| **Controle**                                                                                                                                                                                                                                                                                                                      | **Função**                                                               | **Uso**                                                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Agregação</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-db06e13e449a1bd9145f5b94146dd23792b8d810%2Fimage-20250819-095023.png?alt=media" alt="image-20250819-095023.png"></p>                              | Exibição de dados brutos versus agregados                                | Desative para ver registros individuais; mantenha ativado para ver totais/médias                                       |
| <p><strong>Tipos de marca</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-70a2afec31d1c5880a2f0aa71852404d847f660f%2Fimage-20250819-095030.png?alt=media" alt="image-20250819-095030.png"></p>                         | Seleção do tipo de gráfico (Barras, Linhas etc.)                         | Alterne entre gráficos de barras, gráficos de linhas e gráficos de dispersão com base nas suas necessidades de análise |
| <p><strong>Modo de empilhamento</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-82966d224213a82e7db649cf3260761c3364fafd%2Fimage-20250819-095135.png?alt=media" alt="image-20250819-095135.png"></p>                   | Crie um gráfico empilhado ou normalize um gráfico                        | Empilhe barras para mostrar totais; normalize para comparar percentuais entre categorias                               |
| <p><strong>Transpor</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-b3c64e5f52578991a6215146a9230d44013f53f4%2Fimage-20250819-095215.png?alt=media" alt="image-20250819-095215.png"></p>                               | Alterne o eixo x e o eixo y do gráfico                                   | Inverta a orientação do gráfico quando as categorias forem difíceis de ler ou comparar                                 |
| <p><strong>Ordem de classificação</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-49b13a0e47379ed8926ea67ea7f38b38f7c2fa58%2Fimage-20250819-095235.png?alt=media" alt="image-20250819-095235.png"></p>                 | Classificar em ordem crescente ou decrescente                            | Organize os dados dos valores mais altos para os mais baixos (ou vice-versa) para identificar os melhores desempenhos  |
| <p><strong>Redimensionamento do eixo</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-bbf5ed9b32f0e3acf7aeae48b974bbc72bc07d69%2Fimage-20250819-095259.png?alt=media" alt="image-20250819-095259.png"></p>              | Redimensione os eixos                                                    | Amplie intervalos específicos de valores para examinar os dados com mais detalhes                                      |
| <p><strong>Modo de layout</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-fe5a59221385122f318587bfd28d3e4513a5acf3%2Fimage-20250819-095318.png?alt=media" alt="image-20250819-095318.png"></p>                         | Redimensione o gráfico ou use o gráfico com tamanho automático           | Alterne para o dimensionamento manual quando precisar de gráficos maiores para apresentações                           |
| <p><strong>Modo de exploração</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-bebc23f6350a62a089831171a9cc86f773d95d4d%2Fimage-20250819-095349.png?alt=media" alt="image-20250819-095349.png"></p>                     | Explore os dados. Você pode escolher o modo de ponto ou o modo de pincel | Selecione pontos de dados individuais ou arraste para selecionar vários pontos para análise detalhada                  |
| <p><strong>Exportar</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-f78b79c6d516e2312d37e86c4fed2e0e26d2734e%2Fimage-20250819-095401.png?alt=media" alt="image-20250819-095401.png"></p>                               | Salvar visualizações (PNG ou SVG)                                        | Baixe imagens do gráfico para relatórios, apresentações ou documentação                                                |
| <p><strong>Exportar como CSV</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-cc11118cda791d081a4b367ffb3bdaf57c6d7520%2Fimage-20250819-095721.png?alt=media" alt="image-20250819-095721.png" data-size="original"></p> | Exportar dados visualizados em formato CSV                               | Baixe os dados subjacentes para analisar no Excel ou em outros programas de planilha                                   |
| <p><strong>Exportar código</strong><br><br><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-23cb8613aaca86075f15f2f3c23f8ee2ce39f14a%2Fimage-20250819-095828.png?alt=media" alt="image-20250819-095828.png" data-size="original"></p>   | Exportar a visualização como código em Python ou JSON (Graphic Walker)   | Obtenha o código para recriar este gráfico exato nos seus próprios scripts em Python                                   |

</details>

## Construindo visualizações: fluxo de trabalho de exemplo

**Cenário de exemplo**: Analisando dados operacionais com campos como `category_field`, `performance_metric`, `carimbo de data e hora`, `region`.

{% stepper %}
{% step %}
**Criar gráfico base**

* Arraste o campo categórico (por exemplo, `category_field`) → **Eixo X**
* Arraste o campo numérico (por exemplo, `performance_metric`) → **Eixo Y**
* A interface cria automaticamente um gráfico de barras agregado
  {% endstep %}

{% step %}
**Refinar o tipo de visualização**

Clique em **Tipos de marca** botão para alternativas:

* **Gráficos de barras**: comparações entre categorias
* **Gráficos de linhas**: análise de tendências ao longo do tempo
* **Gráficos de dispersão**: análise de correlação (desative a agregação)
  {% endstep %}

{% step %}
**Adicionar profundidade analítica**

* Arraste um campo categórico adicional → **Cor** prateleira = diferenciação visual
* Arraste um campo numérico → **Tamanho** prateleira = representação proporcional
* Várias dimensões revelam relações ocultas
  {% endstep %}
  {% endstepper %}

\[CAPTURA DE TELA: construção progressiva de gráfico mostrando um gráfico de barras básico evoluindo para uma análise multidimensional]

## Técnicas avançadas

### Análise em vários painéis

Crie visualizações comparativas usando **Linhas/Colunas** prateleiras:

* Arraste o campo categórico → **Linhas** = painéis separados para cada categoria
* Escalas consistentes permitem comparações diretas entre grupos
* Revela padrões ocultos em visualizações agregadas

### Filtragem e foco

Use **Filtros** prateleira para análise direcionada:

* Arraste campos categóricos para seleção de subconjunto
* Arraste campos numéricos para filtragem com base em intervalos
* Vários filtros se combinam para uma exploração precisa dos dados

### Exploração interativa

* Redimensionamento manual do gráfico usando as opções do **Redimensionar** botão
* Capacidades de zoom e deslocamento para exame detalhado
* Capacidades de exportação para compartilhamento e integração

{% hint style="info" %}
**Dica de desempenho**: Aplique filtros antes de visualizações complexas para manter a responsividade com grandes conjuntos de dados.
{% endhint %}

## Avaliando seus resultados

Depois de criar visualizações personalizadas, avalie se essa abordagem atende às suas necessidades analíticas:

**Complexidade da visualização**: Você consegue criar os gráficos e insights necessários para suas decisões operacionais?

**Profundidade da exploração de dados**: Os recursos interativos oferecem flexibilidade analítica suficiente?

**Compartilhamento e integração**: As opções de exportação dão suporte aos seus fluxos de trabalho de relatórios e colaboração?

**Desempenho e escalabilidade**: A interface lida de forma eficaz com o volume de dados e os requisitos de complexidade?

## Próximas etapas

Com base na sua experiência com visualizações personalizadas, talvez você precise de recursos mais avançados. Para orientações completas sobre como selecionar as ferramentas de business intelligence adequadas às suas necessidades específicas e às necessidades da sua organização, veja [Selecionando ferramentas de BI](/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/analytics/pt-br/explorer-for-iotquery/custom-analysis-sql-configurator/creating-custom-visualizations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
