// 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 "projects.blender.org/studio/flamenco/pkg/gorm-modernc-sqlite" "github.com/glebarez/sqlite" ) // 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. // Always enable foreign key checks, to make SQLite behave like a real database. if err := db.pragmaForeignKeys(true); err != nil { return nil, err } // 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() } func (db *DB) pragmaForeignKeys(enabled bool) error { var ( value int noun string ) switch enabled { case false: value = 0 noun = "disabl" case true: value = 1 noun = "enabl" } log.Trace().Msgf("%sing SQLite foreign key checks", noun) // SQLite doesn't seem to like SQL parameters for `PRAGMA`, so `PRAGMA foreign_keys = ?` doesn't work. sql := fmt.Sprintf("PRAGMA foreign_keys = %d", value) if tx := db.gormDB.Exec(sql); tx.Error != nil { return fmt.Errorf("%sing foreign keys: %w", noun, tx.Error) } var fkEnabled int if tx := db.gormDB.Raw("PRAGMA foreign_keys").Scan(&fkEnabled); tx.Error != nil { return fmt.Errorf("checking whether the database has foreign key checks %sed: %w", noun, tx.Error) } if fkEnabled != value { return fmt.Errorf("SQLite database does not want to %se foreign keys, this may cause data loss", noun) } return nil }