Skip to content

Latest commit

 

History

History
41 lines (26 loc) · 2.23 KB

migration-guide.adoc

File metadata and controls

41 lines (26 loc) · 2.23 KB

5.4 Migration Guide

This guide discusses migration from Hibernate ORM version 5.3 to version 5.4. For migration from earlier versions, see any other pertinent migration guides as well.

Background

Known changes

Overriding Delayed Identity Insert Behavior

In Hibernate 5.3, we added support for DelayedPostInsertIdentifier behavior to be influenced based on the FlushMode or FlushModeType values, in short enhancing Extended PersistenceContext support. Unfortunately, there were a few side effects that were recently reported with this change.

In Hibernate 5.4, we wanted to preserve as much of the 5.3 behavior as possible and only restore very specific DelayedPostInsertIdentifier behavior for selected use cases.

We understand mappings can be complex and there very well could be a corner case we didn’t consider. In order to make 5.4 as flexible with these changes as possible, we added a configuration option that you can use as a temporary solution to completely disable the 5.3 behavior, reverting it back to 5.2 and prior.

hibernate.id.disable_delayed_identity_inserts=true

If you find you need to use this configuration setting, be sure to report the mapping to us in a JIRA issue so that we can review it and determine if the mapping corner case should be included in our algorithm since the configuration setting is meant to bridge behavior support for this across a few releases.

Hibernate Spatial depends on JTS 1.6

Hibernate Spatial depends on the Java Topology Suite (JTS). In 5.4 this dependency has been upgraded to version 1.6. This implies a change in package naming: all com.vividsolutions.jts.* packages have been renamed to org.locationtech.jts.*.

See the JTS Migration guide for more information.

SQL Server JDBC Driver version upgrade to at least 6.1.2

Due to fixing HHH-12973, you need to upgrade the JDBC Driver version to at least 6.1.2. Due to this bug, the older versions of the SQL Server JDBC Driver cannot introspect the INFORMATION_SCHEMA.SEQUENCES without closing the database connection.