sql/README.mdwn

   1 # Developer specific instructions #
   2 ## Upgrading Schema ##
   3
   4 To make changes to the database schema:
   5
   6 1. Make whatever changes are appropriate to the SQL directly in the
   7    debbugs_schema.sql file, and make corresponding changes to the
   8    database (or dump the entire database and otherwise make the
   9    changes).
  10 2. Run `./sql/dbicdump_command.sh` to update the DBIx::Class classes
  11    which are under Debbugs::DB
  12 3. Increment the version of Debbugs::DB;
  13 4. Run `./bin/debbugs-installsql --install --deployment-dir sql --developer-prepare`
  14    and `./bin/debbugs-installsql --upgrade --deployment-dir sql --developer-prepare`
  15    which will generate the files necessary to do upgrades in the field.
  16
  17
  18 Steps 1 and 2 can alternatively be performed by changing the
  19 DBIx::Class classes directly if that is desired.