Multitenancy: Cómo servir a miles de clientes con una sola aplicación

¿Qué es multitenancy?

Tipos de multitenancy

1. Multitenancy con aislamiento lógico en la base de datos

-- Ejemplo de tabla con tenant_id
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    tenant_id UUID NOT NULL,
    email VARCHAR(255) NOT NULL,
    name VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Índice para optimizar consultas por tenant
CREATE INDEX idx_users_tenant_id ON users(tenant_id);

-- Row Level Security (RLS) para garantizar aislamiento
ALTER TABLE users ENABLE ROW LEVEL SECURITY;

-- Política que solo permite ver datos del tenant actual
CREATE POLICY tenant_isolation ON users
    USING (tenant_id = current_setting('app.current_tenant_id')::UUID);

2. Multitenancy con esquema dedicado

-- Creación de esquemas por tenant
CREATE SCHEMA tenant_company_a;
CREATE SCHEMA tenant_company_b;

-- Tablas en esquema dedicado
CREATE TABLE tenant_company_a.users (
    id SERIAL PRIMARY KEY,
    email VARCHAR(255) NOT NULL,
    name VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE tenant_company_b.users (
    id SERIAL PRIMARY KEY,
    email VARCHAR(255) NOT NULL,
    name VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

3. Multitenancy con base de datos dedicada

Comparativa rápida

Factores para elegir el modelo

Implementación práctica: Spring Boot con PostgreSQL

// Entidad con tenant_id
@Entity
@Table(name = "users")
data class User(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long = 0,

    @Column(name = "tenant_id", nullable = false)
    val tenantId: UUID,

    @Column(nullable = false)
    val email: String,

    @Column(nullable = false)
    val name: String,

    @CreationTimestamp
    val createdAt: LocalDateTime = LocalDateTime.now()
)

// Interceptor para establecer el contexto del tenant
@Component
class TenantInterceptor : HandlerInterceptor {

    override fun preHandle(
        request: HttpServletRequest,
        response: HttpServletResponse,
        handler: Any
    ): Boolean {
        val token = extractJwtToken(request)
        val tenantId = extractTenantFromToken(token)
        
        // Establecer tenant en el contexto de la aplicación
        TenantContext.setCurrentTenant(tenantId)
        
        return true
    }

    override fun afterCompletion(
        request: HttpServletRequest,
        response: HttpServletResponse,
        handler: Any,
        ex: Exception?
    ) {
        // Limpiar contexto después de la request
        TenantContext.clear()
    }
}

// Repository con filtro automático por tenant
@Repository
interface UserRepository : JpaRepository<User, Long> {
    
    @Query("SELECT u FROM User u WHERE u.tenantId = :tenantId")
    fun findByTenantId(@Param("tenantId") tenantId: UUID): List<User>
    
    @Query("SELECT u FROM User u WHERE u.tenantId = :tenantId AND u.email = :email")
    fun findByTenantIdAndEmail(
        @Param("tenantId") tenantId: UUID, 
        @Param("email") email: String
    ): User?
}

// Service que usa el contexto del tenant automáticamente
@Service
class UserService(private val userRepository: UserRepository) {
    
    fun getCurrentTenantUsers(): List<User> {
        val currentTenantId = TenantContext.getCurrentTenant()
        return userRepository.findByTenantId(currentTenantId)
    }
    
    fun createUser(email: String, name: String): User {
        val currentTenantId = TenantContext.getCurrentTenant()
        val user = User(
            tenantId = currentTenantId,
            email = email,
            name = name
        )
        return userRepository.save(user)
    }
}

Más ejemplos de empresas multitenant

Buenas prácticas en multitenancy

Desafíos comunes y cómo resolverlos

Conclusión