What are the possible values of the Hibernate hbm2ddl.auto configuration and what do they do
Asked Answered
S

14

1262

I really want to know more about the update, export and the values that could be given to hibernate.hbm2ddl.auto
I need to know when to use the update and when not? And what is the alternative?

These are changes that could happen over DB:

  • new tables
  • new columns in old tables
  • columns deleted
  • data type of a column changed
  • a type of a column changed its attributes
  • tables dropped
  • values of a column changed

In each case what is the best solution?

Sump answered 13/1, 2009 at 6:40 Comment(0)
G
1237

From the community documentation:

hibernate.hbm2ddl.auto Automatically validates or exports schema DDL to the database when the SessionFactory is created. With create-drop, the database schema will be dropped when the SessionFactory is closed explicitly.

e.g. validate | update | create | create-drop

So the list of possible options are,

  • validate: validate the schema, makes no changes to the database.
  • create-only: database creation will be generated.
  • drop: database dropping will be generated.
  • update: update the schema.
  • create: creates the schema, destroying previous data.
  • create-drop: drop the schema when the SessionFactory is closed explicitly, typically when the application is stopped.
  • none: does nothing with the schema, makes no changes to the database

These options seem intended to be developers tools and not to facilitate any production level databases, you may want to have a look at the following question; Hibernate: hbm2ddl.auto=update in production?

Garceau answered 6/11, 2009 at 19:25 Comment(13)
Just read the hibernate docu ... for valid values, it says: "e.g." ... are there any other valid values?Pugging
Not that I am aware of. They could be misusing e.g., or the values could simply be undocumented.Garceau
I think it says "e.g." because it's just a community documentation, if someone's interested in all the possible values, it can be found in Hibernate's javadoc. (And yes, only those four options are present) docs.jboss.org/hibernate/orm/4.1/javadocs/org/hibernate/cfg/…Interblend
validate says validate the schema , what exactly does it mean ??Elbertina
Hi - afaik I know, and saw throught usage, "validate" means just that - it will compare the database schema against your declared (or annotated) datalayer (Hibernate), and complain (or break?) if things do not match. But it won't make any changes to the database itself.Josefajosefina
A thing that i've had noticed is that if I change the column type into the model, the same column on database is not changed with updateMam
'empty string' can also be used.Meditate
You can also use 'aardvark', or 'pigeon' or any other word, if you want hibernate to do nothing. Not that I would recommend that of course!Teetotalism
Is there any option that says, just create if don't exist, don't update, don't drop :(Mer
A small addition to the create-drop option. If this option is used it does not drop the whole schema instead it drops the tables whose mappings are available while running this. For example if a database with Schema S has A, B, C tables and java code has mappings for A and B only then Hibernate will not drop the table C.Annates
@Annates create-drop does not drop the "Schema" and does not create it.Habakkuk
Note that create-drop do not drop database just closing session but the Session Factory.Reggiereggis
My experience contradicts with @Ward's comment: when I use a value like "no_validation", I get: ``` java.lang.IllegalArgumentException: Unrecognized legacy hibernate.hbm2ddl.auto value : no_validation ```Ricardaricardama
J
213

There's also the value of none to disable it entirely.

Jaquesdalcroze answered 8/6, 2012 at 14:52 Comment(7)
This is actually quite useful since Hibernate’s schema validation sometimes fails for perfectly valid schemas.Aspasia
I was just about to ask for something like this. My intention is to reduce startup time.Illampu
The 'none' value is very useful also when you want to use dynamic/programmatic configuration of Hibernate; any other value would cause an error when the application is started.Manrope
'empty string' is better than 'none'. To use 'none', you will receive warning message: org.hibernate.cfg.SettingsFactory - Unrecognized value for "hibernate.hbm2ddl.auto": noneMeditate
I've patched it. Added "none" as an explicitly valid constant.Isidoro
I like "hibernate.hbm2ddl.auto=potato" over others https://mcmap.net/q/46600/-how-to-turn-off-hbm2ddlMono
Look for log "Unrecognized hbm2ddl_auto value : none. Supported values include create, create-drop, update, and validate. Ignoring". :DGerardgerardo
V
172

The configuration property is called hibernate.hbm2ddl.auto

In our development environment we set hibernate.hbm2ddl.auto=create-drop to drop and create a clean database each time we deploy, so that our database is in a known state.

In theory, you can set hibernate.hbm2ddl.auto=update to update your database with changes to your model, but I would not trust that on a production database. An earlier version of the documentation said that this was experimental, at least; I do not know the current status.

