Function
Upgrades a database that was created using an earlier version of
Derby to the current version
of Derby, then connects to
it. If the database does not exist, an error appears in the error log and the
connection attempt fails with an SQLException indicating that the
database cannot be found.
This operation performs a full upgrade, as defined in "Upgrading a database"
in the Derby Developer's Guide. For more information
about upgrades, see the other topics under "Upgrades" in the
Derby Developer's Guide.
For a database for which authentication and SQL authorization are both
enabled, only the database
owner can perform a full upgrade. See also "Enabling user
authentication" and "Setting the SQL standard authorization mode" in the
Derby Developer's Guide for more information.
Note: You cannot perform a full upgrade on a database already booted
in soft upgrade mode. If a database is already booted in soft upgrade mode,
the upgrade=true attribute will have no effect.
If a database is already booted in soft upgrade mode,
you can first shutdown the database with the
shutdown=true
attribute and then connect with upgrade=true to perform the upgrade.