Using NuoDB with Hibernate


NuoDB provides explicit support for Java applications using Hibernate object-relational mapping:

  • A NuoDB specific dialect for mapping to NuoDB specific SQL.

  • Custom Driver and Connection classes, specifically designed for Hibernate.

    • Allow NuoDB to throw appropriate Hibernate exceptions related to connection errors.

  • Packaged in nuodb-hibernate.jar.

Our Hibernate drivers released before Jan 2021 has a dependency on Hibernate in order to throw the appropriate Hibernate exceptions.
If you try to use the driver without Hibernate JARs on the CLASSPATH, you will get a ClassNotFoundException due to the missing StateStateException class.
This most commonly occurs when using NuoDB as a JNDI resource in Web or JEE/Jakarta containers.

This documentation is not meant to be a full Reference or Programming manual for Hibernate. It is just meant to help you get started with Hibernate and NuoDB.


NuoDB supports Hibernate 5.x. The NuoDB JDBC driver must be installed in addition to the nuodb-hibernate.jar.

Both drivers require Java 8 or 11.


The Hibernate and JDBC JARs are published via Sonatype to Maven Central so that you can declare a dependency in your Gradle, Ivy or Maven build files. For the Maven URL required to download JAR files, see NuoDB Drivers Available at Other Public Sites. NuoDB Hibernate JAR is available for use with Hibernate 5.3 or 5.4.


  • NuoDB Driver JARs have a version number independent of NuoDB releases, starting with version 20.0.0.

  • The version numbers are subject to change. For all releases of our Hibernate JAR, go to MVN Repository.

If you would like a local copy of the jars, you can download them manually from Maven Central (see link above). Just locate the web page for the version you require, identify the Files row in the table at the top and click the jar link.

Hibernate 5 Dependencies

<!-- Maven POM -->

<!-- Gradle Build -->
compile group: 'com.nuodb.hibernate', name: 'nuodb-hibernate', version: ''
compile group: 'com.nuodb.jdbc', name: 'nuodb-jdbc', version: ''

<!-- Ivy XML -->
<dependency org="com.nuodb.jdbc" name="nuodb-jdbc" rev=""/>
<dependency org="com.nuodb.hibernate" name="nuodb-hibernate" rev=""/>