pub struct Database<S> { /* private fields */ }Expand description
Database is a proof that the database has been configured.
For information on how to create transactions, please refer to LocalClient.
Creating a Database requires going through the steps to migrate an existing database to the required schema, or creating a new database from scratch. Having done the setup to create a compatible database is sadly not a guarantee that the database will stay compatible for the lifetime of the Database.
That is why Database also stores the schema_version. This allows detecting non-malicious
modifications to the schema and gives us the ability to panic when this is detected.
Such non-malicious modification of the schema can happen for example if another Database
instance is created with additional migrations (e.g. by another newer instance of your program).
§Sqlite config
Sqlite is configured to be in WAL mode. The effect of this mode is that there can be any number of readers with one concurrent writer. What is nice about this is that a Transaction can always be made immediately. Making a TransactionMut has to wait until all other TransactionMuts are finished.
Sqlite is also configured with synchronous=NORMAL. This gives better performance by fsyncing less.
The database will not lose transactions due to application crashes, but it might due to system crashes or power loss.