Struct DatabasePerTenantStrategy 

pub struct DatabasePerTenantStrategy { /* private fields */ }

Database-per-tenant tenancy strategy implementation.

This strategy provides complete isolation by maintaining separate databases for each tenant. It’s the most resource-intensive but offers the strongest isolation guarantees.

Connection Management

When pool_per_tenant is enabled, each tenant gets a dedicated connection pool. Pools are created lazily and can be evicted based on LRU when max_pools is exceeded.

Database Naming

Database names are generated from tenant IDs:

tenant_id: "acme"
database:  "tenant_acme_db"  (with default prefix/suffix)

Example

use helios_persistence::strategy::{DatabasePerTenantConfig, DatabasePerTenantStrategy};
use helios_persistence::tenant::TenantId;

let config = DatabasePerTenantConfig::default();
let strategy = DatabasePerTenantStrategy::new(config).unwrap();

// Get connection info for a tenant
let connection = strategy.connection_string(
    &TenantId::new("acme"),
    "user",
    "password",
);

Implementations

impl DatabasePerTenantStrategy

pub fn new(config: DatabasePerTenantConfig) -> Result<Self, Error>

Creates a new database-per-tenant strategy with the given configuration.

pub fn config(&self) -> &DatabasePerTenantConfig

Returns the configuration.

pub fn database_name(&self, tenant_id: &TenantId) -> String

Generates the database name for a tenant.

pub fn connection_string( &self, tenant_id: &TenantId, user: &str, password: &str, ) -> String

Generates a connection string for a tenant.

pub fn connection_string_with_host( &self, tenant_id: &TenantId, user: &str, password: &str, host: Option<&str>, ) -> String

Generates a connection string for a tenant with a specific host.

pub fn create_database_sql(&self, tenant_id: &TenantId) -> String

Generates SQL for creating a tenant database.

pub fn drop_database_sql(&self, tenant_id: &TenantId) -> String

Generates SQL for dropping a tenant database.

pub fn database_exists_sql(&self, tenant_id: &TenantId) -> String

Generates SQL for checking if a tenant database exists.

pub fn record_pool_access(&self, tenant_id: &TenantId)

Records access to a tenant’s pool for LRU tracking.

pub fn tenants_to_evict(&self) -> Vec<String>

Returns tenants that should be evicted based on LRU.

pub fn remove_pool_tracking(&self, tenant_id: &str)

Removes a tenant from the access tracking.

pub fn idle_tenants(&self) -> Vec<String>

Returns tenants with pools that have exceeded idle timeout.

Trait Implementations

impl Clone for DatabasePerTenantStrategy

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DatabasePerTenantStrategy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TenantResolver for DatabasePerTenantStrategy

fn resolve(&self, tenant_id: &TenantId) -> TenantResolution

Resolves a tenant ID to the appropriate database identifier.

fn validate(&self, tenant_id: &TenantId) -> Result<(), TenantValidationError>

Validates that a tenant ID is valid for this strategy.

fn system_tenant(&self) -> TenantResolution

Returns the system tenant resolution.