Quali sono i possibili valori della configurazione di Hibernate hbm2ddl.auto e cosa fanno

Voglio davvero saperne di più sull'aggiornamento, sull'esportazione e sui valori che potrebbero essere forniti. hibernate.hbm2ddl.auto
Devo sapere quando utilizzare l'aggiornamento e quando no? E qual è l'alternativa?

Queste sono le modifiche che potrebbero verificarsi sul DB:

• nuovi tavoli
• nuove colonne in vecchie tabelle
• colonne eliminate
• il tipo di dati di una colonna è cambiato
• un tipo di colonna ha cambiato i suoi attributi
• tavoli caduti
• i valori di una colonna sono cambiati

In ogni caso qual è la soluzione migliore?

Dalla documentazione della comunità :

hibernate.hbm2ddl.auto Convalida o esporta automaticamente lo schema DDL nel database quando viene creato SessionFactory. Con create-drop, lo schema del database verrà eliminato quando SessionFactory viene chiusa in modo esplicito.

es. validare | aggiornamento | creare | creare-drop

Quindi l'elenco delle possibili opzioni sono,

• convalida : convalida lo schema, non apporta modifiche al database.
• aggiornamento : aggiorna lo schema.
• crea : crea lo schema, distruggendo i dati precedenti.
• create-drop : elimina lo schema quando SessionFactory viene chiusa in modo esplicito, in genere quando l'applicazione viene arrestata.
• none : non fa nulla con lo schema, non modifica il database

Queste opzioni sembrano essere strumenti per sviluppatori e non per facilitare alcun database a livello di produzione, potresti voler dare un'occhiata alla seguente domanda; Sospensione: hbm2ddl.auto = aggiornamento in produzione?

C'è anche il valore non documentato di "none" per disabilitarlo del tutto.

Viene chiamata la proprietà di configurazione hibernate.hbm2ddl.auto

Nel nostro ambiente di sviluppo decidiamo hibernate.hbm2ddl.auto=create-dropdi eliminare e creare un database pulito ogni volta che lo distribuiamo, in modo che il nostro database sia in uno stato noto.

In teoria, puoi impostare hibernate.hbm2ddl.auto=updatel'aggiornamento del tuo database con modifiche al tuo modello, ma non mi fiderei di questo su un database di produzione. Una versione precedente della documentazione diceva che questo era almeno sperimentale; Non conosco lo stato attuale.

Pertanto, per il nostro database di produzione, non impostare hibernate.hbm2ddl.auto: l'impostazione predefinita è di non apportare modifiche al database. Invece, creiamo manualmente uno script di aggiornamento DDL SQL che applica le modifiche da una versione alla successiva.

Vorrei usare liquibase per aggiornare il tuo db. La funzionalità di aggiornamento dello schema di hibernate è davvero valida solo per uno sviluppatore mentre stanno sviluppando nuove funzionalità. In una situazione di produzione, l'aggiornamento del db deve essere gestito con più attenzione.

Anche se è un post piuttosto vecchio, ma come ho fatto alcune ricerche sull'argomento, ho pensato di condividerlo.

hibernate.hbm2ddl.auto

Secondo la documentazione può avere quattro valori validi:

creare | aggiornamento | convalidare | creare-drop

Di seguito è la spiegazione del comportamento mostrato da questi valori:

• crea : - crea lo schema, i dati precedentemente presenti (se presenti) nello schema vengono persi
• aggiornamento: - aggiorna lo schema con i valori indicati.
• validate: - validate lo schema. Non effettua alcuna modifica nel DB.
• create-drop: - crea lo schema distruggendo i dati precedentemente presenti (se presenti). Elimina anche lo schema del database quando SessionFactory è chiusa.

Di seguito sono riportati i punti importanti da notare:

• In caso di aggiornamento , se lo schema non è presente nel DB, viene creato lo schema.
• In caso di convalida , se lo schema non esiste nel DB, non viene creato. Invece, genererà un errore: -Table not found:<table name>
• In caso di create-drop , lo schema non viene rilasciato alla chiusura della sessione. Cade solo alla chiusura della SessionFactory.

• Nel caso in cui do un valore a questa proprietà (diciamo abc, invece di sopra quattro valori discussi sopra) o viene lasciato vuoto. Mostra il seguente comportamento:

  -Se lo schema non è presente nel DB: - Crea lo schema

  -Se lo schema è presente nel DB: - aggiorna lo schema.

Innanzitutto, i possibili valori per la hbm2ddlproprietà di configurazione sono i seguenti:

