// Package persistence provides the database interface for Flamenco Manager. package persistence // SPDX-License-Identifier: GPL-3.0-or-later import ( "context" "fmt" "time" "github.com/rs/zerolog/log" "gorm.io/gorm" // sqlite "git.blender.org/flamenco/pkg/gorm-modernc-sqlite" "github.com/glebarez/sqlite" ) const checkPeriod = 1 * time.Hour // DB provides the database interface. type DB struct { gormDB *gorm.DB } // Model contains the common database fields for most model structs. // It is a copy of the gorm.Model struct, but without the `DeletedAt` field. // Soft deletion is not used by Flamenco. If it ever becomes necessary to // support soft-deletion, see https://gorm.io/docs/delete.html#Soft-Delete type Model struct { ID uint `gorm:"primarykey"` CreatedAt time.Time UpdatedAt time.Time } func OpenDB(ctx context.Context, dsn string) (*DB, error) { log.Info().Str("dsn", dsn).Msg("opening database") db, err := openDB(ctx, dsn) if err != nil { return nil, err } // Close the database connection if there was some error. This prevents // leaking database connections & should remove any write-ahead-log files. closeConnOnReturn := true defer func() { if !closeConnOnReturn { return } if err := db.Close(); err != nil { log.Debug().AnErr("cause", err).Msg("cannot close database connection") } }() if err := setBusyTimeout(db.gormDB, 5*time.Second); err != nil { return nil, err } // Perfom some maintenance at startup. if !db.performIntegrityCheck(ctx) { return nil, ErrIntegrity } db.vacuum() if err := db.migrate(); err != nil { return nil, err } log.Debug().Msg("database automigration succesful") closeConnOnReturn = false return db, nil } func openDB(ctx context.Context, dsn string) (*DB, error) { globalLogLevel := log.Logger.GetLevel() dblogger := NewDBLogger(log.Level(globalLogLevel)) config := gorm.Config{ Logger: dblogger, NowFunc: nowFunc, } return openDBWithConfig(dsn, &config) } func openDBWithConfig(dsn string, config *gorm.Config) (*DB, error) { dialector := sqlite.Open(dsn) gormDB, err := gorm.Open(dialector, config) if err != nil { return nil, err } db := DB{ gormDB: gormDB, } // Close the database connection if there was some error. This prevents // leaking database connections & should remove any write-ahead-log files. closeConnOnReturn := true defer func() { if !closeConnOnReturn { return } if err := db.Close(); err != nil { log.Debug().AnErr("cause", err).Msg("cannot close database connection") } }() // Use the generic sql.DB interface to set some connection pool options. sqlDB, err := gormDB.DB() if err != nil { return nil, err } // Only allow a single database connection, to avoid SQLITE_BUSY errors. // It's not certain that this'll improve the situation, but it's worth a try. sqlDB.SetMaxIdleConns(1) // Max num of connections in the idle connection pool. sqlDB.SetMaxOpenConns(1) // Max num of open connections to the database. // Enable foreign key checks. log.Trace().Msg("enabling SQLite foreign key checks") if tx := gormDB.Exec("PRAGMA foreign_keys = 1"); tx.Error != nil { return nil, fmt.Errorf("enabling foreign keys: %w", tx.Error) } var fkEnabled int if tx := gormDB.Raw("PRAGMA foreign_keys").Scan(&fkEnabled); tx.Error != nil { return nil, fmt.Errorf("checking whether the database has foreign key checks enabled: %w", tx.Error) } if fkEnabled == 0 { log.Error().Msg("SQLite database does not want to enable foreign keys, this may cause data loss") } // Write-ahead-log journal may improve writing speed. log.Trace().Msg("enabling SQLite write-ahead-log journal mode") if tx := gormDB.Exec("PRAGMA journal_mode = WAL"); tx.Error != nil { return nil, fmt.Errorf("enabling SQLite write-ahead-log journal mode: %w", tx.Error) } // Switching from 'full' (default) to 'normal' sync may improve writing speed. log.Trace().Msg("enabling SQLite 'normal' synchronisation") if tx := gormDB.Exec("PRAGMA synchronous = normal"); tx.Error != nil { return nil, fmt.Errorf("enabling SQLite 'normal' sync mode: %w", tx.Error) } closeConnOnReturn = false return &db, nil } // nowFunc returns 'now' in UTC, so that GORM-managed times (createdAt, // deletedAt, updatedAt) are stored in UTC. func nowFunc() time.Time { return time.Now().UTC() } // vacuum executes the SQL "VACUUM" command, and logs any errors. func (db *DB) vacuum() { tx := db.gormDB.Exec("vacuum") if tx.Error != nil { log.Error().Err(tx.Error).Msg("error vacuuming database") } } // Close closes the connection to the database. func (db *DB) Close() error { sqldb, err := db.gormDB.DB() if err != nil { return err } return sqldb.Close() }