# Criando relatórios Os relatórios oferecem 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 relatórios quando precisar de uma saída fixa e exportável, em vez de uma tela de dashboard livre. Relatórios SQL personalizados se adaptam instantaneamente a qualquer pergunta de negócio, ajustando consultas e parâmetros: * **Automação** economiza tempo ao reutilizar consultas e integrar-se com ferramentas de BI para atualizações rápidas. * **Análise profunda** é possível ao combinar, agregar e segmentar 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="" %} Criação de relatórios no Dashboard Studio passo a passo {% endembed %} ## Relatórios vs. dashboards Tanto os relatórios quanto os dashboards executam consultas SQL em seu banco de dados do IoT Query e renderizam os resultados como visualizações. A diferença principal está em como as consultas e a saída são estruturadas: | | Relatórios | Dashboards | | ------------- | --------------------------------------------------- | -------------------------------------------- | | Consultas SQL | Uma única 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 | Somente esquema JSON | | 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 dashboards quando precisar de várias visualizações independentes em uma única tela, por exemplo: combinando um bloco de estatística de resumo de viagem, um gráfico de consumo de combustível e uma tabela de visitas a zonas em uma única visualização. Para detalhes sobre a criação de dashboards, consulte [Criando dashboards](/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 **Ferramentas**, depois selecione **Novo relatório**. O Dashboard Studio solicita que você escolha uma seção da estrutura de menu compartilhada. Selecione uma seção existente ou escolha Raiz 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 os três componentes (tabela, gráfico e mapa), portanto inclua todas as colunas que 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 escalada 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 a construção da consulta: * 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 precisar do conjunto completo de dados disponível para download. * Depois de escrever a consulta, você pode clicar em **Detectar colunas** para verificar quais colunas são realmente retornadas por esta consulta. Isso ajuda a configurar os seletores de colunas na aba **Componentes** . Esta 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 do 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 em tabela. * O Recipe Book do IoT Query contém exemplos de consulta gerais e específicos do setor prontos para usar como base para relatórios. Consulte [Recipe Book de SQL](/docs/analytics/pt-br/example-queries.md) para a lista completa. {% endhint %} {% endstep %} {% step %} #### Etapa 4: Configure os componentes Clique na **Componentes** aba. Três componentes estão disponíveis: **Tabela**, **Gráfico**, e **Mapa**. Cada um tem uma 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 ativada. {% 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 speed ou `fuel_level`. * **Agrupar por**: opcionalmente divide as séries por uma coluna categórica, como `object_label`, 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 no resultado da sua consulta. Quando a alternância **Detectar automaticamente colunas GPS** estiver ativada, as colunas necessárias para definir a localização (normalmente `latitude` e `longitude`) são selecionadas automaticamente se sua consulta as retornar. Você também pode desativar a opção **Detecção automática** e selecionar manualmente as colunas necessárias. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Etapa 5: Salve o relatório Clique em Salvar. 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 %} ## Visualização de 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 do IoT Query. O cabeçalho do relatório exibe o carimbo de data e hora da última atualização, a contagem 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 no local. 2. Aplique as alterações: 1. Clique **Salvar** para salvar 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 e Executar** para aplicar imediatamente a consulta atualizada. ### Tabela de dados A **seção Tabela de dados 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 menu suspenso** Download **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 localizações em vez de coordenadas brutas, marque a caixa Geocodificar para endereço **no canto superior direito do** cabeçalho. Quando ativada, ela converte as colunas de coordenadas em endereços de rua legíveis. **seção Tabela de dados 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 menu suspenso** A resolução de endereços gera uma carga significativa no servidor. Use esta opção somente 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. {% hint style="warning" %} A resolução de endereços gera uma carga significativa no servidor. Use esta opção somente 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 Gráfico é exibida abaixo da tabela de dados. Ela herda as configurações aplicadas 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 a ser plotada no eixo vertical. * **Agrupar por**: opcionalmente divide as séries por uma coluna categórica, como `object_label`, para exibir uma linha ou grupo de barras separado por dispositivo. O gráfico exibe um título gerado automaticamente que descreve o eixo atual e a seleção de agrupamento, por exemplo: `speed over device_time (grouped by object_label)`. Quando você modifica as configurações do eixo sem salvar, um indicador de **Alterações não salvas** aparece ao lado do botão **Salvar configurações do gráfico** . Clique nele para manter as alterações de configuração no relatório. ### Mapa de localização A **Mapa de localização** 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); depois disso, não é possível editá-las. Se a consulta não retornar colunas de coordenadas reconhecidas, a seção exibe "Nenhuma coordenada GPS detectada nos resultados da consulta." Para dados telemáticos com marcação de tempo, os pontos plotados representam a trajetória completa de um objeto durante o período consultado. {% hint style="info" %} O mapa é interativo: use zoom e arraste para inspecionar pontos individuais. Clique em **Mostrar tudo** para afastar o zoom e enquadrar todos os pontos plotados dentro da área visível do mapa. {% endhint %} ## Exportação de um relatório O Dashboard Studio oferece dois níveis de exportação. ### Exportação da tabela de dados Use o menu suspenso **para exportar o conjunto completo de resultados como Excel (.xlsx) ou CSV (.csv), independentemente de quantas linhas a visualização interativa exiba.** dentro da **seção Tabela de dados 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 menu suspenso** 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 dicas de ferramenta ao passar o mouse e o mapa de localização suporta zoom e arraste. {% 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 em **Ferramentas** na barra lateral esquerda e, em seguida, selecione **Editar menu**. Localize o relatório na árvore de menu e clique no menu de três pontos ao lado do nome dele; depois, confirme a exclusão. --- # Agent Instructions: 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: ``` GET https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-reports.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.