Relatório Sql Personalizado

---
title: Relatório SQL Personalizado
slug: relatorio-sql-personalizado
sistema: 
  - "Sistemas Teorema -> 00001"
categoria: user_manual
tipo: how-to
autor: Andreia B. Bley
setor: Qualidade
modulo: Administrador
publico: ""
keywords:
  - relatório SQL
  - editor de SQL
  - consulta personalizada
  - exportar para Excel
  - utilitários
versao_doc: "01"
revisao: Marcos Zampier
aprovado_em: 28/01/2022
ultima_revisao: "2026-06-13"
chamado: ""
versao_pipeline: 2.7.0
---

## Visão Geral

Permite executar consultas SQL personalizadas no módulo Administrador do Teorema e exportar os resultados para Excel via o Editor de SQL.

## Executar um Relatório SQL Personalizado

### Acessar o módulo Administrador

No Remote Access, clique no ícone **Administrador** para abrir o módulo e efetuar o login.

![Tela de seleção de módulos no Remote Access com opções Administrador, Vendas_pdv, Produção e Gestão Administrativa; seta indicando o ícone Administrador selecionado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/relatorio-sql-personalizado/relatorio-sql-personalizado-01.png)

### Abrir o Editor de SQL

Dentro do módulo Administrador, acesse o menu **Utilitários > E Editor de SQL**.

![Menu Utilitários expandido no módulo Administrador exibindo as opções: A Agenda Telefônica, B Ligações Telefônicas, C Agenda de Compromissos, D Editor de Documentos, E Editor de SQL, F Recados; item E Editor de SQL destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/relatorio-sql-personalizado/relatorio-sql-personalizado-02.png)

### Colar o código SQL

Copie o código SQL de um editor de texto (Ctrl+C) e cole-o na área de edição da aba **Expressão Sql** (Ctrl+V). O Editor de SQL exibe também as abas **Consulta**, os painéis laterais **Arquivos**, **Campos** e **Últimos Comandos Executados**.

![Tela do Editor de SQL com a aba Expressão Sql ativa e área de edição vazia aguardando o código SQL; painéis laterais Arquivos, Campos e Últimos Comandos Executados visíveis à direita](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/relatorio-sql-personalizado/relatorio-sql-personalizado-03.png)

### Ajustar parâmetros do código

Se necessário, edite os parâmetros do código SQL antes de executar. No exemplo abaixo, os valores de data do período de emissão na cláusula `WHERE` devem ser ajustados: `vm.VENDA_DATA_EMISSAO BETWEEN ('2021-09-01') AND ('2021-09-30')`.

![Aba Expressão Sql com código SQL exibindo cláusula WHERE; campos de data ('2021-09-01') e ('2021-09-30') destacados na linha vm.VENDA_DATA_EMISSAO BETWEEN](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/relatorio-sql-personalizado/relatorio-sql-personalizado-04.png)

### Executar a consulta

Clique no ícone **Raio** (Align Right) na barra de ferramentas para executar o código SQL e aguarde o sistema concluir a busca.

![Aba Expressão Sql com tooltip do ícone Raio exibindo "Sistema Integrado Pitágoras - Faturamento / Align Right" na barra de ferramentas; o mesmo código SQL com cláusula WHERE visível](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/relatorio-sql-personalizado/relatorio-sql-personalizado-05.png)

### Exportar o resultado para Excel

Após a execução, o sistema exibe os resultados na aba **Consulta**. Clique com o botão direito sobre a grade de resultados e selecione **Exportar para Excel** para transferir os dados.

![Aba Consulta com grade de resultados exibindo colunas CODIGO, OPERACAO_DESCRICAO, CLIFOR_CODIGO, CLIFOR_NOME, ROTA_DESCRICAO, ITEM_REDUZIDO, ITEM_DESCRICAO, VENDA_QUANTIDADE, VENDA_VALOR_UNITARIO, VENDEDOR_NOME e 6 registros; menu de contexto aberto com opções Imprimir, Armazenar e Recuperar, Contrai Tudo, Expande Tudo, Exportar para Excel, Exportar para Html, Exportar para Texto, Exportar para XML](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/relatorio-sql-personalizado/relatorio-sql-personalizado-06.png)

## Informações do documento

> Autor: Andreia B. Bley
> Setor: Qualidade
> Módulo: Administrador
> Chamado:
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Marcos Zampier
> Aprovado em: 28/01/2022

---

> 📎 **Arquivos originais:** [manual relatório sql personalizado.docx](https://drive.google.com/uc?export=download&id=1KmlFnIED2LhbeanW0Oaamg2qv6jP94zt) · [manual relatório sql personalizado.pdf](https://drive.google.com/uc?export=download&id=197dUiK4lH7LpFy9_sIgehfO8QBhxxDkh)