• none- Non viene eseguita alcuna azione. Lo schema non verrà generato.
• create-only - Verrà generato lo schema del database.
• drop - Lo schema del database verrà eliminato e creato in seguito.
• create - Lo schema del database verrà eliminato e creato in seguito.
• create-drop- Lo schema del database verrà eliminato e creato in seguito. Alla chiusura di the SessionFactory, lo schema del database verrà eliminato.
• validate - Lo schema del database verrà convalidato utilizzando i mapping delle entità.
• update - Lo schema del database verrà aggiornato confrontando lo schema del database esistente con i mapping delle entità.

Ho dedicato un post sul blog alle più comuni strategie di generazione DDL di Hibernate :

1. Il hibernate.hbm2ddl.auto="update"è conveniente, ma meno flessibile se avete intenzione di aggiungere funzioni o l'esecuzione di alcuni script personalizzati.
2. L' approccio più flessibile è utilizzare Flyway .

Tuttavia, anche se si utilizza Flyway, è comunque possibile generare lo script di migrazione iniziale utilizzando hbm2ddl. In questo articolo , puoi vedere come combinare il modello di entità JPA con il modello di tabella jOOQ.

hibernate.hbm2ddl.auto convalida automaticamente ed esporta DDL nello schema quando viene creata sessionFactory.

Per impostazione predefinita, non esegue alcuna creazione o modifica automaticamente sul DB. Se l'utente imposta uno dei valori seguenti, sta facendo automaticamente le modifiche allo schema DDL.

• creare - facendo creando uno schema

  <entry key="hibernate.hbm2ddl.auto" value="create">

• aggiornamento - aggiornamento dello schema esistente

  <entry key="hibernate.hbm2ddl.auto" value="update">

• validate - convalida lo schema esistente

  <entry key="hibernate.hbm2ddl.auto" value="validate">

• create-drop: crea e rilascia lo schema automaticamente all'avvio e alla fine di una sessione

  <entry key="hibernate.hbm2ddl.auto" value="create-drop">

Se non vuoi usare le stringhe nella tua app e stai cercando costanti predefinite dai un'occhiata alla org.hibernate.cfg.AvailableSettingsclasse inclusa nel JAR di Hibernate, dove troverai una costante per tutte le possibili impostazioni. Nel tuo caso ad esempio:

/**
 * 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";

• validate: convalida lo schema, nessuna modifica al database.
• update: aggiorna lo schema con la query di esecuzione corrente.
• create: crea ogni volta un nuovo schema e distrugge i dati precedenti.
• create-drop: elimina lo schema quando l'applicazione viene arrestata o SessionFactory viene chiusa esplicitamente.

Penso che dovresti concentrarti su

SchemaExport Class 

questa classe rende dinamica la tua configurazione Quindi ti consente di scegliere qualsiasi suite tu preferisca ...

Acquista [SchemaExport]

validate: Convalida lo schema e non apporta modifiche al DB.
Supponiamo di aver aggiunto una nuova colonna nel file di mapping ed eseguire l'operazione di inserimento, genererà un'eccezione "mancante della colonna XYZ" perché lo schema esistente è diverso dall'oggetto che si intende inserire. Se si modifica la tabella aggiungendo manualmente quella nuova colonna, quindi si esegue l'operazione Inserisci, verranno sicuramente inserite tutte le colonne insieme alla nuova colonna nella tabella. Significa che non apporta alcuna modifica / modifica lo schema / tabella esistente.

update: modifica la tabella esistente nel database quando si esegue l'operazione. È possibile aggiungere o rimuovere colonne con questa opzione di hbm2ddl. Ma se hai intenzione di aggiungere una nuova colonna che è 'NOT NULL', ignorerà l'aggiunta di quella particolare colonna al DB. Perché la tabella deve essere vuota se si desidera aggiungere una colonna "NOT NULL" alla tabella esistente.

Da 5.0 , ora puoi trovare quei valori in un dedicato Enum: org.hibernate.boot.SchemaAutoTooling(migliorato con valore NONEda 5.2).

O ancora meglio, dal 5.1 , puoi anche usare la combinazione di azioni JPA 2 e Hibernate DDL "legacy".org.hibernate.tool.schema.Action Enum

Ma non è ancora possibile configurarlo a livello di DataSourceprogrammazione con questo. Sarebbe meglio usarlo insieme a org.hibernate.cfg.AvailableSettings#HBM2DDL_AUTOma il codice corrente prevede un Stringvalore (estratto da SessionFactoryBuilderImpl):

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

... e i enumvalori interni di entrambi org.hibernate.boot.SchemaAutoToolinge org.hibernate.tool.schema.Actionnon sono esposti pubblicamente.

Di seguito, una DataSourceconfigurazione programmatica di esempio (utilizzata in una delle mie applicazioni Spring Boot) che utilizza un gambetto grazie .name().toLowerCase()ma funziona solo con valori senza trattino (non create-dropper esempio):

@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();
}

A chi cerca il valore predefinito ...

È scritto nel codice sorgente alla versione 2.0.5 di Spring-Boot e 1.1.0 su 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;