Tutorial SpringBoot: Configuración base de datos H2

Configuración base de datos H2

H2 es una base de datos en memoria especialmente útil para el desarrollo y testing de aplicaciones Spring Boot. Su principal ventaja radica en que no requiere instalación ni configuración compleja, ya que se ejecuta directamente en la JVM de nuestra aplicación.

Esta base de datos resulta ideal para entornos de desarrollo donde necesitamos datos temporales que se recrean cada vez que iniciamos la aplicación, permitiendo un ciclo de desarrollo más ágido y sin dependencias externas.

Dependencias necesarias

Para utilizar H2 en nuestro proyecto Spring Boot, necesitamos agregar las dependencias correspondientes en el archivo pom.xml:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

La dependencia spring-boot-starter-data-jpa incluye todo lo necesario para trabajar con JPA, mientras que h2 proporciona el driver de la base de datos. El scope runtime indica que H2 solo se necesita durante la ejecución, no durante la compilación.

Configuración básica en application.properties

Spring Boot detecta automáticamente H2 en el classpath y la configura por defecto. Sin embargo, podemos personalizar su comportamiento mediante el archivo application.properties:

# Configuración de la base de datos H2
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# Configuración JPA/Hibernate
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.jpa.hibernate.ddl-auto=create-drop
spring.jpa.show-sql=true

La URL jdbc:h2:mem:testdb especifica que utilizaremos una base de datos en memoria llamada testdb. El usuario por defecto es sa (system administrator) sin contraseña.

Habilitación de la consola H2

Una característica muy útil de H2 es su consola web integrada, que nos permite visualizar y manipular los datos directamente desde el navegador:

# Habilitar consola H2
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

Con esta configuración, podemos acceder a la consola visitando http://localhost:8080/h2-console cuando nuestra aplicación esté ejecutándose. La consola nos proporciona una interfaz gráfica para ejecutar consultas SQL y examinar la estructura de las tablas.

Configuración de persistencia de datos

Por defecto, H2 funciona como una base de datos en memoria, lo que significa que todos los datos se pierden al reiniciar la aplicación. Si necesitamos que los datos persistan entre reinicios durante el desarrollo, podemos configurar H2 para usar un archivo:

# Base de datos persistente en archivo
spring.datasource.url=jdbc:h2:file:./data/testdb

Esta configuración crea un archivo de base de datos en la carpeta data del proyecto. Los datos se mantendrán entre reinicios, pero seguiremos teniendo la simplicidad de configuración característica de H2.

Inicialización de datos

Spring Boot permite cargar datos iniciales automáticamente mediante archivos SQL. Podemos crear archivos en el directorio src/main/resources:

Archivo schema.sql para definir la estructura:

CREATE TABLE IF NOT EXISTS usuarios (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    nombre VARCHAR(100) NOT NULL,
    email VARCHAR(150) UNIQUE NOT NULL,
    activo BOOLEAN DEFAULT TRUE
);

Archivo data.sql para insertar datos iniciales:

INSERT INTO usuarios (nombre, email) VALUES 
('Juan Pérez', 'juan@ejemplo.com'),
('María García', 'maria@ejemplo.com'),
('Carlos López', 'carlos@ejemplo.com');

Spring Boot ejecutará automáticamente estos archivos al iniciar la aplicación, creando las tablas y poblándolas con datos de prueba.

Configuración avanzada para desarrollo

Para optimizar el uso de H2 durante el desarrollo, podemos aplicar configuraciones adicionales:

# Configuración optimizada para desarrollo
spring.jpa.hibernate.ddl-auto=create-drop
spring.jpa.defer-datasource-initialization=true
spring.sql.init.mode=always

# Logging de SQL para debugging
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.SQL=DEBUG

La propiedad defer-datasource-initialization=true asegura que los archivos data.sql se ejecuten después de que Hibernate haya creado las tablas. El modo always para spring.sql.init.mode garantiza que los scripts de inicialización se ejecuten en cada arranque.

Verificación de la configuración

Para verificar que H2 está funcionando correctamente, podemos crear un controlador de prueba simple:

@RestController
public class TestController {
    
    @Autowired
    private DataSource dataSource;
    
    @GetMapping("/db-info")
    public String getDatabaseInfo() throws SQLException {
        try (Connection connection = dataSource.getConnection()) {
            DatabaseMetaData metaData = connection.getMetaData();
            return String.format("Base de datos: %s %s", 
                metaData.getDatabaseProductName(), 
                metaData.getDatabaseProductVersion());
        }
    }
}

Este controlador nos permite confirmar que la conexión a H2 está establecida correctamente y obtener información sobre la versión de la base de datos en uso.