Description: This section explains how to use and configure Derby in an embedded environment.

# Derby embedded basics

This section explains how to use and configure Derby in an embedded environment.

Included in the installation is a sample application program, /demo/programs/simple, which illustrates how to run Derby embedded in the calling program.

- Embedded Derby JDBC driver
  The Derby driver class name for the embedded environment is org.apache.derby.jdbc.EmbeddedDriver.
- Embedded Derby JDBC database connection URL
  This is the standard Derby JDBC connection URL, which you can use for tasks besides connecting to a database.
- Getting a nested connection
  When you are executing a method within SQL, that method might need to reuse the current connection to the database in order to execute more SQL statements. Such a connection is called a nested connection. The way for a method to get a nested connection is to issue a connection request using the connection URL.
- Starting Derby as an embedded database
  To start Derby, you start the Derby JDBC driver. Starting the Derby driver starts up the complete Derby system within the current JVM.