O que é o Metabase e para que serve
O Metabase é um app de inteligência de negócios que consulta os bancos dos seus sistemas. Você usa o editor visual para montar consultas e apresentar os resultados em tabelas, gráficos e dashboards.
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
As tabelas do app chegam ao gráfico
Um sistema de atendimento grava conversas no banco para recuperar o histórico quando você abre a tela. A análise procura outra resposta no mesmo conjunto de registros: quantas conversas começaram durante a semana ou como esse volume se distribui por canal. O Metabase acessa o banco por uma conexão própria e executa a consulta que produz esse resultado. O app de atendimento continua gravando as conversas normalmente.
Você escolhe a tabela no editor visual, seleciona o período e agrupa os registros pela coluna desejada. Num banco relacional, o Metabase traduz essas escolhas para SQL e envia o comando ao servidor do banco, que executa o cálculo. O resultado volta em linhas e colunas, que o Metabase apresenta no navegador como tabela ou gráfico.
Pergunta
Você escolhe a tabela e o período no editor visual.
Metabase
O driver traduz a consulta para o banco conectado.
Banco do app
O servidor lê os registros e calcula o resultado.
Gráfico
O Metabase apresenta as linhas retornadas.
Essa separação permite analisar registros de aplicações diferentes com a mesma interface. Um banco PostgreSQL pode guardar as conversas do Chatwoot, enquanto outro sistema usa MySQL. Cada conexão tem suas próprias credenciais e tabelas disponíveis. A existência de duas conexões no Metabase não cria uma junção automática entre esses bancos. Reunir registros de origens distintas exige preparação compatível com o banco consultado.
Perguntas salvas e painéis
A pergunta é a unidade de análise do Metabase. Ela reúne a consulta e a forma de apresentar o resultado, por exemplo, um gráfico de conversas por dia. Quando você guarda a pergunta numa coleção, consegue reutilizá-la em painéis diferentes. Na versão de referência, também existem perguntas guardadas diretamente num dashboard, restritas àquele painel.
O dashboard reúne visualizações numa mesma página. Um filtro de período pode alterar vários gráficos, desde que esteja conectado aos campos correspondentes de cada pergunta. Você vê o volume diário ao lado da distribuição por canal, com o mesmo intervalo de datas. A associação precisa existir: colocar dois gráficos lado a lado não faz o filtro de um alcançar o outro.
A interpretação continua ligada ao significado das colunas: a data de criação mede a abertura de uma conversa, enquanto a data de resolução registra seu encerramento. Mesmo com gráficos parecidos, as perguntas respondem a assuntos diferentes. Você precisa reconhecer qual evento cada coluna registra e como o app atualiza esse registro.
Dois usos diferentes de banco
O Metabase usa um banco da aplicação para guardar sua própria configuração. Nesse banco ficam as perguntas salvas e os dashboards, além dos cadastros e das conexões configuradas. Ele tem uma função diferente dos bancos consultados para análise. Apagar esse armazenamento faz você perder a organização do Metabase mesmo que as tabelas do sistema de atendimento continuem intactas.
Numa instalação de estudo, o banco embutido H2 permite experimentar o app. A documentação recomenda um banco dedicado para uma instalação mantida ao longo do tempo, com preferência por PostgreSQL. O backup desse banco preserva a configuração do Metabase. Os bancos consultados precisam de seus próprios backups, pois o Metabase não substitui a recuperação dos registros originais.
O acesso somente leitura pertence às credenciais usadas para consultar cada origem. Se a conexão do Metabase recebe apenas permissão de leitura, uma consulta não consegue alterar as tabelas por aquela credencial. Recursos que escrevem no banco, como uploads e transforms, têm exigências diferentes e precisam de análise própria. O portal parte do uso de consultas sobre os bancos dos apps.
Onde ele fica na sua VPS
Na instalação em container, o serviço web do Metabase escuta por padrão na porta 3000. O Traefik pode receber o acesso HTTPS do navegador e encaminhá-lo ao serviço pela rede interna. A conexão com o banco segue por outro caminho, diretamente entre o Metabase e o servidor do banco, usando o endereço e as permissões definidos nessa conexão.
Uma consulta extensa consome recursos do banco que a executa. Quando o Metabase consulta o mesmo servidor usado pelo app, o relatório participa da carga desse servidor. Réplicas de leitura ou bancos preparados para análise são alternativas quando o volume justifica essa separação. O atraso da replicação também aparece nos resultados, por isso um painel pode mostrar um registro alguns instantes depois da tela do app.
O Metabase é mantido pela Metabase, Inc. O repositório distingue a edição aberta sob AGPL do código comercial. As edições também diferem nos recursos disponíveis. A pergunta reúne a consulta e sua visualização: você guarda essa definição para consultar novamente o banco e apresentar o resultado em outros painéis.