Ir para o conteúdo
Promovaweb

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
  1. A pergunta tem uma fonte
  2. Filtros mudam o conjunto consultado
  3. Junções e colunas calculadas
  4. SQL continua disponível
  5. Guardar para reutilizar

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.

  1. Fonte

    Tabela com uma linha por conversa.

  2. Filtro

    Data de criação dentro do período selecionado.

  3. Resumo

    Quantidade de conversas agrupada por dia.

  4. Visualização

    Uma barra representa o total de cada dia.

A ordem das operações altera o significado do resultado. O filtro seleciona conversas, o agrupamento reúne dias e a agregação calcula 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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.