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

  1. Contexto. O modelo de linguagem recebe a pergunta junto com a descrição das tabelas, colunas e relacionamentos relevantes.
  2. Geração. Ele escreve a consulta SQL que responderia à pergunta.
  3. Execução. A consulta roda no banco, em modo de leitura.
  4. 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

O que torna o resultado confiável

RiscoControle
Medida interpretada de formas diferentesCatálogo semântico: cada medida tem uma definição única, mantida pela empresa
Esquema confuso do ERPDados extraídos para uma estrutura tratada e catalogada antes de qualquer pergunta
Erro que passa despercebidoSQL exibido em toda resposta, para conferência
Impacto na operaçãoConsulta sobre a estrutura analítica, nunca sobre o banco transacional
Acesso indevidoFiltro 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:

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.