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 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:
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:
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.
Como criar um relatório
Etapa 3: Escreva a consulta SQL
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:
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 a lista completa.
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.
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.
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.
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.
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.
Expanda a Consulta SQL seção para visualizar ou editar a instrução inline.
Aplique as alterações:
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.
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.
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.
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.
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.
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
Documento estático com a tabela de dados, o gráfico e o mapa de localização
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.
Atualizado
Isto foi útil?