O que é o Query Builder (Consultas)?
O Query Builder (também chamado de Consultas) é uma funcionalidade que permite consultar os dados já carregados no seu destino Via Kondado (data warehouse) sem escrever SQL. Você monta a consulta visualmente — selecionando tabelas, campos, filtros e cruzamentos — e a plataforma traduz tudo para uma consulta interna chamada KSQL.
Como acessar
Você pode acessar o Query Builder de duas formas:
- Menu lateral: CONSULTAS (ao lado de Integrações, Conectores, Destinos e Modelos)
- Menu CRIAR+ → Consulta
O item de menu fica oculto para usuários em trial que não possuem um destino Via Kondado ativo.
Modos de uso
O Query Builder oferece dois modos de trabalho:
1. Modo Consulta (manual)
Monte sua consulta passo a passo:
- Destino — escolha o destino Via Kondado (Select2 por nome/ID)
- Origem — selecione a tabela de origem (ou outra consulta salva já executada)
- Cruzamentos (JOIN) — adicione joins com outras tabelas ou consultas salvas
- Campos — selecione Dimensões, Métricas e Campos Calculados
- Filtros — defina condições AND/OR, operadores e valores
- Ordenação & Limite — ordene e limite o resultado (máximo 1.000 linhas)
- UNION — combine múltiplas tabelas/consultas
2. Modo Assistente (IA)
Use o assistente de IA embutido para criar consultas a partir de linguagem natural — sem montar nada manualmente:
- Selecione o destino Via Kondado no topo (obrigatório antes de começar)
- Descreva o que quer saber em português (ex: "Quero ver vendas por canal nos últimos 30 dias")
- O assistente analisa seus dados, monta a consulta e a executa automaticamente — o resultado aparece no painel ao lado
- Clique em "Ver consulta" para abrir a consulta gerada na aba Consulta e ajustá-la manualmente, se quiser
- Anexos: você pode anexar arquivos (CSV, Excel, PDF ou imagem) para dar contexto — até 5 MB por arquivo
- Histórico de conversas: cada conversa é salva e pode ser renomeada ou apagada; use "Nova conversa" para recomeçar
- Feedback: avalie cada resposta com 👍 / 👎 para nos ajudar a melhorar o assistente
Ações disponíveis
Após montar e executar sua consulta:
- Executar consulta — roda a consulta e mostra o resultado em tabela
- Salvar consulta — salva para uso futuro (com nome e Custom ID opcional)
- Baixar CSV — exporta o resultado em formato CSV
- Visualizar Dados — abre o modal de conexão para Looker Studio/Power BI
Terminologia
| Conceito | Descrição |
|---|---|
| Campo | Coluna de dados disponível para seleção (use "campo", nunca "coluna") |
| Campos Calculados | Campos criados com expressões personalizadas usando o builder |
| Dimensões | Campos usados para agrupar dados (ex: data, canal, produto) |
| Métricas | Campos numéricos para análise (ex: receita, quantidade) |
| Cruzamentos (JOIN) | União de tabelas/consultas com condições de igualdade |
| Custom ID | Identificador amigável (snake_case) usado em URLs para BI |
Pré-requisitos
- Ter um destino Via Kondado ativo e configurado
- Ter dados já carregados pelo menos uma vez (integrações executadas)
- Para modo Assistente: destino deve ser do tipo Via Kondado (não funciona com outros destinos)
Limites
- Máximo de 1.000 linhas por consulta executada na interface
- Consultas salvas podem ser usadas em dashboards e BI sem limite de linhas
- Campos calculados suportam expressões com operadores matemáticos e funções
Integração com BI e ferramentas de IA
Depois de executar e salvar uma consulta, o botão "Visualizar Dados" abre um modal com as opções de conexão direta:
- Power BI
- Looker Studio
- Claude (via MCP)
- ChatGPT (via MCP)
- Outros — instruções genéricas de conexão
O Custom ID da consulta é usado para identificá-la nas ferramentas de BI. O botão "Visualizar Dados" só fica habilitado depois que a consulta é executada e salva.
Próximos passos
Como criar uma consulta no Query Builder
Monte, execute e salve uma consulta sobre os dados do seu Via Kondado sem escrever SQL.
Abrir Consultas
No menu, clique em CONSULTAS (ou em CRIAR+ e depois Consulta) e inicie uma nova consulta.
Escolher o destino
Selecione o destino Via Kondado e a tabela de origem que deseja consultar.
Montar a consulta
Adicione campos (dimensões e métricas), filtros, cruzamentos (JOIN) e ordenação. Como alternativa, use o Modo Assistente e descreva o que quer em linguagem natural.
Executar
Clique em Executar consulta e confira o resultado na tabela (até 1.000 linhas).
Salvar e conectar
Clique em Salvar consulta, dê um nome e um Custom ID; depois use Visualizar Dados para conectar ao Power BI, Looker Studio, Claude ou ChatGPT.
