SaaS
Patterns d'architecture multi-tenant SaaS
Row-level, schema-per-tenant ou database-per-tenant : comment choisir une architecture multi-tenant SaaS qui passe à l'échelle sans vous enfermer dans une réécriture.
TL;DR
L'isolation row-level avec PostgreSQL RLS est le bon choix par défaut pour la majorité des SaaS B2B. Passez au schema ou au database-per-tenant uniquement si la réglementation, un effet de voisinage bruyant ou une vraie divergence de schéma l'exige réellement.

La bonne architecture multi-tenant SaaS pour la plupart des produits est l'isolation row-level adossée à PostgreSQL Row-Level Security. C'est la moins coûteuse à opérer, la plus simple pour exécuter des migrations, et elle passe à l'échelle bien au-delà de ce que la plupart des fondateurs anticipent avant d'atteindre de vraies limites. Les cas qui nécessitent réellement une séparation plus forte sont plus rares que ce que les articles d'architecture habituels laissent entendre.
Les trois modèles d'isolation
Il existe trois patterns canoniques, chacun faisant un compromis entre profondeur d'isolation et coût opérationnel :
- Row-level (schéma partagé). Chaque table porte une colonne
tenant_idet chaque requête filtre dessus. Une seule base de données, un seul schéma, tous les tenants coexistent. - Schema-per-tenant. Chaque tenant dispose de son propre schéma PostgreSQL au sein d'une base de données partagée. Une isolation de namespace plus forte, mais un nombre d'objets à gérer nettement plus élevé.
- Database-per-tenant. Chaque tenant dispose d'une base de données ou d'une instance dédiée. Isolation maximale, surcharge opérationnelle maximale.
Pourquoi le row-level s'impose pour la plupart des SaaS multi-tenant
Le Row-Level Security (RLS) de PostgreSQL permet à la base de données d'appliquer directement les frontières entre tenants. Une politique définie une seule fois garantit qu'une requête défectueuse ne peut pas lire les lignes d'un autre tenant. Supabase s'appuie nativement sur ce modèle. Si vous comparez cette approche à Firebase, les compromis méritent d'être compris avant de vous engager dans l'un ou l'autre.
Avec un tenant_id sur chaque table métier et un index composite qui commence par ce champ, ce pattern gère confortablement de larges bases clients sur une seule base de données. Les migrations s'exécutent une seule fois. Le connection pooling reste simple. L'outillage opérationnel est plus facile, car vous gérez une seule chose plutôt que des centaines.
Un piège de performance à connaître : rédigez vos politiques RLS de façon à ce que toute fonction utilitaire s'exécute une fois par requête, et non une fois par ligne. Une politique qui réévalue une vérification de session pour chaque ligne ralentit silencieusement vos endpoints à mesure que les tables grossissent. Encapsulez la vérification pour que le planificateur la traite comme un init-plan. Pour aller plus loin sur les spécificités PostgreSQL, le guide PostgreSQL pour les startups couvre l'indexation et les patterns de requêtes pertinents ici.
Quand une isolation plus forte est justifiée
Trois situations justifient réellement de passer au-delà du row-level :
- Exigences réglementaires ou contractuelles. Le contrat d'un client ou la législation applicable impose un stockage des données physiquement séparé.
- Risque de voisinage bruyant. La charge de travail d'un seul tenant à fort volume dégrade les performances de tous les autres sur l'infrastructure partagée.
- Divergence de schéma. Les tenants ont des structures de tables réellement différentes, pas seulement des valeurs de données différentes.
Même dans ces cas, une approche hybride fonctionne bien. Conservez la majorité des tenants en row-level et migrez uniquement vos comptes les plus importants ou les plus réglementés vers des bases de données dédiées. Vous évitez ainsi de payer le coût opérationnel complet du database-per-tenant sur l'ensemble de votre base clients pour une poignée de comptes.
Les décisions de conception qui s'accumulent dans le temps
La stratégie de tenancy est le genre de choix où une négligence initiale devient coûteuse à corriger. Quelques points qui comptent dès le départ :
- Ajoutez
tenant_idsur chaque table métier et faites-en le premier champ de vos index composites. - Dérivez le tenant depuis la session authentifiée. Ne faites jamais confiance au client pour le fournir.
- Appliquez l'isolation au niveau de la base de données pour qu'une clause
WHEREmanquante ne puisse pas faire fuiter des données entre tenants. - Faites du provisionnement des tenants un code path unique et bien testé, plutôt que quelque chose qui se développe de façon organique dans votre codebase.
Disperser la logique d'isolation des tenants dans le code applicatif, c'est précisément ce qui crée de vraies difficultés de migration plus tard. Centralisez-la, appliquez-la dans la base de données, et vous préservez la capacité à faire évoluer le modèle à mesure que les exigences changent.
Si vous concevez un backend multi-tenant et souhaitez travailler avec une équipe qui a mis en production des systèmes PostgreSQL avec RLS à grande échelle, parlons-en.
Questions fréquentes
Qu'est-ce qu'une architecture multi-tenant SaaS ?
C'est la façon dont vous isolez les données d'un client de celles d'un autre sur une infrastructure partagée. Les trois patterns principaux sont l'isolation row-level, le schema-per-tenant et le database-per-tenant. Chacun fait un compromis entre simplicité opérationnelle et niveau d'isolation.
Quand utiliser le schema-per-tenant plutôt que le row-level ?
Le schema-per-tenant devient pertinent lorsque vous avez des exigences d'isolation contractuelles, une personnalisation significative du schéma par tenant, ou des problèmes de voisinage bruyant que vous ne pouvez pas résoudre par l'optimisation des requêtes. Pour la plupart des SaaS en phase de démarrage, il ajoute de la complexité sans bénéfice proportionnel.
PostgreSQL RLS empêche-t-il réellement les fuites de données entre tenants ?
Oui, s'il est correctement configuré. Les politiques RLS sont appliquées par le moteur de base de données : une clause WHERE manquante dans le code applicatif ne peut donc pas exposer les lignes d'un autre tenant. Le principal risque est une politique mal configurée, pas le mécanisme lui-même.
Peut-on démarrer avec le row-level et migrer vers le database-per-tenant plus tard ?
Oui, et beaucoup de produits suivent exactement ce chemin. Commencez en row-level, puis migrez vers des bases de données isolées les comptes les plus volumineux ou les plus réglementés au fur et à mesure que le besoin se présente. Centraliser le provisionnement des tenants dans un code path propre et testé dès le premier jour rend cette transition bien moins douloureuse.
Comment Pykero peut aider
Services liés à cet article.
Vous construisez quelque chose de similaire ?
Pykero Agency conçoit et livre des produits web, mobiles, SaaS et IA prêts pour la production.
Parlons-en


