マルチテナンシー
ルール
- 行レベルの分離(デフォルト): テナントスコープのすべてのテーブルに
tenantId カラムを追加し、ミドルウェアまたはRLS(行レベルセキュリティ)で適用します。
- スキーマ単位のテナント分離: テナントがカスタムスキーマや厳格なデータ分離を必要とする場合に使用します。運用は複雑になりますが、分離性は向上します。
- サブドメインルーティング:
{tenant}.app.com からテナントを抽出し、ミドルウェアで解決してリクエストコンテキストに tenantId を設定します。
- カスタムドメイン: アプリへのCNAMEレコードと、
Host ヘッダーによるテナントの検索を行います。カスタムドメインとテナントIDをマッピングする domains テーブルを使用します。
- テナントごとの設定: テーマ(ロゴ、色)、機能フラグ、制限値を
tenant_settings テーブルに保存し、TTL付きでメモリにキャッシュします。
- RLSパターン(Postgres):
ALTER TABLE posts ENABLE ROW LEVEL SECURITY; CREATE POLICY tenant_isolation ON posts USING (tenant_id = current_setting('app.tenant_id'))
- ミドルウェア: サブドメイン/ヘッダーからテナントを抽出し、コンテキストに設定してすべてのデータベースクエリに適用します。テナントスコープなしでクエリを実行させないでください。
- データパーティショニング: 大規模テーブルの場合は、
tenantId でパーティショニングします。クエリパフォーマンスが向上し、テナント単位のバックアップ/リストアが可能になります。
行レベル分離パターン
function getTenantFromHost(host: string): string {
const subdomain = host.split(".")[0];
return subdomain;
}
prisma.$use(async (params, next) => {
if (TENANT_MODELS.includes(params.model)) {
params.args.where = { ...params.args.where, tenantId: context.tenantId };
}
return next(params);
});
サブドメインルーティング(Next.js ミドルウェア)
export function middleware(request: NextRequest) {
const host = request.headers.get("host") ?? "";
const tenant = host.split(".")[0];
const response = NextResponse.next();
response.headers.set("x-tenant-id", tenant);
return response;
}
避けるべきこと
- テナントスコープなしのクエリ —
WHERE tenantId = ? が1つでも欠けると、テナント間でデータが漏洩します。
- クライアント側でのテナントのハードコーディング — サーバーサイドでサブドメイン/ドメインから解決します。
tenantId にインデックスがない — テナントスコープのすべてのテーブルには、tenantId で始まる複合インデックスが必要です。
- 共有キャッシュでのテナントデータの混在 — キャッシュキーを
{tenantId}:{key} で名前空間化します。