> 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/dashboard-studio/creating-reports.md). # Criando relatórios Gere relatórios exportáveis com tabelas de dados, gráficos e mapas de localização coordenados a partir de uma única consulta SQL. Exporte para HTML, Excel ou PDF Relatórios oferecem a você uma forma estruturada de analisar dados do IoT Query por meio de três visualizações coordenadas a partir de uma única consulta SQL: uma tabela de dados paginada, um gráfico e um mapa interativo. Use os Relatórios quando precisar de uma saída fixa e exportável, em vez de uma área de painel livre. Relatórios SQL personalizados se adaptam instantaneamente a qualquer questão de negócio ajustando consultas e parâmetros: * **Automação** economiza tempo ao reutilizar consultas e integrar-se a ferramentas de BI para atualizações rápidas. * **Análise aprofundada** é possível combinando, agregando e segmentando dados de várias fontes. * **Precisão e relevância** são garantidas ao trabalhar diretamente com informações brutas e atualizadas do banco de dados. * **Visualizações interativas** permitem que os usuários explorem os dados dinamicamente, ajustando eixos, filtros e métricas. Assista a este vídeo para se familiarizar com a criação de relatórios na interface do aplicativo Dashboard Studio: {% embed url="" %} Criando relatórios no Dashboard Studio passo a passo {% endembed %} ## Relatórios vs. painéis Tanto os relatórios quanto os painéis executam consultas SQL no seu banco de dados do IoT Query e renderizam os resultados como visualizações. A principal diferença está em como as consultas e a saída são estruturadas: | | Relatórios | Dashboards | | ------------- | --------------------------------------------------- | -------------------------------------------- | | Consultas SQL | Uma consulta alimenta todas as visualizações | Cada bloco tem sua própria consulta | | Layout | Fixo: tabela de dados, gráfico, mapa de localização | Tela de arrastar e soltar | | Exportação | HTML, Excel, PDF | Esquema JSON, PDF | | Caso de uso | Análise exportável de um único conjunto de dados | Monitoramento operacional com vários painéis | Use os Relatórios quando um único conjunto de dados precisar ser explorado como tabela, visualizado como gráfico e mapeado simultaneamente, ou quando a saída precisar ser exportada e compartilhada fora do Dashboard Studio. Use os painéis quando precisar de várias visualizações independentes em uma única área, por exemplo: combinando um bloco de estatísticas de resumo do Trajeto, um gráfico de Consumo de combustível e uma tabela de visitas à zona em uma única visualização. Para detalhes sobre a criação de painéis, consulte [Criando painéis](/docs/analytics/pt-br/dashboard-studio/creating-dashboards.md). ## Como criar um relatório {% stepper %} {% step %} #### Etapa 1: Abra o editor de relatório Na barra lateral esquerda, clique em **Tools**, depois selecione **New report**. O Dashboard Studio solicita que você escolha uma seção da estrutura compartilhada do menu. Selecione uma seção existente ou escolha Root para colocar o relatório no nível superior. {% endstep %} {% step %} #### Etapa 2: Insira as informações básicas O editor se abre com dois campos na parte superior: * **Title** (obrigatório): o nome exibido no menu e nos cabeçalhos de exportação. * **Description** (opcional): contexto adicional visível no editor. {% endstep %} {% step %} #### Etapa 3: Escreva a consulta SQL 1. Clique na **SQL Query** guia e insira uma instrução SELECT nas suas tabelas do IoT Query. A consulta define todos os três componentes (tabela, gráfico e mapa), então inclua cada coluna que você pretende usar em todas as visualizações, por exemplo: {% code title="Exemplo básico de consulta de relatório" expandable="true" %} ```sql SELECT t.device_id, o.object_label, -- Converter coordenadas inteiras escaladas para graus decimais t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Converter velocidade inteira escalonada para km/h t.speed::float / 100 AS speed, t.device_time FROM raw_telematics_data.tracking_data_core t JOIN raw_business_data.objects o ON t.device_id = o.device_id LIMIT 1000 ``` {% endcode %} {% hint style="info" icon="lightbulb-exclamation" %} #### Algumas dicas para criar consultas: * Adicione uma cláusula LIMIT ao configurar o relatório. Isso reduz o tempo de execução da consulta e acelera a pré-visualização do componente. Remova ou aumente o limite antes de salvar se você precisar do conjunto de dados completo disponível para download. * Depois de escrever a consulta, você pode clicar **Detect Columns** para verificar quais colunas são realmente recuperadas com esta consulta. Isso ajuda a configurar os seletores de coluna na **Components** guia. A etapa é opcional. Você pode configurar os componentes manualmente, mas executá-la primeiro simplifica a seleção de eixos e campos. * Qualquer consulta SQL usada em um painel de dashboard é um ponto de partida válido para um relatório. Copie a consulta de um painel e ajuste-a para atender ao objetivo do relatório. Por exemplo, adicionando colunas necessárias para o mapa de localização ou removendo agregações que não se aplicam a uma visualização de tabela. * O Recipe Book do IoT Query contém exemplos de consultas gerais e específicos do setor prontos para usar como base para relatórios. Veja [Livro de receitas SQL](/docs/analytics/pt-br/example-queries.md) para a lista completa. {% endhint %} {% endstep %} {% step %} #### Etapa 4: Configurar componentes Clique na **Components** aba. Três componentes estão disponíveis: **Tabela**, **Gráfico**, e **Mapa**. Cada um tem um botão de alternância para incluí-lo ou excluí-lo do relatório. Você pode remover qualquer componente de que não precise. {% tabs %} {% tab title="Tabela de dados" %} A tabela de dados exibe os resultados da consulta em linhas paginadas. * **Tamanho da página**: define quantas linhas aparecem por página na visualização interativa. Isso não afeta a exportação, que sempre contém o conjunto completo de resultados. * **Mostrar linha de totais**: adiciona uma linha de resumo na parte inferior da tabela quando ativado. {% endtab %} {% tab title="Gráfico" %} Dois tipos de gráfico estão disponíveis: * **Série temporal (linha)**: adequado para dados plotados ao longo do tempo. * **Gráfico de barras**: adequado para comparações categóricas (também conhecido como gráfico de colunas). Configure os eixos: * **coluna do eixo X**: geralmente uma coluna de tempo como `device_time`. * **Colunas do eixo Y**: uma ou mais colunas numéricas, como velocidade ou `fuel_level`. * **Grupo por**: opcionalmente, dividir a série por uma coluna categórica, como `rótulo do objeto`, para exibir uma linha ou grupo de barras separado por dispositivo. {% endtab %} {% tab title="Mapa de localização" %} O mapa de localização plota pontos de dados usando coordenadas GPS. O Dashboard Studio pode detectar automaticamente colunas de latitude e longitude a partir do resultado da sua consulta. Quando **Detectar automaticamente colunas de GPS** a alternância está ativada, as colunas necessárias para definir a localização (geralmente `latitude` e `longitude`) são selecionadas automaticamente se sua consulta as retornar. Você também pode desativar a **Detecção automática** opção e selecionar manualmente as colunas necessárias. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Etapa 5: Salvar o relatório Clique em Salvar. O relatório aparece na seção do menu que você selecionou na etapa 1 e fica acessível a todos os usuários que têm acesso a essa seção. {% endstep %} {% endstepper %} ## Visualizar um relatório Depois que você criar um relatório, ele é aberto imediatamente. Você verá todos os componentes configurados renderizados com dados em tempo real do seu banco de dados IoT Query. O cabeçalho do relatório exibe o carimbo de data e hora da última atualização, o total de linhas e o tempo de execução da consulta. A página do relatório também expõe a consulta SQL diretamente, para que você possa atualizá-la sempre que precisar. 1. Expanda a **SQL Query** seção para visualizar ou editar a instrução inline. 2. Aplique as alterações: 1. Clique **Salvar** para armazenar as alterações sem executar. Você precisará clicar **Atualizar** para reexecutar a consulta e atualizar todas as visualizações com os dados atuais. 2. **Salvar & Executar** para aplicar a consulta atualizada imediatamente. ### Tabela de dados A **Tabela de dados** a seção mostra os resultados da consulta com o cabeçalho da seção exibindo o total de linhas retornadas pela consulta. A visualização interativa exibe apenas um número limitado de linhas, o rodapé confirma o número exato. Use o **Download** menu suspenso para exportar o conjunto completo de resultados como Excel (.xlsx) ou CSV (.csv), independentemente de quantas linhas a visualização interativa exiba. Se você precisar de locais em vez de coordenadas brutas, marque a **Geocode to address** caixa no canto superior direito do **Tabela de dados** cabeçalho. Quando ativada, ela converte as colunas de coordenadas em endereços de rua legíveis. {% hint style="warning" %} A resolução de endereços impõe uma carga significativa ao servidor. Use esta opção apenas com conjuntos de dados agregados ou filtrados. Para dados telemáticos brutos com dezenas de milhares de linhas, mantenha as coordenadas em formato numérico. {% endhint %} ### Gráfico A seção de gráfico é renderizada abaixo da tabela de dados. Ela herda as configurações que você aplicou no editor de relatório, mas também é possível ajustar a configuração dos eixos diretamente na visualização: * **Eixo X**: selecione a coluna para plotar no eixo horizontal. * **Eixo Y**: selecione a coluna para plotar no eixo vertical. * **Grupo por**: opcionalmente, dividir a série por uma coluna categórica, como `rótulo do objeto`, para exibir uma linha ou grupo de barras separado por dispositivo. O gráfico exibe um título gerado automaticamente que descreve a seleção atual de eixo e agrupamento, por exemplo: `velocidade ao longo de device_time (agrupada por object_label)`. Quando você modifica as configurações do eixo sem salvar, um **Alterações não salvas** o indicador aparece ao lado do **Salvar configurações do gráfico** botão. Clique nele para manter as alterações de configuração no relatório. Quando **Grupo por** divide o gráfico em grupos, o gráfico plota os primeiros 10 grupos. Para escolher outros grupos, clique **Grupos**, o que mostra quantos grupos são plotados do total. Na lista, clique em um grupo para plotá-lo ou removê-lo do gráfico. Para encontrar um grupo, pesquise pelo nome. As linhas sem valor na **Grupo por** coluna não pertencem a nenhum grupo, e o gráfico as omite. **Selecionar tudo** e **Limpar** aplicam-se aos grupos que correspondem à pesquisa. **Selecionar tudo** não está disponível quando plotaria mais de 1.000 grupos no total. A lista mostra até 100 grupos que não estão plotados, então pesquise para encontrar os outros. Para voltar aos primeiros 10 grupos, clique **Redefinir para o padrão**. O Dashboard Studio não salva a seleção de grupos. A seleção é redefinida quando você abre o relatório novamente ou seleciona outra **Grupo por** coluna. ### Mapa de localização A **Mapa de localização** a seção exibe cada linha da consulta como um ponto em suas coordenadas GPS. O cabeçalho da seção mostra o número de pontos plotados. As colunas GPS são definidas na criação do relatório (automaticamente ou manualmente); não é possível editá-las depois disso. Se a consulta não retornar colunas de coordenadas reconhecidas, a seção mostra "Nenhuma coordenada GPS detectada nos resultados da consulta." Para dados telemáticos com carimbo de data e hora, os pontos plotados representam o percurso completo de um objeto ao longo do período consultado. {% hint style="info" %} O mapa é interativo: amplie e arraste para inspecionar pontos individuais. Clique **Mostrar tudo** para reduzir o zoom e encaixar todos os pontos plotados na área visível do mapa. {% endhint %} ## Exportando um relatório O Dashboard Studio oferece dois níveis de exportação. ### Exportação da tabela de dados Use o **Download** menu suspenso na **Tabela de dados** seção para exportar apenas os dados da tabela. A exportação sempre contém o conjunto completo de resultados retornado pela consulta, independentemente do limite de exibição na visualização interativa. ### Exportação completa do relatório Use os botões no cabeçalho do relatório para exportar todos os componentes juntos. | Botão | Saída | | --------------------- | --------------------------------------------------------------------------- | | Excel → Excel (.xlsx) | Planilha com a tabela de dados completa | | Excel → CSV (.csv) | Arquivo de valores separados por vírgulas com a tabela de dados completa | | HTML | Arquivo interativo com a tabela de dados, o gráfico e o mapa de localização | | PDF | Documento estático com a tabela de dados, o gráfico e o mapa de localização | O gráfico em um arquivo HTML ou PDF plota os mesmos grupos que o gráfico na tela. Quando o gráfico plota apenas alguns dos grupos, o arquivo informa o número de grupos plotados e o número total de grupos. {% hint style="info" %} O arquivo HTML exportado preserva a interatividade: o gráfico oferece suporte a dicas de ferramenta ao passar o mouse e o mapa de localização oferece suporte a zoom e deslocamento. {% endhint %} ## Editar e excluir um relatório Para editar um relatório salvo, você não precisa mais de uma caixa de diálogo de editor separada. Abra o relatório no menu e modifique a consulta SQL ou as configurações dos componentes diretamente nele. A única exceção são as colunas de localização; elas são definidas uma vez na criação do relatório. Para excluir um relatório, clique **Tools** na barra lateral esquerda e depois selecione **menu Editar**. Localize o relatório na árvore de menus e clique no menu de três pontos ao lado do nome dele e, em seguida, confirme a exclusão. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.