Como gerar a consulta SQL de um cubo com IA no HubCount BI Studio

Escreva em português o que você quer ver. A IA lê a estrutura das tabelas que você escolher e devolve a consulta SQL do cubo, pronta para revisar.

Quando usar

• Você conhece o negócio, mas não escreve SQL, ou quer ganhar tempo com junções entre tabelas.
• Você quer um ponto de partida e depois ajustar a consulta à mão.
• Você já tem uma consulta e quer mudá-la com um pedido curto, como “inclua só os pedidos faturados”.

Isso vale para cubos de banco de dados, que leem os dados por uma consulta SQL. Cubos de planilha, API e webhook não têm consulta SQL.

Antes de começar:

• Tenha uma conexão com banco de dados (SQL Server, PostgreSQL, MySQL e outros) e um cubo criado a partir dela.
• Abra o cubo e espere a Árvore de Objetos carregar as tabelas, à esquerda do editor.

Onde fica

O botão de estrelas está na barra do editor de consulta, no canto direito. Passe o mouse para ver Gerar SQL com IA. Ao criar um cubo de banco pelo assistente de novo cubo, o mesmo botão aparece no passo da consulta.

Botão da barra	O que faz
Estrelas, Gerar SQL com IA	Abre o gerador de SQL com IA.
Raio, Executar Consulta	Roda a consulta. Atalho F5.
Quadrado, Cancelar execução da consulta	Cancela uma consulta em andamento.
Pincel, Formatar Consulta	Arruma a indentação do SQL. Atalho Ctrl + Shift + F.

Gerar a consulta

Depois de salvar, abra a aba Mapeamento de Campos para escolher os campos que a consulta trouxe. Veja Campos do cubo.

Opções do gerador

A janela tem dois passos, Configurar e Revisar (nomes fixos no produto, mostrados no topo).

Opção	O que faz	Observações
Tabelas	Define o que a IA enxerga do banco.	De 1 a 10 tabelas. Tabelas e views ficam em grupos separados, com a etiqueta VIEW nas views. Sem tabela escolhida, o botão de gerar fica desabilitado.
Refinar SQL atual	Muda o SQL que está no editor em vez de escrever um novo.	Só aparece quando o editor tem SQL. Continua sendo preciso escolher tabelas. A janela mostra o começo do SQL atual.
Sugestões de pedido (IA)	Exemplos de pedido feitos pela IA a partir das tabelas e colunas escolhidas.	Aparecem depois de escolher tabelas, com um pequeno atraso. Clicar insere o texto no pedido, e acrescenta numa nova linha se já houver texto.
Descreva sua consulta	O pedido em linguagem natural.	Obrigatório.
Gerar Consulta	Envia o pedido e mostra o SQL no passo de revisão.	Atalho Ctrl + Enter.
Voltar ao prompt	Volta ao pedido para ajustar e gerar de novo.	O pedido e as tabelas continuam preenchidos.
Aplicar no editor	Coloca o SQL (com as suas edições) no editor.	Troca o texto que estava no editor.

O texto do pedido, as tabelas escolhidas e a opção de refinar ficam guardados neste navegador, por cubo (ou por conexão), para você continuar depois.

O que a IA recebe

• O seu pedido.
• Dos objetos escolhidos: o nome, as colunas com o tipo de cada uma, as chaves primárias e as chaves estrangeiras (para sugerir junções).
• O tipo do banco (SQL Server, PostgreSQL e outros), para escrever no dialeto certo.
• O SQL atual, só quando você liga Refinar SQL atual.

A IA não recebe as linhas de dados das tabelas. Ela só escreve consultas de leitura (SELECT, com WITH quando precisa). Nada é executado até você rodar a consulta.

Como pedir melhor

• Diga o período, os agrupamentos e os totais que você quer ver.
• Escolha só as tabelas necessárias. Menos tabelas deixam a resposta mais precisa. Inclua as tabelas de cadastro (vendedor, cliente) quando quiser nomes em vez de códigos.
• Use os nomes que aparecem na árvore de objetos quando souber, como “tabela pedidos, coluna data_pedido”.
• Peça colunas pensando no cubo: uma data, uma ou mais categorias (unidade, vendedor) e os números (receita, custo). É assim que a IA monta o resultado.
• Se a consulta traz dados de mais de uma empresa do projeto, peça também a coluna que identifica a empresa. Depois de aplicar, marque essa coluna como Id da Empresa no mapeamento. Veja Campos do cubo.
• Para ajustar, ligue Refinar SQL atual e peça só a mudança: “inclua só os pedidos faturados” ou “agrupe também por região”.

Exemplo: receita e custo por unidade

No projeto “Resultado Comercial 2026” da Contabilidade Exemplo, o ERP da Aurora Comércio Ltda tem as tabelas dbo.pedidos e dbo.vendedores. Escolha as duas e peça:

Receita e custo por mês e por unidade em 2026, com a quantidade de pedidos e o nome do vendedor

A IA devolve um SELECT que junta as duas tabelas pelo código do vendedor, filtra 2026 e nomeia as colunas (receita, custo, vendedor). Rode a consulta, confira os números com alguém do financeiro e salve. Depois crie as medidas Receita e Custo sobre os campos novos.

Limites e mensagens

Mensagem	Causa e solução
Nenhuma tabela disponível. Por favor, expanda as tabelas no explorador para carregar a estrutura do banco de dados.	A lista de tabelas ainda não carregou. Abra o cubo, espere a Árvore de Objetos carregar e tente de novo.
Número máximo de tabelas atingido (10)	Tire uma tabela antes de escolher outra.
Nenhuma sugestão no momento. Verifique a conexão ou altere as tabelas selecionadas.	As sugestões não vieram. Você ainda pode escrever o pedido à mão.
Erro ao criar consulta gerada por IA.	A geração falhou. Tente de novo em instantes.
Não foi possível carregar o esquema das tabelas selecionadas.	O HubCount BI Studio não conseguiu ler as colunas. Teste a conexão em Fontes de Dados.

• A IA pode errar. Confira o SQL, rode a consulta e valide os totais antes de montar dashboards em cima dela.
• No navegador, as tabelas e colunas são lidas por um servidor da HubCount, então o banco precisa aceitar conexões vindas da internet. Veja Bancos de dados.
• A consulta substitui o SQL do editor. Se quiser guardar a versão anterior, copie-a antes de aplicar.

Próximos passos

• Escolha e ajuste os campos que a consulta trouxe em Campos do cubo.
• Crie as medidas do cubo.
• Para gerar um dashboard inteiro por pedido, veja Dashboard com IA.