[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[taler-docs] branch master updated: add DD34
From: |
gnunet |
Subject: |
[taler-docs] branch master updated: add DD34 |
Date: |
Fri, 27 Jan 2023 13:11:20 +0100 |
This is an automated email from the git hooks/post-receive script.
dold pushed a commit to branch master
in repository docs.
The following commit(s) were added to refs/heads/master by this push:
new 554c156 add DD34
554c156 is described below
commit 554c1569079082d461018410101d5143b887c120
Author: Florian Dold <florian@dold.me>
AuthorDate: Fri Jan 27 13:11:17 2023 +0100
add DD34
---
design-documents/034-wallet-db-migration.rst | 74 ++++++++++++++++++++++++++++
design-documents/index.rst | 1 +
2 files changed, 75 insertions(+)
diff --git a/design-documents/034-wallet-db-migration.rst
b/design-documents/034-wallet-db-migration.rst
new file mode 100644
index 0000000..6e1f148
--- /dev/null
+++ b/design-documents/034-wallet-db-migration.rst
@@ -0,0 +1,74 @@
+DD 034: Considerations for Wallet Database Migrations
+#####################################################
+
+Summary
+=======
+
+This design document discusses considerations for wallet database migrations.
+
+Motivation
+==========
+
+The schema of the GNU Taler Wallet database is evolving over time, either
+because new features are added or because bugs are fixed.
+
+Requirements
+============
+
+* Migrations may not result in data loss and must be automatic.
+* Our schema migration must be compatible with how IndexedDB works. This means
that we can't
+ do arbitrary schema migrations at any time, but need to increment the
IndexedDB database version
+ every time we add/remove/change an object store or index.
+
+Proposed Solution
+=================
+
+The schema of the wallet database is described in code in
+https://git.taler.net/wallet-core.git/tree/packages/taler-wallet-core/src/db.ts#n1959
+(``walletStoresV1``). This schema description is used to initialize and
upgrade the
+database automatically.
+
+In IndexedDB terminology, the wallet has two databases:
+
+1. The ``"taler-wallet-meta"`` stores metadata about the current major-version
database
+2. The major-version database (currently ``"taler-wallet-main-v9"`` stores the
+ actual data of the wallet.
+
+This indirection allows major database migrations to be safe despite the
limitations of IndexedDB.
+
+We have three different mechanisms to introduce changes to the database:
+
+1. Major migrations. These migrations introduce a new major-version database
and must manually
+ migrate the data from the previons major-version database. This migration
should be
+ added in ``db.ts#openTalerDatabase``.
+ Major migrations should be used **very** seldomly. It can make sense to
implement them
+ as a backup cycle, i.e. implement a backup export from the old version,
upgrade to
+ the latest backup version and then re-import into the new major-version
database.
+2. Minor schema migrations: These migrations add or remove object stores or
indexes.
+ They are done by adding new elements to the schema descriptions **and**
specifying
+ the ``versionAdded`` attribute. This causes an IndexedDB upgrade transaction
+ to be executed.
+3. Fixups. Fixups change data within or between minor schema versions and
+ contain arbitrary code to make changes to object stores. They are usually
used
+ when a new mandatory field is added to an existing object store or some data
+ format changes. Fixups are also useful to retroactively fix bugs
+ introduced by previously deployed wallet versions.
+ They must be added to ``db.ts#walletDbFixups``
+
+Alternatives
+============
+
+* Per-object versioning instead of using IndexedDB minor versions
+* Always use the backup mechanism to upgrade the database
+
+ * Would be overkill for minor migrations
+
+Drawbacks
+=========
+
+N/A.
+
+Discussion / Q&A
+================
+
+(This should be filled in with results from discussions on mailing lists /
personal communication.)
diff --git a/design-documents/index.rst b/design-documents/index.rst
index 4afb728..1bfabb0 100644
--- a/design-documents/index.rst
+++ b/design-documents/index.rst
@@ -42,4 +42,5 @@ and protocol.
031-invoicing
032-brandt-vickrey-auctions
033-database
+ 034-wallet-db-migration
999-template
--
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [taler-docs] branch master updated: add DD34,
gnunet <=