# Consultas SQL

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/uZeimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/uZeimage.png)

---

#### ****Criação de Consultas SQL com opção de exibição na tela inicial****

---

> <span style="white-space: pre-wrap;">A funcionalidade de </span>****Consultas SQL****<span style="white-space: pre-wrap;"> do módulo </span>****Estoque****<span style="white-space: pre-wrap;"> do ERP Cronos permite que usuários avançados criem, executem e visualizem relatórios e análises personalizadas diretamente do banco de dados, com base em expressões SQL (Structured Query Language). Essa ferramenta é ideal para quem deseja extrair dados específicos que não estão disponíveis nos relatórios padrão do sistema.</span>

Ela atende à necessidade de análises sob demanda com base nas tabelas de:

- Movimentos (vendas, compras, produção, etc.)
- Clientes e Fornecedores
- Produtos
- Estoque
- Contas a Pagar / Receber
- Entre outros

---

## 🛠️ Como acessar e utilizar as Consultas SQL

### 1. Acessando o módulo

No menu superior do módulo Estoque &amp; Faturamento, vá em &gt; Utilitários &gt; Consultas SQL:

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/E1Jimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/E1Jimage.png)

### 2. Lista de consultas cadastradas

Você verá uma tela com todas as consultas SQL já cadastradas, contendo:

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/gyBimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/gyBimage.png)

- ****Título****<span style="white-space: pre-wrap;"> da consulta</span>
- ****Data de criação/modificação****
- ****Usuário responsável****
- ****Tipo****<span style="white-space: pre-wrap;"> (vinculação com tela, como "MOVIMENTO", "PRODUTO", "CLI/FOR")</span>

---

### 3. Criando ou editando uma consulta

<span style="white-space: pre-wrap;">Clique no ícone de </span>****novo****<span style="white-space: pre-wrap;"> (📄) ou </span>****editar****<span style="white-space: pre-wrap;"> (✏️) para abrir a tela de edição:</span>

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/027image.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/027image.png)

- <span style="white-space: pre-wrap;">Insira o </span>****título****<span style="white-space: pre-wrap;"> da consulta</span>
- <span style="white-space: pre-wrap;">Escolha o </span>****nível de permissão****<span style="white-space: pre-wrap;"> (0 = todos, valores maiores restringem por usuário)</span>
- <span style="white-space: pre-wrap;">Defina o </span>****tipo****<span style="white-space: pre-wrap;"> de consulta (por exemplo, “Tela Inicial - Tabela MOVIMENTO”) - mais à frente explicaremos melhor esta rotina!</span>
- <span style="white-space: pre-wrap;">Insira a </span>****expressão SQL****<span style="white-space: pre-wrap;"> completa no campo abaixo</span>
- <span style="white-space: pre-wrap;">Clique em </span>****Salvar****<span style="white-space: pre-wrap;"> ✅</span>

## 📈 Tipos de Visualização dos Dados

Após executar a consulta, os dados podem ser visualizados de três maneiras:

### a. Dados Principais

Visualização em tabela padrão com agrupamento e filtros.

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/UZsimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/UZsimage.png)

---

### b. Dados Pivotados

<span style="white-space: pre-wrap;">Permite reestruturar os dados dinamicamente por colunas e linhas — como uma </span>****tabela dinâmica****<span style="white-space: pre-wrap;"> do Excel.</span>

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/rI5image.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/rI5image.png)

---

### c. Gráfico

<span style="white-space: pre-wrap;">Com base nos dados pivotados, é possível visualizar </span>****gráficos dinâmicos****<span style="white-space: pre-wrap;"> de colunas, barras, linhas e pizza.</span>

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/OKVimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/OKVimage.png)

## 🧠 Exemplo prático: Pedidos ao Fornecedor nos últimos 3 meses

Consulta SQL exemplo:

```sql
SELECT TOP 20
  Cli_For.NomeCliFor,
  Mov.TotMov,
  Operacao=dbo.fn_DescTipoMov2(TipoMov),
  Mov.DTMOV,
  Mov.NUMMOV
FROM dbo.MOVIMENTO Mov
LEFT JOIN dbo.VENDEDORES Vend ON Mov.CODVENDEDOR = Vend.CODVENDEDOR
LEFT JOIN dbo.CLI_FOR Cli_For ON Mov.CODCLI = Cli_For.CODCLI
WHERE Mov.TipoMov = '1.3'
AND Mov.DataOperacao >= GETDATE() - 90
ORDER BY Mov.DTMOV
```

Esse exemplo traz os pedidos de compra cadastrados nos últimos 3 meses, com valores por fornecedor.

## 🖥️ Consultas SQL na Página Inicial

<span style="white-space: pre-wrap;">Uma funcionalidade avançada permite exibir consultas na </span>****página inicial do Cronos****, à direita, como alertas visuais:

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/L0uimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/L0uimage.png)

1. Ao criar a consulta SQL, marque como tipo:

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/scaled-1680-/JBmimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-06/JBmimage.png)

> `<span class="editor-theme-code">Tela Inicial - Mensagem - Tabela MOVIMENTO</span>`<span style="white-space: pre-wrap;"> (ou outra desejada)</span>

2. Após salvar, a consulta será exibida no painel lateral direito:
    - Exibição por título
    - Atualização em tempo real
    - Ideal para alertas, como pedidos com bloqueio, produtos sem venda, etc.

---

### Finalidade das Consultas SQL

<span style="white-space: pre-wrap;">A funcionalidade de </span>****Consultas SQL****<span style="white-space: pre-wrap;"> no sistema não se limita apenas à visualização de informações em tela.</span>  
<span style="white-space: pre-wrap;">Ela pode também ser utilizada para </span>****realizar alterações em processos ou procedimentos internos****, conforme a lógica definida na consulta.

É importante destacar que:

- <span style="white-space: pre-wrap;">O principal objetivo das consultas é </span>****fornecer acesso rápido e estruturado aos dados****;
- <span style="white-space: pre-wrap;">Quando parametrizadas, podem </span>****interferir em rotinas ou automatizar processos específicos****, de acordo com a necessidade da empresa;
- <span style="white-space: pre-wrap;">A exibição em </span>****gráficos****<span style="white-space: pre-wrap;"> dentro da tela de consultas é apenas um </span>****recurso complementar****<span style="white-space: pre-wrap;"> (</span>**plus**<span style="white-space: pre-wrap;"> do sistema), oferecendo uma visualização mais intuitiva, mas não sendo o foco principal da ferramenta.</span>

## ✅ Boas práticas

- Sempre revise a SQL com o time técnico se tiver dúvidas sobre tabelas ou joins.
- Teste sua consulta no ambiente de homologação.
- <span style="white-space: pre-wrap;">Utilize </span>`<span class="editor-theme-code">TOP</span>`<span style="white-space: pre-wrap;"> e </span>`<span class="editor-theme-code">WHERE</span>`<span style="white-space: pre-wrap;"> para limitar dados retornados.</span>
- Combine com filtros por data (`<span class="editor-theme-code">GETDATE()</span>`), tipo de movimento e filial.