2022-09-05 00:35:32 -04:00
|
|
|
= 6.2 Migration Guide
|
2015-08-20 15:29:48 -04:00
|
|
|
:toc:
|
2022-01-05 17:24:11 -05:00
|
|
|
:toclevels: 4
|
2022-09-05 00:35:32 -04:00
|
|
|
:docsBase: https://docs.jboss.org/hibernate/orm/6.2
|
2022-01-05 17:24:11 -05:00
|
|
|
:userGuideBase: {docsBase}/userguide/html_single/Hibernate_User_Guide.html
|
|
|
|
|
:javadocsBase: {docsBase}/javadocs
|
|
|
|
|
|
|
|
|
|
|
2022-09-05 00:35:32 -04:00
|
|
|
This guide discusses migration from Hibernate ORM version 6.2. For migration from
|
2015-08-20 15:29:48 -04:00
|
|
|
earlier versions, see any other pertinent migration guides as well.
|
|
|
|
|
|
2022-09-13 14:01:24 -04:00
|
|
|
* link:../../../6.1/migration-guide/migration-guide.html[6.1 Migration guide]
|
|
|
|
|
* link:../../../6.0/migration-guide/migration-guide.html[6.0 Migration guide]
|
|
|
|
|
|
|
|
|
|
== Default DDL type changes
|
|
|
|
|
|
|
|
|
|
=== UUID mapping changes on MariaDB
|
|
|
|
|
|
|
|
|
|
On MariaDB, the type code `SqlType.UUID` now by default refers to the DDL type `uuid`, whereas before it was using `binary(16)`.
|
|
|
|
|
Due to this change, schema validation errors could occur on existing databases.
|
|
|
|
|
|
|
|
|
|
The migration to `uuid` requires a migration expression like `cast(old as uuid)`.
|
|
|
|
|
|
|
|
|
|
To retain backwards compatibility, configure the setting `hibernate.type.preferred_uuid_jdbc_type` to `BINARY`.
|
2022-09-13 14:15:28 -04:00
|
|
|
|
|
|
|
|
=== UUID mapping changes on SQL Server
|
|
|
|
|
|
|
|
|
|
On SQL Server, the type code `SqlType.UUID` now by default refers to the DDL type `uniqueidentifier`, whereas before it was using `binary(16)`.
|
|
|
|
|
Due to this change, schema validation errors could occur on existing databases.
|
|
|
|
|
|
|
|
|
|
The migration to `uuid` requires a migration expression like `cast(old as uuid)`.
|
|
|
|
|
|
|
|
|
|
To retain backwards compatibility, configure the setting `hibernate.type.preferred_uuid_jdbc_type` to `BINARY`.
|
