Escrever consultas SQL do zero exige lembrar de sintaxe, nomes de tabelas e condições de junção. O Notion AI pode traduzir descrições em português para código SQL funcional dentro de qualquer página do Notion. Isso economiza tempo para gerentes de produto, analistas de dados e desenvolvedores que precisam de consultas rápidas sem trocar de ferramenta. Este artigo explica como configurar o Notion AI, escrever prompts eficazes e gerar consultas SQL precisas.
Principais Conclusões: Gerando Consultas SQL com o Notion AI
- Notion AI > Ask AI to write: Abre o assistente de IA para aceitar um prompt em português para qualquer consulta SQL.
- Estrutura do prompt — tipo de banco + colunas + condições: Ajuda o Notion AI a gerar cláusulas SELECT, JOIN, WHERE e GROUP BY precisas.
- Revisão e teste manuais: Sempre verifique o SQL gerado no seu cliente de banco de dados antes de executá-lo em dados de produção.
Como o Notion AI Gera SQL a Partir de Linguagem Natural
O Notion AI usa um modelo de linguagem grande treinado em código e documentação. Quando você digita um prompt como “mostrar todos os clientes que compraram nos últimos 30 dias”, a IA identifica os elementos-chave: a tabela (clientes), a ação (mostrar), o filtro (últimos 30 dias) e a coluna (data da compra). Em seguida, constrói uma consulta SQL usando sintaxe padrão.
A IA não tem acesso ao esquema real do seu banco de dados. Ela depende inteiramente das informações que você inclui no prompt. Se você omitir nomes de tabelas ou colunas, a IA pode adivinhar, o que pode gerar consultas incorretas. Para melhores resultados, inclua o tipo de banco (MySQL, PostgreSQL, SQL Server ou SQLite), nomes de tabelas, nomes de colunas e o formato de saída desejado.
O Que Você Precisa Antes de Usar o Notion AI para SQL
Você precisa de um workspace do Notion com recursos de IA habilitados. O Notion AI está disponível nos planos Plus, Business e Enterprise, e como complemento pago para o plano Free. Você também precisa de uma descrição clara da consulta desejada. Se você tem um esquema de banco de dados específico, anote os nomes das tabelas e colunas para colá-los no prompt.
Passos para Gerar uma Consulta SQL Usando o Notion AI
- Abra uma página do Notion e posicione o cursor onde deseja o código SQL
Navegue até qualquer página existente ou crie uma nova página usando o botão + New Page na barra lateral. Clique dentro do corpo da página para posicionar o cursor piscante no local exato onde a consulta SQL gerada deve aparecer. - Ative o Notion AI
Pressione a tecla Space no teclado e selecione Ask AI to write no menu pop-up. Alternativamente, digite uma barra / e escolha AI > Ask AI to write. A caixa de entrada da IA abre na posição do cursor. - Escreva um prompt detalhado em português
Na caixa de entrada da IA, digite um prompt que inclua o tipo de banco, nome da tabela, colunas, condições e ordenação. Exemplo: “Escreva uma consulta MySQL para selecionar first_name, last_name e email da tabela customers onde signup_date é posterior a 2023-01-01. Ordene por last_name ascendente.” Seja o mais específico possível. - Pressione Enter para gerar a consulta SQL
Após digitar o prompt, pressione Enter. O Notion AI processa o texto e insere o código SQL gerado na página. O código aparece em um bloco de código com realce de sintaxe. - Revise e edite o SQL gerado
Leia a consulta linha por linha. Verifique nomes de tabelas, nomes de colunas, condições JOIN e cláusulas WHERE. Se a consulta usar aliases, confirme se correspondem ao seu esquema. Edite partes incorretas diretamente no bloco de código. - Teste a consulta no seu cliente de banco de dados
Copie o código SQL do Notion e cole-o na sua ferramenta de gerenciamento de banco de dados, como MySQL Workbench, pgAdmin ou DBeaver. Execute a consulta em um banco de teste ou staging para confirmar que retorna os resultados esperados. Nunca execute SQL gerado em um banco de produção sem testar.
Exemplos de Prompts para Padrões Comuns de SQL
Os exemplos a seguir mostram prompts que produzem consultas SQL confiáveis:
- SELECT simples: “Escreva uma consulta PostgreSQL para selecionar product_name e price da tabela products onde price é maior que 50.”
- JOIN entre duas tabelas: “Escreva uma consulta SQL Server para selecionar order_id, customer_name e order_date da tabela orders juntada com a tabela customers em customer_id. Mostre apenas pedidos feitos em 2024.”
- GROUP BY com agregação: “Escreva uma consulta MySQL para contar o número de pedidos por cliente. Mostre customer_id e order_count. Agrupe por customer_id.”
- Subconsulta: “Escreva uma consulta PostgreSQL para selecionar produtos onde o preço é maior que a média de preços de todos os produtos. Use uma subconsulta.”
Erros Comuns e Limitações ao Usar o Notion AI para SQL
O SQL gerado usa nomes de tabelas ou colunas errados
O Notion AI não conhece o esquema do seu banco de dados. Se você escrever um prompt vago como “mostrar dados do usuário”, a IA pode inventar nomes de tabelas como “users” ou “user_data” que não existem no seu banco. Para evitar isso, sempre inclua os nomes exatos das tabelas e colunas do seu esquema no prompt. Se você tiver muitas colunas, liste explicitamente as que precisa.
A IA produz erros de sintaxe para dialetos específicos de banco
O Notion AI pode usar sintaxe SQL genérica. Por exemplo, pode usar TOP em vez de LIMIT para SQL Server, ou perder operadores específicos do PostgreSQL como ILIKE. Sempre especifique o tipo de banco no início do prompt. Após a geração, verifique a sintaxe específica do dialeto, como funções de data, concatenação de strings e cláusulas de limite.
Consultas complexas com múltiplos CTEs ou funções de janela falham
O Notion AI lida bem com consultas simples e moderadamente complexas, mas tem dificuldades com expressões de tabela comum de vários níveis, consultas recursivas e funções de janela avançadas. Nesses casos, divida a consulta em partes menores. Gere cada parte separadamente e combine-as manualmente no seu cliente de banco de dados.
Notion AI Free vs Plus vs Business: Limites de Geração de SQL Comparados
| Item | Plano Free (Add-on AI) | Planos Plus / Business / Enterprise |
|---|---|---|
| Limite de respostas da IA | 30 respostas por membro por mês | Respostas ilimitadas |
| Tamanho máximo do prompt | Aproximadamente 2.000 caracteres | Aproximadamente 2.000 caracteres |
| Saída em bloco de código | Suportado — SQL aparece em um bloco de código | Suportado — SQL aparece em um bloco de código |
| Custo | $10 por membro por mês | Incluso no custo do plano |
Se você gera SQL com frequência, o limite mensal do plano Free pode ser insuficiente. Considere atualizar para um plano Plus ou Business para remover o limite. Todos os planos suportam os mesmos recursos de IA, incluindo geração de código e realce de sintaxe.
Após gerar uma consulta, você pode pedir ao Notion AI para explicar o SQL com um prompt complementar como “Explique esta consulta passo a passo.” Isso ajuda a entender o código gerado e aprender padrões SQL. Você também pode usar a opção Ask AI to edit para modificar uma consulta existente, por exemplo, adicionando uma cláusula WHERE ou alterando a ordem de classificação.