Perguntas e query builder do Metabase
Uma pergunta do Metabase reúne uma consulta ao banco e a visualização do resultado. No query builder, você escolhe filtros e agrupamentos que o Metabase traduz para a linguagem do banco.
Ficha e sumário da página
- Referência técnica
- Metabase v0.65.4
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
A pergunta tem uma fonte
O editor visual começa com uma tabela, um modelo ou uma pergunta guardada que possa servir de origem. Essa escolha define as colunas disponíveis para a análise. Numa tabela de conversas, por exemplo, você pode ter a data de abertura e o identificador do canal. O editor mostra esses campos conforme os metadados recebidos do banco e as configurações feitas no Metabase.
Uma pergunta sobre o volume diário precisa agrupar a data e calcular a quantidade de registros de cada grupo. A tabela original continua com uma linha por conversa, mas o resultado apresenta uma linha por dia. Esse cálculo acontece no banco consultado. O Metabase recebe a tabela resumida e usa os campos retornados para desenhar o gráfico de linha ou de barras.
O nome da pergunta identifica o evento medido. “Conversas abertas por dia” informa o evento e o agrupamento, enquanto um título como “Atendimento” deixa os dois indefinidos. Você pode guardar uma descrição junto à pergunta para explicar a coluna usada e o período considerado, depois consultar essa explicação ao abrir o resultado pela coleção.
Filtros mudam o conjunto consultado
O filtro restringe quais registros participam da consulta. Com um intervalo selecionado na data de criação, o banco considera as conversas abertas nesse período. Uma conversa antiga resolvida hoje fica fora desse conjunto. O gráfico pode estar tecnicamente correto e ainda responder a uma pergunta diferente da que você pretende acompanhar, porque a escolha da coluna define o evento medido.
Fonte
Tabela com uma linha por conversa.
Filtro
Data de criação dentro do período selecionado.
Resumo
Quantidade de conversas agrupada por dia.
Visualização
Uma barra representa o total de cada dia.
Também existe diferença entre filtrar registros e filtrar resultados agregados. Uma condição aplicada à coluna de data seleciona as linhas de origem. Uma condição sobre o total calculado pode selecionar apenas dias com determinada quantidade de conversas. A ordem dos blocos no query builder deixa essa diferença visível, pois cada operação recebe o resultado das anteriores.
Junções e colunas calculadas
A junção relaciona tabelas do mesmo banco por campos compatíveis. Uma conversa pode trazer o identificador de um canal, enquanto o nome desse canal fica em outra tabela. A junção permite mostrar o nome no resultado sem alterar as tabelas originais. O tipo de junção determina quais linhas permanecem quando uma correspondência falta no outro lado.
Uma relação com várias correspondências exige atenção ao total. Ao unir uma conversa às suas mensagens, a mesma conversa pode aparecer uma vez para cada mensagem encontrada. Somar essas linhas como se cada uma fosse uma conversa aumenta o indicador. Você precisa conhecer a unidade de cada tabela para escolher a agregação adequada, como a quantidade de identificadores distintos.
As colunas calculadas do editor acrescentam expressões à pergunta. Um cálculo entre campos produz uma coluna no resultado, sem adicionar uma coluna física à tabela do app. Assim você experimenta uma diferença entre valores ou uma classificação de registros na própria análise. Os tipos aceitos e as funções disponíveis continuam sujeitos ao suporte do driver e do banco conectado.
SQL continua disponível
O Metabase pode mostrar a consulta nativa gerada pelo query builder, desde que você tenha a permissão correspondente. Em PostgreSQL ou MySQL, essa consulta usa SQL. Você consegue conferir quais tabelas e condições entram no comando enviado ao servidor. Em outros mecanismos, a linguagem nativa pode ser diferente porque o editor visual depende da tradução feita pelo driver.
A conversão de uma pergunta visual para SQL segue em um sentido só. O editor SQL permite escrever uma consulta que usa recursos específicos do banco, mas não reconstrói automaticamente os blocos visuais a partir desse texto. As possibilidades de exploração pelo clique também diferem entre perguntas visuais e nativas. Escolher SQL muda a forma de manter e explorar aquela pergunta.
Guardar para reutilizar
Na versão v0.65.4, uma pergunta guardada em coleção pode aparecer em vários dashboards. Uma pergunta guardada dentro de um dashboard pertence àquele painel e não fica disponível para reutilização em outro. Para apresentar o mesmo indicador em painéis de áreas diferentes, você usa uma pergunta da coleção como origem compartilhada.
O gráfico salvo guarda uma definição de consulta, não uma cópia permanente de todos os registros do app. Uma nova execução pode trazer outro resultado porque o banco mudou ou porque o período relativo avançou. Políticas de cache podem reaproveitar resultados anteriores conforme a configuração disponível. Para organizar uma origem reutilizável com nomes e tipos bem definidos, o Metabase oferece modelos e métricas.