Text-to-SQL: perguntar ao banco de dados em português
Text-to-SQL, também chamado de NL2SQL, é a técnica que converte uma pergunta em linguagem natural numa consulta SQL. É a base do BI conversacional. Funciona bem em demonstração e falha em produção quando falta contexto sobre os dados.
Atualizado em · Equipe JCLA
Como a conversão funciona
- Contexto. O modelo de linguagem recebe a pergunta junto com a descrição das tabelas, colunas e relacionamentos relevantes.
- Geração. Ele escreve a consulta SQL que responderia à pergunta.
- Execução. A consulta roda no banco, em modo de leitura.
- Apresentação. O resultado é devolvido como tabela, gráfico ou número.
Um exemplo. A pergunta "qual o faturamento de 2026 por mês?" vira algo como:
SELECT date_trunc('month', data_emissao) AS mes,
SUM(valor_total) AS faturamento
FROM vendas
WHERE data_emissao >= DATE '2026-01-01'
AND data_emissao < DATE '2027-01-01'
GROUP BY 1
ORDER BY 1;
O exemplo é ilustrativo. Num ERP real, "faturamento" raramente é a soma de uma coluna: há devoluções, cancelamentos, impostos e tipos de operação a considerar. É aí que o problema começa.
Onde o text-to-SQL erra
- Ambiguidade de negócio. "Faturamento" bruto ou líquido? Por data de emissão ou de entrega? O modelo escolhe uma interpretação e não avisa.
- Esquema de ERP. Centenas de tabelas com nomes abreviados e regras implícitas. Sem documentação, a consulta junta as tabelas erradas e devolve um número plausível.
- Erro silencioso. Uma consulta errada não falha: ela retorna um resultado. É o pior tipo de erro em análise de dados.
- Carga no banco. Consultas geradas livremente podem ser pesadas e competir com a operação.
- Vazamento de acesso. Se o controle de permissão está só na tela, uma pergunta bem formulada alcança dados que a pessoa não deveria ver.
O que torna o resultado confiável
| Risco | Controle |
|---|---|
| Medida interpretada de formas diferentes | Catálogo semântico: cada medida tem uma definição única, mantida pela empresa |
| Esquema confuso do ERP | Dados extraídos para uma estrutura tratada e catalogada antes de qualquer pergunta |
| Erro que passa despercebido | SQL exibido em toda resposta, para conferência |
| Impacto na operação | Consulta sobre a estrutura analítica, nunca sobre o banco transacional |
| Acesso indevido | Filtro por grupo de acesso aplicado na própria consulta, linha a linha |
É assim que o JCLA trabalha: as medidas vêm de um catálogo governado, a consulta roda sobre um Data Lakehouse alimentado por rotinas de extração do ERP, o controle de acesso é aplicado no banco e o SQL acompanha cada resposta.
Construir ou contratar
Montar um protótipo de text-to-SQL leva uma tarde: um modelo de linguagem, a descrição das tabelas e uma conexão de leitura. Levar isso para toda a empresa exige o que o protótipo não tem:
- extração e atualização contínua dos dados do ERP;
- catálogo de medidas com dono e versionamento;
- permissões por pessoa e por grupo;
- painéis, agendamentos e alertas em cima das respostas;
- controle de consumo e de custo do modelo;
- canais de uso além de uma tela de teste.
Para uma equipe de dados com tempo e um esquema bem documentado, construir pode fazer sentido. Para quem quer os gestores perguntando ao ERP sem montar essa estrutura, uma plataforma pronta encurta o caminho.
Perguntas frequentes
01O que é text-to-SQL?
É a técnica que converte uma pergunta escrita em linguagem natural numa consulta SQL executável, usando um modelo de linguagem e a descrição da estrutura do banco de dados. Também é chamada de NL2SQL.
02Text-to-SQL funciona em português?
Sim. Os modelos de linguagem atuais interpretam perguntas em português. A precisão depende menos do idioma e mais da qualidade da descrição dos dados e das definições de cada medida.
03Como saber se a consulta gerada está certa?
Conferindo o SQL. Ferramentas que exibem a consulta junto com a resposta permitem que uma pessoa técnica valide os filtros, as junções e a medida usada. O JCLA exibe o SQL em toda resposta.
04É seguro deixar uma IA consultar o banco do ERP?
É mais seguro quando a consulta roda sobre uma cópia tratada dos dados, em modo de leitura, com o controle de acesso aplicado na consulta. O JCLA não consulta o banco transacional do ERP.