Struct DatabaseBuilder 

pub struct DatabaseBuilder<T: DatabaseSpec> { /* private fields */ }

빌더 (명세 §5.4)

Implementations

impl<T: DatabaseSpec> DatabaseBuilder<T>

pub fn sqlite(self, path: impl Into<PathBuf>) -> Self

Sets the SQLite file path. The special :memory: path uses the same single regular connection setup as Self::in_memory.

pub fn in_memory(self) -> Self

In-memory database for tests.

In-memory databases use one regular read/write connection regardless of Self::connections. This serializes transactions and avoids SQLite shared-cache SQLITE_LOCKED failures. With the live feature, the notifier still owns its separate internal connection.

pub fn connections(self, n: usize) -> Self

Sets the number of read/write connections in the unified pool.

In-memory databases always use one regular connection.

pub fn busy_timeout(self, d: Duration) -> Self

SQLITE_BUSY 대기 — 프로세스 내(통합 풀 동시 write)·외부 프로세스 write 경합 공용 (명세 §10)

pub fn queue_timeout(self, d: Duration) -> Self

커넥션 풀 대기 타임아웃 — 초과 시 Error::QueueTimeout

pub fn migrate(self, policy: MigrationPolicy) -> Self

마이그레이션 정책

pub fn migration(self, m: Migration) -> Self

마이그레이션 스텝 등록 (명세 §8.2/§8.3) — 세 소스 공통 표현

pub fn migrations(self, ms: impl IntoIterator<Item = Migration>) -> Self

마이그레이션 스텝 일괄 등록 — migrations_dir! 산출물 등

pub fn auto_migrate(self, on: bool) -> Self

Opt-in automatic migration from embedded snapshots (spec §8.4, decision 21d, default off).

When enabled, gaps in the registered migration chain are filled by diffing consecutive embedded snapshots (DatabaseSpec::EMBEDDED_SCHEMAS). Only safe operations are executed automatically (CREATE TABLE, nullable ADD COLUMN, valid RENAME COLUMN, CREATE INDEX). A gap whose diff contains destructive changes fails with a clear Error::Migration instead — register a manual step or use fallback_to_destructive_migration. Registered steps always take precedence over synthesized ones.

pub fn fallback_to_destructive_migration(self, enable: bool) -> Self

파괴적 마이그레이션 폴백 (명세 §8, 기본 off) — 체인이 불충분하면 모든 테이블을 삭제하고 현재 스키마로 재생성한다.

pub fn on_create( self, f: impl Fn(&Connection) -> Result<()> + Send + Sync + 'static, ) -> Self

최초 생성 시 1회 콜백 (테이블 생성 직후).

Runs inside the schema-creation transaction (L-5): if the callback fails, the schema DDL and user_version roll back together, so the next open retries creation from scratch. Do not manage transactions (BEGIN/COMMIT) inside the callback.

pub fn on_open( self, f: impl Fn(&Connection) -> Result<()> + Send + Sync + 'static, ) -> Self

오픈 시마다 콜백

pub fn query_logger( self, f: impl Fn(&str, Duration) + Send + Sync + 'static, ) -> Self

쿼리 로거 — (sql, 소요시간)

pub fn build(self) -> Result<T>

DB 오픈 — PRAGMA 초기화 · 스냅샷 스테일 검증 · 마이그레이션 · 풀 구성 (명세 §5.4)

Trait Implementations

impl<T: DatabaseSpec> Default for DatabaseBuilder<T>

fn default() -> Self

기본값 — 커넥션 수는 CPU 코어 기반(최대 4), busy_timeout 5초