> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datasnap.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta de Dados

> Como consultar e analisar seus dados no DataSnap através da interface SQL interativa

## Interface de Consulta SQL

O DataSnap oferece uma tela de consulta interativa que permite gerar consultas SQL de forma dinâmica para analisar seus dados, proporcionando flexibilidade total na exploração dos dados.

<Info>
  Acesse a interface em [app.datasnap.cloud](https://app.datasnap.cloud) com suas credenciais da plataforma.
</Info>

## Recursos disponíveis

### Editor SQL Interativo

A interface oferece um editor completo para suas consultas:

* **Syntax highlighting**: Destaque de sintaxe SQL para melhor legibilidade
* **Autocomplete**: Sugestões automáticas de tabelas, colunas e funções
* **Validação em tempo real**: Verificação de erros de sintaxe durante a digitação
* **Execução rápida**: Execute consultas com um clique e visualize resultados instantaneamente

### Gerenciamento de Consultas

Salve e organize suas consultas para reutilização:

* **Salvar consultas**: Guarde consultas frequentes para uso posterior
* **Organização por categorias**: Organize suas consultas salvas em grupos
* **Histórico de execuções**: Acesse consultas executadas recentemente
* **Compartilhamento**: Compartilhe consultas com outros usuários da equipe

## Funcionalidades da Interface

### Editor de Consultas

Crie consultas SQL complexas com facilidade:

1. **Escrever SQL**: Digite diretamente suas consultas no editor
2. **Selecionar esquemas**: Escolha o schema dos seus dados
3. **Executar consultas**: Execute e visualize resultados em tabela
4. **Exportar resultados**: Baixe os resultados em diferentes formatos

### Exemplos de uso

#### Análise de vendas por região

```sql theme={null}
-- Consulta para análise por região
SELECT 
    regiao,
    COUNT(*) as total_vendas,
    SUM(valor) as receita_total,
    AVG(valor) as ticket_medio
FROM vendas 
WHERE event_from >= '2024-01-01' AND event_to <= '2024-12-31'
GROUP BY regiao
ORDER BY receita_total DESC;
```

**Na interface**: Digite a consulta no editor, execute e visualize os resultados em tabela. Salve esta consulta como "Vendas por Região" para reutilização.

#### Top produtos mais vendidos

```sql theme={null}
-- Consulta para produtos mais vendidos
SELECT 
    produto,
    COUNT(*) as quantidade_vendida,
    SUM(valor_total) as receita
FROM pedidos 
WHERE event_from >= '2024-01-01' AND event_to <= '2024-12-31'
GROUP BY produto 
ORDER BY quantidade_vendida DESC 
LIMIT 10;
```

**Na interface**: Execute esta consulta para obter os top produtos e salve-a em sua biblioteca de consultas para análises futuras.

## Exportação de resultados

<Info>
  **Em breve**: A funcionalidade de exportação de resultados será disponibilizada em breve.
</Info>

### Formatos disponíveis

Exporte os resultados de suas consultas em diversos formatos:

* **CSV**: Para análise em planilhas como Excel ou Google Sheets
* **JSON**: Para integração com outras aplicações e APIs
* **TXT**: Para análises simples em editores de texto

### Salvamento de consultas

Gerencie suas consultas para reutilização futura:

```sql theme={null}
-- Exemplo de consulta salva
-- Nome: "Vendas Mensais por Região"
-- Categoria: "Relatórios de Vendas"
SELECT 
    DATE_FORMAT(data_venda, '%Y-%m') as mes,
    regiao,
    SUM(valor) as total_vendas,
    COUNT(*) as quantidade_pedidos
FROM vendas 
WHERE status = 'concluido'
  AND event_from >= '2024-01-01' 
  AND event_to <= '2024-12-31'
GROUP BY DATE_FORMAT(data_venda, '%Y-%m'), regiao
ORDER BY mes DESC, total_vendas DESC;
```

## Integrações com ferramentas externas

<Info>
  **Em breve**: A integração com ferramentas externas será disponibilizada em breve.
</Info>

### Exportação para ferramentas de análise

Utilize os dados exportados em suas ferramentas favoritas:

**Power BI:**

1. Exporte seus resultados em formato CSV
2. Importe o arquivo no Power BI
3. Crie suas visualizações personalizadas

**Excel/Google Sheets:**

1. Execute sua consulta na interface
2. Exporte os resultados em CSV
3. Abra diretamente em planilhas para análises

### API para integrações personalizadas

Use a API do DataSnap para integrar com suas próprias aplicações:

```python theme={null}
# Exemplo de integração via API
import requests

def executar_consulta_salva(nome_consulta):
    url = f"https://api.datasnap.cloud/api/v1/schemas/{nome_consulta}/query"
    headers = {"Authorization": "Bearer seu_token"}
    
    response = requests.post(url, headers=headers)
    return response.json()

# Executar consulta salva
resultado = executar_consulta_salva("vendas-mensais-por-regiao")
```

## Recursos futuros

### Visualizações e gráficos (em desenvolvimento)

Estamos trabalhando em recursos de visualização que estarão disponíveis em breve:

<Info>
  **Em desenvolvimento**: Funcionalidades de gráficos e visualizações estarão disponíveis em versões futuras do DataSnap.
</Info>

**Recursos planejados:**

* **Gráficos interativos**: Gráficos de linha, barras, pizza e mapas de calor
* **Dashboard visual**: Interface para criar painéis com suas consultas salvas
* **Visualizações automáticas**: Geração automática de gráficos baseados nos resultados
* **Exportação de gráficos**: Salvar visualizações em formatos de imagem

### Como se preparar

Enquanto as visualizações não estão disponíveis, você pode:

1. **Salvar consultas importantes**: Organize suas análises mais utilizadas
2. **Categorizar consultas**: Agrupe por tipo de análise ou departamento
3. **Documentar consultas**: Adicione comentários explicativos em suas consultas SQL
4. **Exportar dados**: Use os formatos CSV/JSON para criar visualizações em ferramentas externas

## Boas práticas

### Performance de consultas

<AccordionGroup>
  <Accordion title="Otimize suas consultas SQL">
    Use técnicas de otimização para consultas mais rápidas:

    ```sql theme={null}
    -- Use LIMIT para limitar resultados
    SELECT produto, SUM(valor) as total_vendas
    FROM vendas 
    WHERE data_venda >= '2024-01-01'
      AND event_from >= '2024-01-01' 
      AND event_to <= '2024-12-31'
    GROUP BY produto
    ORDER BY total_vendas DESC
    LIMIT 100;

    -- Use índices em campos de filtro
    -- Prefira WHERE com campos indexados
    ```
  </Accordion>

  <Accordion title="Organize consultas salvas">
    Mantenha sua biblioteca de consultas organizada:

    * **Nomes descritivos**: Use nomes que expliquem o propósito da consulta
    * **Categorização**: Organize por departamento ou tipo de análise
    * **Comentários**: Documente consultas complexas com comentários SQL
    * **Versionamento**: Salve versões diferentes para comparação
  </Accordion>
</AccordionGroup>

### Gestão de dados

<Card title="🚀 Acelere seu Desenvolvimento!" icon="zap" color="#ffffff">
  **Use nossa tela de consultas interativa para construir queries visualmente!**

  🎯 **Acesse o painel DataSnap** e construa suas consultas selecionando campos e aplicando filtros. O sistema gera automaticamente o JSON da API para você!

  ✨ **Vantagens:**

  * ✅ **Interface visual intuitiva** - sem necessidade de escrever SQL
  * ✅ **Geração automática do código** - copie e use diretamente na API
  * ✅ **Preview em tempo real** - veja resultados antes de executar
  * ✅ **Histórico de consultas** - salve e reutilize suas análises
  * ✅ **Construtor de métricas** - crie agregações complexas facilmente

  🔗 **Acesse:** [Painel DataSnap](https://app.datasnap.cloud) → Modelo de Dados → Modelo → Consultar Registros

  *Desenvolvimento mais rápido e sem erros de sintaxe!*
</Card>

Otimize o trabalho com seus dados:

* **Filtros eficientes**: Use filtros de data e categoria para reduzir volume
* **Agregações**: Prefira SUM, COUNT, AVG para análises resumidas
* **Exportação seletiva**: Exporte apenas os dados necessários

## Próximos passos

<CardGroup cols={2}>
  <Card title="Consultas avançadas" icon="magnifying-glass" href="/api-reference/endpoint/schema-query-endpoint">
    Aprenda a criar consultas complexas para suas visualizações
  </Card>

  <Card title="Exemplos de código" icon="code" href="/essentials/code">
    Implemente integrações customizadas com suas ferramentas
  </Card>
</CardGroup>