> 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). # Criar 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 maneira 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 relatórios quando você precisar de uma saída fixa e exportável, em vez de uma tela de painel em formato livre. Relatórios SQL personalizados se adaptam instantaneamente a qualquer pergunta de negócio, ajustando consultas e parâmetros: * **Automação** economiza tempo reutilizando consultas e integrando-se com ferramentas de BI para atualizações rápidas. * **Análise profunda** é possível combinando, agregando e segmentando dados de múltiplas 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 aos usuários explorar 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 relatórios quanto painéis executam consultas SQL em 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 | Painéis | | ------------- | --------------------------------------------------- | -------------------------------------------- | | Consultas SQL | Uma consulta alimenta todas as visualizações | Cada bloco tem sua própria consulta | | Disposição | Fixo: tabela de dados, gráfico, mapa de localização | Canvas de arrastar e soltar | | Exportar | 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 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 painéis quando você precisar de várias visualizações independentes em uma única tela, por exemplo: combinando um bloco de estatística de resumo de trajeto, um gráfico de Consumo de combustível e uma tabela de visitas à zona em uma única visão. Para detalhes sobre como criar 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órios na barra lateral esquerda, clique em **Tools**, depois selecione **New report**. Dashboard Studio solicita que você escolha uma seção da estrutura de menu compartilhada. 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 é aberto com dois campos na parte superior: * **Título** (obrigatório): o nome exibido no menu e nos cabeçalhos de exportação. * **Descrição** (opcional): contexto adicional visível no editor. {% endstep %} {% step %} #### Etapa 3: Escreva a consulta SQL 1. Clique na **Consulta SQL** aba 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), portanto inclua todas as colunas que você pretende usar em todas as visualizações, por exemplo: {% code title="Exemplo básico de consulta do relatório" expandable="true" %} ```sql SELECT t.device_id, o.object_label, -- Convert scaled integer coordinates to decimal degrees t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Convert scaled integer speed to 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 montar consultas: * Adicione uma cláusula LIMIT enquanto estiver configurando o relatório. Isso reduz o tempo de execução da consulta e acelera a pré-visualização dos componentes. Remova ou aumente o limite antes de salvar se você precisar que o conjunto de dados completo esteja disponível para download. * Depois de escrever a consulta, você pode clicar em **Detect Columns** para verificar quais colunas são realmente recuperadas com esta consulta. Isso ajuda a configurar os seletores de coluna na **Components** aba. A etapa é opcional. Você pode configurar componentes manualmente, mas executá-la primeiro simplifica a seleção de eixos e campos. * Qualquer consulta SQL usada em um painel é 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 em tabela. * O Recipe Book do IoT Query contém exemplos de consultas gerais e específicos do setor prontos para uso como base para relatórios. Veja [Livro de receitas de SQL](/docs/analytics/pt-br/example-queries.md) a lista completa. {% endhint %} {% endstep %} {% step %} #### Etapa 4: Configure os 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. * **Exibir 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)**: adequada para dados plotados ao longo do tempo. * **Gráfico de barras**: adequada para comparações categóricas (também chamada de gráfico de colunas). Configure os eixos: * **Coluna do eixo X**: normalmente uma coluna de tempo como `device_time`. * **Colunas do eixo Y**: uma ou mais colunas numéricas, como velocidade ou `nível_de_Combustível`. * **Grupo por**: opcionalmente, dividir séries por uma coluna categórica, como `rótulo_do_objeto`, para exibir um Grupo separado de linhas ou barras por dispositivo. {% endtab %} {% tab title="Mapa de localização" %} O mapa de localização plota pontos de dados usando coordenadas GPS. Dashboard Studio pode detectar automaticamente as colunas de latitude e longitude no resultado da sua consulta. Quando **Detectar automaticamente colunas GPS** quando a alternância estiver 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 **Auto-detect** opção e selecionar as colunas necessárias manualmente. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Etapa 5: Salvar o relatório Clique em Save. O relatório aparece na seção de 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ê cria 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 **Consulta SQL** seção para visualizar ou editar a instrução inline. 2. Aplique as alterações: 1. Clique em **Salvar** para armazenar as alterações sem executar. Você precisará clicar em **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 O **Tabela de dados** A seção mostra os resultados da consulta com o cabeçalho da seção exibindo a contagem 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 ativado, ele converte colunas de coordenadas em endereços de rua legíveis. {% hint style="warning" %} A resolução de endereços impõe uma carga significativa no servidor. Use essa 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 Chart é renderizada abaixo da tabela de dados. Ela herda as configurações que você aplicou no editor de relatórios, mas você também pode ajustar a configuração dos eixos diretamente na visualização: * **Eixo X**: selecione a coluna a ser plotada no eixo horizontal. * **Eixo Y**: selecione a coluna para plotar no eixo vertical. * **Grupo por**: opcionalmente, dividir séries por uma coluna categórica, como `rótulo_do_objeto`, para exibir um Grupo separado de linhas ou barras por dispositivo. O gráfico exibe um título gerado automaticamente que descreve a seleção atual de eixo e agrupamento, por exemplo: `velocidade sobre device_time (agrupado 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. ### Mapa de localização O **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 de GPS são definidas na criação do relatório (automaticamente ou manualmente), não sendo possível editá-las depois. Se a consulta não retornar colunas de coordenadas reconhecidas, a seção mostra "No GPS coordinates detected in query results." Para dados telemáticos com timestamp, os pontos plotados representam o trajeto completo de um objeto ao longo do período consultado. {% hint style="info" %} O mapa é interativo: amplie e mova-se para inspecionar pontos individuais. Clique **Mostrar tudo** para afastar o zoom e enquadrar todos os pontos plotados na área visível do mapa. {% endhint %} ## Exportar um relatório O Dashboard Studio oferece dois níveis de exportação. ### Exportar tabela de dados Use a **Download** menu suspenso dentro da **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írgula 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 | {% 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 pan. {% 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 do componente 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, 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, depois 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 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/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 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.