Struct SchemaPerTenantStrategy 

pub struct SchemaPerTenantStrategy { /* private fields */ }

Schema-per-tenant tenancy strategy implementation.

This strategy uses PostgreSQL schemas to isolate tenant data. Each tenant has its own schema, and the connection’s search_path is set to include the tenant’s schema.

Schema Naming

Tenant IDs are converted to valid PostgreSQL schema names:

• Prefixed with the configured prefix (default: tenant_)
• Converted to lowercase
• Hierarchical separators (/) replaced with underscores
• Invalid characters removed

Search Path

For each request, the search_path is set to:

SET search_path TO tenant_acme, shared, public;

This allows:

• Tenant-specific tables in the tenant schema
• Shared resources (CodeSystems, etc.) in the shared schema
• Extension functions in public

Schema Creation

Schemas can be created:

• Automatically on first access (if auto_create_schema is true)
• From a template schema (copying structure)
• Manually via migrations

Implementations

impl SchemaPerTenantStrategy

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

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

pub fn config(&self) -> &SchemaPerTenantConfig

Returns the configuration.

pub fn shared_schema(&self) -> &str

Returns the shared schema name.

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

Converts a tenant ID to a schema name.

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

Generates SQL to set the search_path for a tenant.

pub fn set_system_search_path_sql(&self) -> String

Generates SQL to set the search_path for the system tenant.

pub fn reset_search_path_sql(&self) -> String

Generates SQL to reset the search_path.

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

Generates SQL to create a schema for a tenant.

pub fn drop_schema_sql(&self, tenant_id: &TenantId, cascade: bool) -> String

Generates SQL to drop a schema for a tenant.

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

Generates SQL to check if a schema exists.

pub fn list_tenant_schemas_sql(&self) -> String

Generates SQL to list all tenant schemas.

Trait Implementations

impl Clone for SchemaPerTenantStrategy

fn clone(&self) -> SchemaPerTenantStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SchemaPerTenantStrategy

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

Formats the value using the given formatter.

impl TenantResolver for SchemaPerTenantStrategy

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.