Capítulo 14: OzAI - Assistente SQL em Linguagem Natural
Info: Este capítulo aborda a geração de consultas SQL a partir de linguagem natural com o OzAI, a otimização de consultas lentas, configuração de IA local e privacidade de dados.
Neste capítulo:
- 14.1 Visão Geral
- 14.2 Geração de SQL a Partir de Linguagem Natural
- 14.3 Otimização de Consultas Lentas e Sugestão de Índices
- 14.4 Configuração de Motores de IA Locais (Ollama, LM Studio)
- 14.5 Segurança, Privacidade e Proteção de Dados
- Tópicos relacionados
14.1 Visão Geral
O OzAI foi desenvolvido para solucionar três entraves na gestão de bancos de dados:
- O tempo despendido em queries complexas: Escrever à mão instruções com múltiplos JOINs, agrupamentos e funções de data em esquemas volumosos consome tempo valioso.
- A identificação de gargalos de desempenho: Localizar varreduras completas (Full Table Scan) e ausência de índices exige inspeções minuciosas.
- A proteção da privacidade corporativa: Serviços de IA em nuvem externa oferecem risco de exposição de credenciais e dados reais de clientes a servidores terceiros.
O OzAI opera sob uma premissa Local-First, rodando os modelos diretamente no hardware do seu Mac.
14.2 Geração de SQL a Partir de Linguagem Natural
- Pressione
Cmd + Kno editor SQL ou clique no ícone OzAI. - Digite sua solicitação em português claro:
“Liste o nome, e-mail e o total gasto pelos clientes cadastrados nos últimos 30 dias que tenham realizado pelo menos 3 pedidos.”
- Pressione Enter ou clique em Gerar Consulta.
Funcionamento interno: O OzAI examina o esquema da conexão atual, inclui esses metadados como contexto da solicitação e retorna código SQL funcional e sintaticamente aderente aos nomes de tabelas e colunas do seu banco.
14.3 Otimização de Consultas Lentas e Sugestão de Índices
- Selecione a consulta no editor.
- Abra a barra OzAI e clique em Otimizar.
- O OzAI retorna um Relatório de Otimização:
- SQL Otimizado: Reescreve subconsultas ineficientes em JOINs e restringe colunas em vez de
SELECT *. - Script de Índice: Apresenta o comando DDL pronto para criar o índice necessário (ex.
CREATE INDEX idx_orders_user ON orders (user_id, created_at);). - Diagnóstico: Explica com clareza o motivo do atraso no plano de execução.
- SQL Otimizado: Reescreve subconsultas ineficientes em JOINs e restringe colunas em vez de
14.4 Configuração de Motores de IA Locais (Ollama, LM Studio)
- Abra SQLOZ → Preferências (
Cmd + ,) → aba OzAI. - Selecione seu motor preferido:
- Ollama (local): ex. Llama 3, DeepSeek-Coder (porta padrão
11434). - LM Studio (local): ex. Qwen 2.5 Coder, DeepSeek R1 (porta padrão
1234).
- Ollama (local): ex. Llama 3, DeepSeek-Coder (porta padrão
- Clique em Buscar Modelos Instalados e valide a conexão.
14.5 Segurança, Privacidade e Proteção de Dados
- Sem envio de registros reais: Apenas os metadados de estrutura (nomes e tipos) são informados ao modelo; o conteúdo das linhas de suas tabelas nunca é transmitido.
- Ocultação de credenciais: Senhas, strings de conexão e tokens são anonimizados antes do envio.