Therefore, for our production database, do not set hibernate.hbm2ddl.auto - the default is to make no database changes. Instead, we manually create an SQL DDL update script that applies changes from one version to the next.

Viscus answered 13/1, 2009 at 8:11 Comment(3)
Actually, per the documentation, create-drop creates the database tables and drops them when the session factory is explicitly closed. It does not drop the tables when the session factory is created.Crusted
No, both create-drop and create drop the tables when the sessionfactory is created, then create-drop drops the tables also when sessionfactory is closed. See https://mcmap.net/q/46601/-schema-is-not-dropped-on-hbmddl-auto-create-dropOverskirt
does making hibernate.hbm2ddl.auto=create-drop in production can lead to several connection timeout in production ?Presentationism
F
110

First, the possible values for the hbm2ddl configuration property are the following ones:

  • none - No action is performed. The schema will not be generated.
  • create-only - The database schema will be generated.
  • drop - The database schema will be dropped.
  • create - The database schema will be dropped and created afterward.
  • create-drop - The database schema will be dropped and created afterward. Upon closing the SessionFactory, the database schema will be dropped.
  • validate - The database schema will be validated using the entity mappings.
  • update - The database schema will be updated by comparing the existing database schema with the entity mappings.

The hibernate.hbm2ddl.auto="update" is convenient but less flexible if you plan on adding functions or executing some custom scripts.

So, The most flexible approach is to use Flyway.

However, even if you use Flyway, you can still generate the initial migration script using hbm2ddl.

Frogmouth answered 15/5, 2014 at 12:46 Comment(4)
drop doesn't seem to be a valid option. Which version of hibernate are you referring to?Bennettbenni
It's been a valid option since Hibernate 5.1, which was released in 2016. Check out the Action enum for more details. I assume you are using a very old Hibernate version.Frogmouth
what is the exact difference between validate vs update.Negotiable
The answer tells the difference.Frogmouth
A
52

I would use liquibase for updating your db. hibernate's schema update feature is really only o.k. for a developer while they are developing new features. In a production situation, the db upgrade needs to be handled more carefully.

Armbruster answered 23/3, 2009 at 7:40 Comment(1)
See #221879 for why you shouldn't use hbm2ddl for production.Frisky
N
51

Although it is quite an old post but as i did some research on the topic so thought of sharing it.

hibernate.hbm2ddl.auto

As per the documentation it can have four valid values:

create | update | validate | create-drop

Following is the explanation of the behaviour shown by these value:

  • create :- create the schema, the data previously present (if there) in the schema is lost
  • update:- update the schema with the given values.
  • validate:- validate the schema. It makes no change in the DB.
  • create-drop:- create the schema with destroying the data previously present(if there). It also drop the database schema when the SessionFactory is closed.

Following are the important points worth noting:

  • In case of update, if schema is not present in the DB then the schema is created.
  • In case of validate, if schema does not exists in DB, it is not created. Instead, it will throw an error:- Table not found:<table name>
  • In case of create-drop, schema is not dropped on closing the session. It drops only on closing the SessionFactory.
  • In case if i give any value to this property(say abc, instead of above four values discussed above) or it is just left blank. It shows following behaviour:

    -If schema is not present in the DB:- It creates the schema

    -If schema is present in the DB:- update the schema.

Nitz answered 7/8, 2016 at 14:11 Comment(3)
It's indeed a very important point that schema will be created if it doesn't exist, when "update" is used.Liles
create-drop is contradicted when compare "Explanation of the behaviour" and "Important Points" statements.Rosinski
What's the difference between update and empty?Edwin
P
27

hibernate.hbm2ddl.auto automatically validates and exports DDL to the schema when the sessionFactory is created.

By default, it does not perform any creation or modification automatically on DB. If the user sets one of the below values then it is doing DDL schema changes automatically.

  • create - doing creating a schema

    <entry key="hibernate.hbm2ddl.auto" value="create">
    
  • update - updating existing schema

    <entry key="hibernate.hbm2ddl.auto" value="update">
    
  • validate - validate existing schema

    <entry key="hibernate.hbm2ddl.auto" value="validate">
    
  • create-drop - create and drop the schema automatically when a session is starts and ends

    <entry key="hibernate.hbm2ddl.auto" value="create-drop">
    
Pharos answered 11/5, 2017 at 17:26 Comment(1)
what about <entry key="hibernate.hbm2ddl.auto" value="none"> ?Rosinski
E
18

If you don't want to use Strings in your app and are looking for predefined constants have a look at org.hibernate.cfg.AvailableSettings class included in the Hibernate JAR, where you'll find a constant for all possible settings. In your case for example:

