Voltar para o blog Software sob medida

Multi-tenant: o que é, os 3 modelos e quando usar

Multi-tenant é a arquitetura em que uma instalação do software atende vários clientes com dados separados. Os 3 modelos, prós e contras e como evitar vazamento.

Multi-tenant (ou multilocatário) é a arquitetura em que uma única instalação do software atende vários clientes, chamados tenants, com os dados de cada um separados dos demais. É como um prédio: a estrutura, a portaria e o elevador são compartilhados, mas cada apartamento tem a sua chave. Quase todo SaaS funciona assim. O código é um só, a atualização sai para todos de uma vez, e o cliente A nunca pode ver o que é do cliente B.

O oposto é o single-tenant: uma instalação separada para cada cliente, com servidor e banco próprios.

Este texto serve para quem decide (o que muda em custo, risco e contrato) e para quem desenvolve (como isolar os dados na prática).

Multi-tenant e single-tenant, lado a lado

Multi-tenantSingle-tenant
InstalaçãoUma, para todos os clientesUma por cliente
AtualizaçãoSai para todos de uma vezCliente por cliente
Custo de infraestrutura por clienteBaixo, dividido entre todosAlto, cada um com a sua
Cliente novoUm cadastroUm ambiente novo para subir
PersonalizaçãoPor configuraçãoAmpla, com o risco de cada cópia virar um sistema diferente
IsolamentoLógico, depende do softwareFísico, por construção

Para o negócio, a diferença aparece na margem. Num SaaS, o custo de servidor e de operação por cliente entra na margem bruta, e a margem bruta entra no valor de cada cliente ao longo do tempo. A calculadora de métricas de SaaS mostra esse efeito com os seus números.

Os três modelos de isolamento

Dentro do multi-tenant, a pergunta é onde fica a fronteira entre um cliente e outro. Há três respostas clássicas.

Banco por cliente

Cada cliente tem o seu banco de dados. A aplicação é compartilhada e escolhe o banco conforme quem fez login. É o isolamento mais forte dentro do multi-tenant: uma consulta errada não alcança o banco do vizinho. O custo aparece na operação. Cem clientes são cem bancos para atualizar, monitorar e incluir no backup.

Schema por cliente

Um banco só, com um schema (um compartimento de tabelas) para cada cliente. No PostgreSQL, cada schema tem as suas próprias tabelas pedidos, clientes e produtos. Fica no meio do caminho: isolamento razoável, custo menor que o de banco por cliente. O problema cresce com o número de clientes. Mil schemas são mil cópias de cada tabela, e cada mudança de estrutura precisa rodar mil vezes.

Tabela compartilhada com tenant_id

Um banco, um conjunto de tabelas e uma coluna tenant_id em cada linha, dizendo de quem ela é. É o modelo mais barato e o que mais escala em número de clientes: cliente novo é uma linha na tabela de clientes. Em troca, todo o isolamento depende de cada consulta filtrar pelo tenant_id certo. Esquecer o filtro uma vez basta para vazar.

Prós e contras de cada modelo

CritérioBanco por clienteSchema por clienteTabela compartilhada
Custo de infraestruturaAltoMédioBaixo
IsolamentoForteMédioDepende do código e do banco
Mudança de estrutura (migração)Roda em cada bancoRoda em cada schemaRoda uma vez
Backup e restauração de um clienteSimplesViávelDifícil: o cliente está misturado nas tabelas
Excluir os dados de um cliente (LGPD)Apagar o bancoApagar o schemaApagar linha a linha, em todas as tabelas
Personalização por clienteAmplaMédiaPor configuração
Cliente novoCriar e preparar um bancoCriar um schemaUm cadastro
Combina comPoucos clientes grandes, com exigência contratualDezenas de clientes, com a operação automatizadaMuitos clientes pequenos e médios

A linha que mais surpreende é a do backup. O caso típico: um cliente apaga dados por engano e pede os de ontem. Com banco por cliente, restaura-se o banco dele. Com tabela compartilhada, restaurar o backup inteiro desfaria o dia de todos os outros clientes. É preciso subir uma cópia à parte e extrair só as linhas daquele cliente. Dá para fazer, desde que alguém tenha pensado nisso antes de precisar.

