Resumo direto

Arquitetura multi-tenant é o padrão em que uma única aplicação atende vários clientes (tenants) mantendo os dados de cada um isolados. Existem três modelos principais — banco dedicado por tenant, schema dedicado por tenant e banco compartilhado com coluna de tenant — e a escolha entre eles é uma troca direta entre isolamento/segurança e custo operacional, não uma questão de qual é 'melhor' de forma absoluta.

Multi-tenant é o modelo por trás de praticamente todo SaaS: uma única aplicação, um único código-fonte em produção, atendendo múltiplos clientes — os "tenants" — que não podem, sob nenhuma circunstância, ver o dado uns dos outros. A pergunta que qualquer time técnico enfrenta cedo não é se vai ser multi-tenant, mas como o isolamento entre esses clientes vai ser garantido no nível de dados.

Existem três modelos consolidados para resolver isso, e cada um troca isolamento por operação de forma diferente.

Modelo 1: banco de dados dedicado por tenant

Cada cliente tem seu próprio banco de dados físico. É o isolamento mais forte que existe — um bug de query jamais vaza dado entre clientes, porque não há nem conexão entre os bancos. É também o modelo escolhido quase por obrigação em setores altamente regulados, como saúde e financeiro, onde contratos exigem isolamento físico comprovável.

O custo aparece na operação: migrar schema em 200 bancos diferentes, monitorar 200 conexões, fazer backup e restore individualizado. A partir de algumas dezenas de tenants, isso deixa de ser trivial e passa a exigir automação pesada de infraestrutura.

Modelo 2: schema dedicado por tenant, banco compartilhado

Um meio-termo comum em bancos como PostgreSQL: um único banco físico, mas cada tenant tem seu próprio schema (tenant_123.usuarios, tenant_456.usuarios). O isolamento lógico é forte, a operação de infraestrutura é mais simples que ter bancos físicos separados, mas migrações de schema ainda precisam rodar tenant por tenant — só que agora dentro do mesmo processo de deploy.

Modelo 3: banco compartilhado com coluna de tenant

O modelo mais comum em SaaS B2B de médio porte: uma única tabela usuarios serve todos os clientes, com uma coluna tenant_id em cada linha determinando a quem aquele dado pertence. Toda query precisa, obrigatoriamente, filtrar por esse tenant_id — o que move o isolamento de uma garantia estrutural do banco para uma disciplina de código.

É o modelo mais barato de operar e o que mais escala em número de tenants — dezenas de milhares de clientes convivem tranquilamente na mesma infraestrutura. Também é o que exige mais rigor de engenharia, porque um único WHERE esquecido em uma query pode vazar dado de um cliente para outro.

Row-Level Security no PostgreSQL move parte dessa responsabilidade do código de volta para o banco: mesmo que uma query esqueça o filtro de tenant, o próprio banco recusa retornar linhas fora do contexto autorizado. Não substitui disciplina de código, mas é uma segunda camada de proteção que vale a pena ativar.
Modelo Isolamento Custo operacional Escala em nº de tenants
Banco por tenant Muito alto Alto Baixa (centenas)
Schema por tenant Alto Médio Média (milhares)
Banco compartilhado + tenant_id Depende da disciplina de código Baixo Alta (dezenas de milhares)

O problema do "noisy neighbor"

Isolamento não é só sobre dados — é também sobre performance. Em um modelo de banco compartilhado, um tenant com uma query pesada mal indexada pode degradar a experiência de todos os outros clientes ao mesmo tempo. Isso é o chamado "noisy neighbor", e é o motivo pelo qual clientes enterprise grandes muitas vezes migram, com o tempo, para um schema ou banco dedicado — mesmo que o resto da base continue no modelo compartilhado.

Propagação do contexto de tenant

Um detalhe que separa uma implementação multi-tenant madura de uma frágil: o tenant_id não deveria ser algo que cada função do código precisa lembrar de passar manualmente. O ideal é que ele viva no contexto da requisição desde a autenticação — extraído do token, propagado automaticamente por middleware, e injetado em toda query pela camada de acesso a dados. Isso reduz drasticamente a chance de um desenvolvedor esquecer o filtro em uma única query.

Modelo híbrido: o que a maioria acaba usando

Na prática, produtos SaaS maduros raramente ficam presos a um único modelo. É comum começar com banco compartilhado para a maioria dos clientes e reservar schema ou banco dedicado para contas enterprise específicas com exigências contratuais de isolamento — resolvendo o trade-off por cliente, não pela plataforma inteira.

Regra prática

Comece com banco compartilhado e tenant_id propagado por middleware, ative Row-Level Security como segunda camada de defesa, e reserve isolamento físico apenas para os clientes que contratualmente exigirem.

Conclusão

Não existe modelo multi-tenant "certo" — existe o modelo certo para o estágio, o setor regulatório e o perfil de cliente do seu produto. A decisão importante não é escolher o modelo perfeito na largada, mas entender exatamente o que cada um troca, para não descobrir o custo real só quando um cliente grande pede um isolamento que a arquitetura atual não suporta.

Perguntas frequentes

O que é uma arquitetura multi-tenant?

É o padrão em que uma única aplicação e uma única base de código atendem múltiplos clientes (tenants) simultaneamente, garantindo que os dados de cada cliente fiquem isolados dos demais, mesmo compartilhando a mesma infraestrutura.

Qual a diferença entre single-tenant e multi-tenant?

Em single-tenant, cada cliente tem sua própria instância completa da aplicação e do banco de dados. Em multi-tenant, vários clientes compartilham a mesma instância da aplicação, com o isolamento de dados garantido por banco, schema ou coluna de tenant, dependendo do modelo escolhido.

Como isolar dados de clientes diferentes em um banco compartilhado?

O método mais comum é uma coluna tenant_id em cada tabela, com toda query obrigatoriamente filtrando por ela — idealmente propagada automaticamente pelo contexto da requisição — reforçada por Row-Level Security no banco como segunda camada de proteção.

Multi-tenant é sempre mais barato que single-tenant?

Operacionalmente sim, principalmente no modelo de banco compartilhado, que escala para dezenas de milhares de tenants na mesma infraestrutura. Mas alguns setores regulados exigem isolamento físico por contrato, o que pode tornar um modelo mais próximo do single-tenant obrigatório para certos clientes.