Comment fonctionne exactement la propriété spring.jpa.hibernate.ddl-auto dans Spring ?

Question

Je travaillais sur mon projet d'application Spring boot et j'ai remarqué que, parfois, il y a une erreur de temps de connexion à ma base de données sur un autre serveur (SQL Server). Cela arrive spécialement quand j'essaie de faire une migration de script avec FlyWay mais cela fonctionne après plusieurs essais.

Puis j'ai remarqué que je n'avais pas précisé spring.jpa.hibernate.ddl-auto dans mon fichier de propriétés. J'ai fait quelques recherches et j'ai trouvé qu'il est recommandé d'ajouter spring.jpa.hibernate.ddl-auto= create-drop en cours de développement. Et changez-le en : spring.jpa.hibernate.ddl-auto= none en production.

Mais je n'ai pas vraiment compris comment cela fonctionne réellement et comment hibernate génère un schéma de base de données en utilisant create-drop ou none valeur. Pouvez-vous m'expliquer techniquement comment cela fonctionne réellement, et quelles sont les recommandations pour utiliser cette propriété en développement et sur un serveur de production. Merci de votre compréhension.

Answer 1

Pour mémoire, le spring.jpa.hibernate.ddl-auto est spécifique à Spring Data JPA et constitue leur moyen de spécifier une valeur qui sera éventuellement transmise à Hibernate sous la propriété qu'il connaît, hibernate.hbm2ddl.auto .

Les valeurs create , create-drop , validate y update influencent fondamentalement la façon dont la gestion de l'outil de schéma va manipuler le schéma de la base de données au démarrage.

Par exemple, le update interroge l'API du pilote JDBC pour obtenir les métadonnées de la base de données, puis Hibernate compare le modèle d'objet qu'il crée à partir de la lecture de vos classes annotées ou des mappages XML HBM et tente d'ajuster le schéma à la volée.

En update par exemple, tentera d'ajouter de nouvelles colonnes, de nouvelles contraintes, etc., mais ne supprimera jamais une colonne ou une contrainte qui a pu exister auparavant mais qui ne fait plus partie du modèle d'objet d'une exécution antérieure.

Typiquement, dans les scénarios de test, vous utiliserez probablement create-drop de sorte que vous créez votre schéma, votre scénario de test ajoute quelques données fictives, vous exécutez vos tests, puis lors du nettoyage du scénario de test, les objets du schéma sont supprimés, laissant une base de données vide.

Dans le développement, il est souvent courant de voir les développeurs utiliser update pour modifier automatiquement le schéma afin d'ajouter de nouveaux ajouts lors du redémarrage. Mais comprenez bien que cela ne supprime pas une colonne ou une contrainte qui peut exister à partir d'exécutions précédentes et qui n'est plus nécessaire.

En production, il est souvent fortement recommandé d'utiliser none ou simplement ne pas spécifier cette propriété. C'est parce que c'est une pratique courante pour les DBA d'examiner les scripts de migration pour les changements de base de données, en particulier si votre base de données est partagée entre plusieurs services et applications.

Answer 2

Dans Spring/Spring-Boot, la base de données SQL peut être initialisée de différentes manières en fonction de votre pile.

JPA dispose de fonctions de génération de DDL, qui peuvent être configurées pour s'exécuter au démarrage sur la base de données. Ceci est contrôlé par deux propriétés externes :

• spring.jpa.generate-ddl (booléen) active ou désactive la fonction et est indépendant du fournisseur.
• spring.jpa.hibernate.ddl-auto (enum) est une fonctionnalité d'Hibernate qui contrôle le comportement de manière plus fine. Voir ci-dessous pour plus de détails.

Les valeurs des propriétés Hibernate sont : create, update, create-drop, validate et none :

• create - Hibernate supprime d'abord les tables existantes, puis crée de nouvelles tables.
• mise à jour - le modèle d'objet créé à partir des mappings (annotations ou XML) est comparé au schéma existant, puis Hibernate met à jour le schéma en fonction de la différence. Il ne supprime jamais les tables ou les colonnes existantes, même si elles ne sont plus requises par l'application.
• create-drop - similaire à create, mais Hibernate abandonne la base de données une fois toutes les opérations terminées. Généralement utilisé pour les tests unitaires
• validate - Hibernate valide uniquement l'existence des tables et des colonnes, sinon il lève une exception.
• none - cette valeur désactive effectivement la génération de DDL

Spring Boot attribue par défaut à ce paramètre la valeur create-drop si aucun gestionnaire de schémas n'a été détecté, et aucune valeur dans tous les autres cas.

Answer 3

"spring.jpa.hibernate.ddl-auto= create-drop" signifie que lorsque le serveur est exécuté, l'instance de la base de données (table) est créée. Et lorsque le serveur s'arrête, l'instance de la table de la base de données est abandonnée.