Skip to content

Commit

Permalink
Reference further documentation for database migrations
Browse files Browse the repository at this point in the history
* Reference sections explaining how to import production data and how to
  tackle performance problems as both are very relevant when creating
  database migrations
* Related ticket: https://progress.opensuse.org/issues/112946
  • Loading branch information
Martchus committed Jun 1, 2023
1 parent b5e148d commit 245dff7
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions docs/Contributing.asciidoc
Expand Up @@ -481,6 +481,16 @@ createdb -O ownername -T originaldb newdb
To initialize or update the database manually before restarting the web UI you can run
either `./script/initdb --init_database` or `./script/upgradedb --upgrade_database`.

Migrations that affect possibly big tables should be tested against a production
database to see how much time they need. Checkout the
<<Contributing.asciidoc#importing-production-data,Importing production data>> section
for details.

A migration can cause the analyser to regress so it produces worse query plans leading
to impaired performance. Checkout the
<<Installing.asciidoc#_working_on_database_related_performance_problems,Working on database-related performance problems>>
section for how to tackle this problem.

=== How to add fixtures to the database

Note: This section is not about the fixtures for the testsuite. Those are located
Expand Down

0 comments on commit 245dff7

Please sign in to comment.