Conexões com bancos no Metabase
Uma conexão do Metabase dá acesso às tabelas de um banco para análise. Você define as credenciais e os privilégios dessa conexão para limitar o que o Metabase pode consultar.
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 conexão sai do servidor do Metabase
O navegador conversa com a interface do Metabase, mas a conexão com o banco parte do servidor que executa o app. O endereço do banco precisa ser alcançável a partir desse servidor. Num ambiente com containers, um nome disponível na rede interna pode servir como endereço. O fato de você alcançar o banco no seu computador não comprova que o container do Metabase alcança o mesmo destino.
A conexão informa o tipo de banco e os detalhes necessários à autenticação. PostgreSQL e MySQL têm drivers próprios, que tratam os comandos e as respostas de cada sistema. A documentação diferencia drivers mantidos pelo projeto dos oferecidos pela comunidade. Uma função do editor pode depender do suporte do driver à versão do banco conectado.
Você pode conectar o banco de um app sem entrar pela interface desse app. O Metabase consulta as tabelas acessíveis à credencial configurada, conforme a estrutura real do banco. Isso exige conhecer o significado dos registros. Um número usado internamente para representar um status não vira uma descrição de atendimento apenas porque aparece no editor visual.
A credencial delimita a leitura
A documentação recomenda uma credencial dedicada com os privilégios necessários à análise. Para perguntas comuns, o acesso de leitura evita que essa conexão altere tabelas do app. Compartilhar a credencial administrativa amplia o que o Metabase pode executar no banco. A restrição precisa existir no servidor do banco, pois esconder um botão na interface não muda os privilégios da conexão.
MetabaseServidor que recebe as perguntas do navegador.Banco da aplicaçãoGuarda perguntas, dashboards e configuração.PostgreSQL do appConexão dedicada para consultar registros permitidos.MySQL do appOutra conexão, com credencial e permissões próprias.
Alguns recursos precisam escrever na origem. Uploads, ações e determinados mecanismos de preparação de tabelas não seguem o mesmo contrato de uma consulta somente leitura. Ativar um desses recursos exige conferir o banco compatível e os privilégios correspondentes. A conexão inicial de análise não deve ser apresentada como suficiente para qualquer função disponível no Metabase.
Você também pode limitar os schemas e as tabelas que a credencial enxerga. Isso reduz o conjunto disponível para consulta na própria origem. As permissões do Metabase acrescentam a divisão entre grupos dentro da aplicação, mas trabalham sobre o acesso que a conexão já possui. Você confere essas duas configurações para entender por que consegue consultar uma tabela com determinado login.
Sincronizar a estrutura não copia o banco inteiro
O Metabase sincroniza metadados para reconhecer tabelas e colunas. Essa leitura permite preencher o editor visual com os campos existentes e seus tipos. O processo de varredura de valores atende funções como listas de seleção nos filtros. São atividades diferentes da execução de uma pergunta e podem ter programação própria na configuração da conexão.
Quando o app recebe uma coluna nova, o Metabase pode precisar sincronizar a estrutura para apresentá-la na interface. Uma pergunta SQL que referencia a coluna e uma lista de campos ainda desatualizada podem, por isso, mostrar comportamentos diferentes. Você precisa distinguir a estrutura já existente no banco da estrutura que o Metabase reconheceu em sua última sincronização.
Esses processos também leem a origem e consomem recursos. O custo varia conforme o tamanho das tabelas e a configuração de varredura. Executar a varredura várias vezes não acrescenta valores novos quando a origem permanece igual. A documentação permite ajustar a sincronização e a varredura para que o reconhecimento dos campos acompanhe a rotina do banco sem repetir leituras desnecessárias.
Consultas competem pelos recursos da origem
Um relatório com agrupamentos extensos exige trabalho do servidor do banco. Se o app usa o mesmo servidor para gravar e recuperar registros durante o atendimento, as consultas analíticas participam dessa carga. O Metabase não torna uma consulta pesada barata apenas por construí-la visualmente. Índices e estrutura das tabelas continuam influenciando o tempo de resposta.
Uma réplica de leitura pode separar parte dessa carga, quando o banco oferece esse recurso e a arquitetura o comporta. O resultado acompanha o atraso de replicação. Você pode ver uma conversa na tela do app e ainda não encontrá-la no relatório consultado pela réplica. Esse intervalo precisa ser entendido como característica da origem escolhida, não como uma promessa de atualização imediata do painel.
Bancos diferentes continuam separados
O Metabase aceita várias conexões, mas uma junção no query builder relaciona tabelas do mesmo banco. Unir registros de aplicações hospedadas em servidores diferentes exige uma origem preparada para essa análise ou recursos específicos do mecanismo consultado. Adicionar duas conexões à interface não reúne fisicamente suas tabelas nem estabelece correspondência entre os identificadores de clientes.
Os portais de PostgreSQL e MySQL explicam o funcionamento dessas origens. Dentro do Metabase, os modelos ajudam a apresentar consultas reutilizáveis sobre uma fonte já disponível. A configuração da conexão define como a consulta chega ao servidor. A preparação da origem define quais relações entre registros você consegue analisar.