O erro clássico: um cliente vendo o dado do outro

No modelo de tabela compartilhada, o vazamento não precisa de ataque. Basta uma consulta sem filtro:

-- o certo
SELECT * FROM pedidos WHERE tenant_id = $1 AND status = 'aberto';

-- o que escapa numa sexta-feira
SELECT * FROM pedidos WHERE status = 'aberto';

A segunda consulta funciona, passa no teste feito com um cliente só e mostra os pedidos de todo mundo. Os lugares onde esse esquecimento mais aparece:

  • Relatórios e exportações, escritos à parte do resto do sistema.
  • Rotinas em segundo plano, como o envio de e-mail da madrugada ou o fechamento do mês.
  • Busca e autocompletar, que consultam um índice separado.
  • Cache, quando a chave não inclui o cliente.
  • Arquivos enviados, guardados num endereço que dá para adivinhar.
  • O tenant_id vindo da tela. Se o sistema aceita o identificador do cliente como parâmetro da requisição, basta trocar o número para ver outro cliente. O cliente atual tem de sair da sessão de quem fez login, do lado do servidor.

Como evitar o vazamento

Disciplina não basta, porque um dia alguém esquece. A defesa boa tem camadas.

1. Um ponto só que resolve o cliente

A aplicação descobre o cliente uma vez, pela sessão, e todo acesso ao banco passa por uma camada que aplica o filtro sozinha. Quem escreve uma tela nova não deveria ter como fazer uma consulta sem cliente.

2. Row-level security no PostgreSQL

O PostgreSQL tem row-level security, a segurança por linha: o próprio banco filtra as linhas conforme uma política, mesmo que a consulta esqueça o filtro. Um exemplo:

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

CREATE POLICY isolamento_por_cliente ON pedidos
  USING (tenant_id = nullif(current_setting('app.tenant_id', true), '')::uuid)
  WITH CHECK (tenant_id = nullif(current_setting('app.tenant_id', true), '')::uuid);

Em cada transação, a aplicação informa o cliente antes de consultar:

BEGIN;
SELECT set_config('app.tenant_id', '0b6f1c2e-5a4d-4e8b-9c3a-2f1d7e6a9b10', true);
SELECT * FROM pedidos WHERE status = 'aberto';  -- só volta o que é desse cliente
COMMIT;

Os detalhes que derrubam quem está começando, conforme a documentação do PostgreSQL:

  • Sem política, nada aparece. Com a segurança ligada e nenhuma política criada, o banco nega todo acesso. É um bom padrão.
  • O dono da tabela ignora as políticas, a não ser que se use FORCE ROW LEVEL SECURITY. Superusuários e papéis com o atributo BYPASSRLS ignoram sempre. A aplicação deve conectar com um usuário comum, não com o dono das tabelas.
  • Cuidado com o pool de conexões. O último parâmetro true do set_config faz o valor valer só para a transação. Definido para a sessão inteira, ele pode sobrar para a próxima requisição que pegar a mesma conexão.
  • Cliente não informado não pode virar “todos”. No exemplo, se ninguém definiu o cliente, a comparação dá nulo e nenhuma linha passa.

O Supabase, muito usado em protótipos feitos com IA, se apoia nesse mesmo recurso: a documentação dele pede row-level security ligada em toda tabela de um schema exposto pela API, porque sem ela a tabela pode ser lida e alterada por qualquer papel com permissão.

3. Teste que tenta vazar

Crie dois clientes de teste e escreva testes automatizados em que o cliente A tenta ler, alterar e exportar dados do cliente B, em cada tela e cada rota da API. Esses testes rodam a cada mudança. São baratos e pegam exatamente o erro que a revisão de código deixa passar.