/**
 * Auto export/update schema using hbm2ddl tool. Valid values are <tt>update</tt>,
 * <tt>create</tt>, <tt>create-drop</tt> and <tt>validate</tt>.
 */
String HBM2DDL_AUTO = "hibernate.hbm2ddl.auto";
Endorsement answered 10/2, 2015 at 9:56 Comment(2)
Why is reference to 700+ lines long source file above straight answer with almost 500 vole ups ?Blumenthal
... that question doesnt make any sense. Why are there things? Why am i even here?Chavey
G
10
  • validate: validates the schema, no change happens to the database.
  • update: updates the schema with current execute query.
  • create: creates new schema every time, and destroys previous data.
  • create-drop: drops the schema when the application is stopped or SessionFactory is closed explicitly.
Gaston answered 3/3, 2017 at 10:51 Comment(1)
Whats the 'official' documentation reference? - just wondering...Iata
T
7

I Think you should have to concentrate on the

SchemaExport Class 

this Class Makes Your Configuration Dynamic So it allows you to choose whatever suites you best...

Checkout [SchemaExport]

Toadfish answered 21/6, 2012 at 2:12 Comment(0)
S
4

validate: It validates the schema and makes no changes to the DB.
Assume you have added a new column in the mapping file and perform the insert operation, it will throw an Exception "missing the XYZ column" because the existing schema is different than the object you are going to insert. If you alter the table by adding that new column manually then perform the Insert operation then it will definitely insert all columns along with the new column to the Table. Means it doesn't make any changes/alters the existing schema/table.

update: it alters the existing table in the database when you perform operation. You can add or remove columns with this option of hbm2ddl. But if you are going to add a new column that is 'NOT NULL' then it will ignore adding that particular column to the DB. Because the Table must be empty if you want to add a 'NOT NULL' column to the existing table.

Selfregulated answered 15/10, 2017 at 14:44 Comment(0)
S
3

Since 5.0, you can now find those values in a dedicated Enum: org.hibernate.boot.SchemaAutoTooling (enhanced with value NONE since 5.2).

Or even better, since 5.1, you can also use the org.hibernate.tool.schema.Action Enum which combines JPA 2 and "legacy" Hibernate DDL actions.

But, you cannot yet configure a DataSource programmatically with this. It would be nicer to use this combined with org.hibernate.cfg.AvailableSettings#HBM2DDL_AUTO but the current code expect a String value (excerpt taken from SessionFactoryBuilderImpl):

this.schemaAutoTooling = SchemaAutoTooling.interpret( (String) configurationSettings.get( AvailableSettings.HBM2DDL_AUTO ) );

… and internal enum values of both org.hibernate.boot.SchemaAutoToolingand org.hibernate.tool.schema.Action aren't exposed publicly.

Hereunder, a sample programmatic DataSource configuration (used in ones of my Spring Boot applications) which use a gambit thanks to .name().toLowerCase() but it only works with values without dash (not create-drop for instance):

@Bean(name = ENTITY_MANAGER_NAME)
public LocalContainerEntityManagerFactoryBean internalEntityManagerFactory(
        EntityManagerFactoryBuilder builder,
        @Qualifier(DATA_SOURCE_NAME) DataSource internalDataSource) {

    Map<String, Object> properties = new HashMap<>();
    properties.put(AvailableSettings.HBM2DDL_AUTO, SchemaAutoTooling.CREATE.name().toLowerCase());
    properties.put(AvailableSettings.DIALECT, H2Dialect.class.getName());

    return builder
            .dataSource(internalDataSource)
            .packages(JpaModelsScanEntry.class, Jsr310JpaConverters.class)
            .persistenceUnit(PERSISTENCE_UNIT_NAME)
            .properties(properties)
            .build();
}
Statuette answered 11/8, 2016 at 10:45 Comment(0)
F
2

To whomever searching for default value...

It is written in the source code at version 2.0.5 of spring-boot and 1.1.0 at JpaProperties:

    /**
     * DDL mode. This is actually a shortcut for the "hibernate.hbm2ddl.auto"
     * property. Defaults to "create-drop" when using an embedded database and no
     * schema manager was detected. Otherwise, defaults to "none".
     */
    private String ddlAuto;
Flap answered 22/5, 2020 at 19:10 Comment(0)
B
0

With all above said... Notice this property is called dll.auto and should only control dll operations(create/drop schema/table), I found surprisingly that it has to do with dml, too: only update will allow insert data, which is dml operation.

Got caught by this when trying to populate data into a in-memory database; only update works.

Bivalve answered 16/9, 2021 at 6:54 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.