Shutting down Derby or an individual database

Applications in an embedded environment shut down the Derby system by specifying the shutdown=true attribute in the connection URL. To shut down the system, you do not specify a database name, and you must not specify any other attribute.


A successful shutdown always results in an SQLException to indicate that Derby has shut down and that there is no other exception.

You can also shut down an individual database if you specify the databaseName. You can shut down the database of the current connection if you specify the default connection instead of a database name (within an SQL statement).

// shutting down a database from your application
Related tasks
Creating and accessing a database
Providing a user name and password
Encrypting a database when you create it
Booting an encrypted database
Specifying attributes in a properties object
Related reference
Using the databaseName attribute