4. Modelagem que ajuda

  • Índices começando por tenant_id, porque quase toda consulta filtra por ele.
  • Unicidade por cliente: o código do produto é único dentro do cliente, não no sistema todo (UNIQUE (tenant_id, codigo)).
  • Chaves estrangeiras que incluem o tenant_id, para um pedido do cliente A não apontar para um produto do cliente B.

Multi-tenant e LGPD

Num SaaS para empresas, você costuma ser o operador dos dados que cada cliente coloca no sistema. Isso traz três perguntas que a arquitetura precisa responder:

  • Quando o cliente cancela, como os dados dele saem? Exportar tudo e depois excluir, em todas as tabelas, arquivos e backups, no prazo combinado em contrato.
  • Quem da sua equipe acessa o dado de um cliente, e isso fica registrado? O painel administrativo precisa de trilha de auditoria.
  • Se houver vazamento, de quais clientes foi? Com tenant_id em todas as linhas e registro de acesso, dá para responder. Sem isso, a resposta honesta é “não sabemos”, e ela pesa na comunicação aos clientes e à ANPD.

Alguns contratos pedem banco dedicado: setor regulado, cliente grande, exigência da área jurídica do cliente. O modelo híbrido resolve. Tabela compartilhada para a maioria, banco próprio para quem exige e paga por isso, com o mesmo código para todos.

Quando multi-tenant não é necessário

  • Software interno de uma empresa. Um sistema feito para a sua própria operação tem um cliente só. Se o grupo tem várias unidades ou CNPJs, isso é multiempresa, e costuma bastar um filtro por unidade com permissões.
  • Poucos clientes grandes, cada um com exigência de isolamento. Três clientes de grande porte podem justificar uma instalação para cada um, desde que o código continue o mesmo para todos.
  • Software instalado no servidor do cliente. Se cada cliente roda a própria cópia, a separação já está feita.

O que não vale é o meio-termo de copiar o sistema para cada cliente novo e personalizar o código de cada cópia. Na quinta cópia, cada correção precisa ser feita cinco vezes, e as versões nunca mais se encontram.

Se você está começando um SaaS e ainda não sabe quantos clientes terá, a escolha mais segura costuma ser a tabela compartilhada com tenant_id desde o primeiro dia e row-level security ligada. Custa pouco na primeira versão, e migrar depois sai muito mais caro. Veja como essa decisão entra no resto do produto em como criar um SaaS do zero.

Perguntas frequentes

O que é tenant?

Tenant, ou locatário, é cada cliente que usa o sistema com o seu próprio espaço: usuários, configurações e dados. Num SaaS para empresas, um tenant costuma ser uma empresa cliente, com várias pessoas dentro.

Multi-tenant é seguro?

É, quando o isolamento é garantido em mais de uma camada: o filtro na aplicação, a segurança por linha no banco e testes que tentam ler dado de outro cliente. O risco não está no modelo, está em depender só da memória de quem escreve cada consulta.

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

Multi-tenant separa clientes diferentes, que nunca podem ver os dados uns dos outros. Multiempresa, comum em ERP, separa as empresas de um mesmo grupo, que muitas vezes precisam de relatórios consolidados. Um SaaS pode ter os dois: cada cliente é um tenant, e dentro dele há várias empresas.

Dá para transformar um sistema single-tenant em multi-tenant?

Dá, mas é uma das mudanças mais caras de fazer com o sistema em uso. É preciso incluir o cliente em todas as tabelas, revisar cada consulta, juntar dados de bancos separados e testar o isolamento. Quanto mais cedo a decisão, mais barata.

Qual banco de dados usar para um SaaS multi-tenant?

O modelo de isolamento pesa mais que a marca do banco. O PostgreSQL é uma escolha comum porque tem segurança por linha nativa, o que dá uma segunda trava contra a consulta sem filtro.


Está desenhando um SaaS, ou herdou um sistema que mistura clientes? Agende um diagnóstico ou veja a frente de desenvolvimento de SaaS.

multi-tenantsaasarquitetura de softwarepostgresqllgpd

Pronto para destravar a sua operação?

Agende um diagnóstico: a gente mapeia os gargalos e mostra por onde começar.

Agende um diagnóstico