Arquitetura multi-tenant: shared schema, schema por tenant ou banco dedicado

18/11/2026  ·  Devskin

Arquitetura multi-tenant: shared schema, schema por tenant ou banco dedicado

A arquitetura multi-tenant define como um único SaaS atende vários clientes (tenants) sem misturar dados, sem explodir o custo de infraestrutura e sem transformar cada deploy em risco. É uma das decisões mais caras de reverter no ciclo de vida de um produto. Neste comparativo técnico, analiso os três modelos mais usados com bancos relacionais, os trade-offs reais de cada um e um critério prático de escolha.

Os três modelos de arquitetura multi-tenant

Quase toda arquitetura multi-tenant em banco relacional cai em um destes padrões, ou em uma combinação deles. A diferença está no nível em que o isolamento acontece: linha, schema ou instância.

1. Shared schema com coluna tenant_id

Todos os tenants dividem as mesmas tabelas, e cada linha carrega um tenant_id. É o modelo mais simples de operar e o mais barato por cliente.

  • Prós: uma única migração por release, pool de conexões compartilhado, melhor aproveitamento de recursos e onboarding instantâneo de novos clientes.
  • Contras: o isolamento depende da disciplina da aplicação. Um WHERE esquecido vira vazamento de dados entre clientes. Índices crescem para todos, e um tenant muito grande pode degradar a latência dos demais (noisy neighbor).

2. Schema por tenant

Um mesmo banco, mas cada tenant tem seu próprio schema (por exemplo, tenant_acme.invoices). A aplicação define o search_path por requisição ou por conexão.

  • Prós: isolamento lógico mais forte, backup e restore parcial mais viáveis e possibilidade de customização pontual por cliente.
  • Contras: as migrações precisam rodar em cada schema, o que aumenta o tempo de deploy e a chance de falha parcial. Com muitos tenants, o catálogo do PostgreSQL incha e ferramentas como pg_dump ficam lentas. Além disso, o uso de PgBouncer em modo transaction exige cuidado com o search_path.

3. Banco ou instância dedicada por tenant

Cada cliente recebe um banco próprio, ou até um cluster próprio. É o isolamento máximo.

  • Prós: blast radius mínimo, ajuste de recursos por cliente, residência de dados e criptografia com chaves separadas. É frequente em contratos enterprise e em setores regulados.
  • Contras: custo fixo por tenant, orquestração de provisionamento, um pipeline de migração por banco e monitoramento muito mais fragmentado.

Isolamento por linha com Row Level Security no PostgreSQL

No modelo shared schema, é possível reduzir o risco de vazamento empurrando a regra de isolamento para o banco. O PostgreSQL oferece Row Level Security (RLS), que aplica políticas a todas as consultas na tabela, inclusive aquelas escritas com erro na aplicação.

ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;
ALTER TABLE invoices FORCE ROW LEVEL SECURITY;

CREATE POLICY tenant_isolation ON invoices
  USING (tenant_id = current_setting('app.tenant_id')::uuid)
  WITH CHECK (tenant_id = current_setting('app.tenant_id')::uuid);

-- no início de cada transação da aplicação:
BEGIN;
SET LOCAL app.tenant_id = '8f1c0c1e-0000-0000-0000-000000000000';
-- queries normais
COMMIT;

Pontos de atenção que costumam gerar incidentes nessa arquitetura multi-tenant:

  • O dono da tabela ignora RLS, a menos que você use FORCE ROW LEVEL SECURITY. Superusers e roles com BYPASSRLS também ignoram.
  • A aplicação deve conectar com uma role sem privilégios de bypass, separada da role de migração.
  • Use SET LOCAL dentro de transação. Com pooler em modo transaction, um SET de sessão pode vazar o contexto para outro tenant.
  • Crie índices começando por tenant_id nas consultas mais frequentes e meça com EXPLAIN (ANALYZE) o impacto das políticas no seu plano de execução.

Trade-offs: custo, migrações e noisy neighbor

Ao comparar os modelos, três eixos concentram a maior parte da dor operacional.

  • Custo por tenant: menor no shared schema, intermediário no schema por tenant e mais alto no banco dedicado. Em contrapartida, o banco dedicado permite cobrar um plano premium que financia essa infraestrutura.
  • Evolução do schema: no modelo compartilhado, uma migração mal planejada (um ALTER TABLE com lock longo) afeta todos os clientes ao mesmo tempo. Nos modelos isolados, o risco é menor por tenant, mas a orquestração de centenas de migrações exige idempotência, controle de versão por tenant e estratégia de rollback.
  • Noisy neighbor: é inevitável em recursos compartilhados. Mitigue com rate limiting por tenant, filas separadas para jobs pesados, statement_timeout e limites de conexão por role.

Qualquer que seja a escolha, observabilidade por tenant é obrigatória: latência, taxa de erro e consumo de recursos segmentados por cliente. Se você usa Prometheus, vale ler o review técnico da stack Prometheus e Grafana antes de usar o tenant como label, porque cardinalidade alta cobra seu preço em memória e retenção.

Como decidir sua arquitetura multi-tenant

Não existe modelo universalmente correto. Um critério prático:

  • Shared schema + RLS: produto em estágio inicial ou médio, muitos clientes pequenos, ticket baixo e necessidade de velocidade de entrega.
  • Schema por tenant: número moderado de clientes, necessidade de restore individual e algum nível de customização, com equipe disposta a manter tooling de migração.
  • Banco dedicado: poucos clientes grandes, exigências contratuais de isolamento ou conformidade, e ticket que sustente o custo.

Na prática, muitos SaaS maduros adotam um modelo híbrido: a base de clientes padrão roda em shared schema, e contas enterprise migram para bancos dedicados. Para isso funcionar, a camada de acesso a dados deve resolver a conexão por tenant desde o início, por meio de um tenant resolver e de um catálogo central que mapeia cada cliente ao seu destino. Isso evita reescrever a aplicação quando o primeiro contrato exigir isolamento físico.

Por fim, trate a mudança de plano como um evento de produto e de comunicação. Migrar um cliente de infraestrutura é uma operação sensível, e vale alinhar o processo com a forma como você divulga mudanças, como discuto em como comunicar lançamentos e updates de SaaS.

Conclusão

Escolher a arquitetura multi-tenant certa é equilibrar isolamento, custo e complexidade operacional para o estágio atual do seu produto. Comece pelo modelo mais simples que atenda aos seus requisitos de segurança, reforce o isolamento com RLS, meça por tenant e deixe uma rota de migração aberta para bancos dedicados. Assim, você não paga cedo demais por uma infraestrutura que ainda não precisa e nem fica preso quando o cliente grande chegar.

Contact

Send a message

Get in touch