Modelos e métricas no Metabase
Um modelo do Metabase é uma consulta reutilizável com descrições e tipos definidos para suas colunas. Você usa modelos como origem de novas perguntas e métricas para compartilhar fórmulas de agregação entre elas.
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
Uma origem preparada para novas perguntas
Uma tabela do app costuma refletir como o sistema grava os registros. Ela pode trazer identificadores internos e nomes de colunas que fazem sentido no código, mas exigem explicação durante a análise. O modelo permite preparar uma consulta com os campos necessários e apresentar essa consulta como origem para novas perguntas. Você usa o resultado sem montar novamente as junções que o produziram.
Um modelo de conversas pode relacionar a tabela de atendimento à tabela de canais e devolver a data de abertura junto ao nome do canal. Você encontra esses campos numa mesma origem ao construir o próximo gráfico. A consulta do modelo continua responsável pela relação entre as tabelas. Se essa relação multiplica linhas, o erro também se propaga para as perguntas derivadas.
O modelo acrescenta metadados às colunas retornadas. Você pode descrever o significado de um campo e informar seu tipo semântico, permitindo que o Metabase reconheça uma categoria ou uma referência. Esses metadados orientam a experiência de exploração. Uma coluna que representa um identificador exige tratamento diferente de uma coluna que representa uma quantidade, ainda que as duas usem números.
O modelo participa da consulta
Por padrão, um modelo é uma definição reutilizável no Metabase. Ele não cria uma tabela nova no banco apenas por existir. Quando você faz uma pergunta sobre o modelo, o sistema usa essa definição na consulta enviada à origem. A organização visual pode simplificar a construção das perguntas sem reduzir, por si só, o trabalho que o servidor executa.
Tabelas
Conversas e canais no banco do app.
Modelo
Consulta que reúne os campos úteis à análise.
Métrica
Fórmula compartilhada para calcular um indicador.
Perguntas
Gráficos agrupados por período ou canal.
A persistência de modelos grava os resultados em tabelas de um schema no banco consultado. Na v0.65.4, o recurso atende PostgreSQL, MySQL e Redshift, com atualização por programação e privilégios de escrita nesse schema. Ele não funciona junto à segurança por linha e coluna ou à impersonação de conexão. Uma credencial somente leitura atende consultas comuns, mas não permite criar e atualizar essas tabelas.
Você também precisa distinguir o horário de atualização do modelo persistido do horário de gravação do app. Um registro novo pode existir na tabela original e ainda não aparecer no resultado materializado. Essa diferença explica por que dois gráficos construídos sobre origens diferentes podem mostrar totais distintos durante o intervalo de atualização, mesmo usando o mesmo cálculo.
A métrica guarda a fórmula
Uma métrica associa uma fórmula de agregação a uma fonte. Ela pode representar a quantidade de conversas resolvidas ou uma média calculada sobre uma coluna, conforme a definição que você registra. O query builder disponibiliza essa métrica nas perguntas construídas sobre a fonte correspondente. Por trás da interface, o Metabase substitui a referência pela fórmula guardada.
A pergunta referencia a fórmula da métrica, por isso você mantém a expressão num único lugar. Se cada painel escreve sua própria expressão para conversas resolvidas, uma diferença no tratamento do status pode produzir indicadores incompatíveis. Uma métrica compartilhada concentra a fórmula. A descrição precisa explicar quais registros entram no cálculo, pois um nome igual não torna duas definições equivalentes.
As dimensões permitem distribuir ou filtrar a métrica. Uma quantidade total pode ser apresentada por dia ou por canal, desde que a fonte forneça esses campos. Você mantém a agregação e altera o agrupamento para responder a outra pergunta. A métrica não permite aplicar sua fórmula a qualquer tabela arbitrária porque a ligação com a fonte faz parte da definição.
A unidade da linha determina o resultado
Considere um modelo com uma linha por mensagem. A quantidade de linhas mede mensagens, mesmo que a consulta também traga o identificador da conversa. Para medir conversas, a agregação precisa considerar essa unidade diferente. Você pode registrar “uma linha por mensagem” na descrição do modelo para explicitar a unidade usada na consulta e conferir a agregação durante a revisão do gráfico.
Valores ausentes também interferem na análise. Uma média de tempo de resolução considera apenas os registros para os quais esse tempo está disponível, conforme a expressão utilizada. Se as conversas ainda abertas não têm horário de resolução, elas não representam durações concluídas. Você precisa explicar essa condição junto ao indicador para que o painel não sugira que acompanha todas as conversas da mesma forma.
Mudanças alcançam as perguntas derivadas
Renomear ou remover uma coluna do modelo pode afetar perguntas que usam esse campo. Alterar a fórmula de uma métrica pode mudar o resultado de vários gráficos sem mudar seus títulos. O trabalho de manutenção inclui conferir as perguntas dependentes e a interpretação dos números apresentados. Recursos de verificação de dependências variam por edição e não substituem essa conferência.
A versão de referência deste portal é a v0.65.4. Nela, a documentação apresenta transforms como sucessores dos modelos e indica uma substituição gradual. Um transform produz uma tabela no banco e atualiza seu conteúdo por programação, portanto envolve escrita e manutenção dessa tabela. Os modelos continuam documentados, mas uma instalação nova precisa conferir essa alternativa e os recursos disponíveis na edição utilizada.
Modelos e métricas precisam ser entendidos pelo comportamento disponível na sua instalação. Quando as definições estão preparadas, os dashboards e alertas usam as perguntas resultantes para reunir indicadores e acompanhar suas mudanças.