Hibernate hbm2ddl.auto 配置的可能值是什么，它们的作用是什么

Question

我真的很想知道更多关于更新、导出和可以给hibernate.hbm2ddl.auto的值
我需要知道何时使用更新，何时不使用？还有什么替代方案？

这些是可能发生在 DB 上的更改：

• 新表格
• 旧表中的新列
• 列已删除
• 列的数据类型已更改
• 一种类型的列改变了它的属性
• 表已删除
• 一列的值改变了

在每种情况下，最好的解决方案是什么？

Answer 1

配置属性名为hibernate.hbm2ddl.auto

在我们的开发环境中，我们将hibernate.hbm2ddl.auto=create-drop 设置为在每次部署时删除并创建一个干净的数据库，以便我们的数据库处于已知状态。

理论上，您可以设置 hibernate.hbm2ddl.auto=update 以通过更改模型来更新您的数据库，但我不相信在生产数据库上这样做。早期版本的文档说这至少是实验性的。我不知道现在的状态。

因此，对于我们的生产数据库，不要设置hibernate.hbm2ddl.auto - 默认是不进行数据库更改。相反，我们手动创建一个 SQL DDL 更新脚本，将更改从一个版本应用到下一个版本。

Answer 2

我会使用liquibase 来更新您的数据库。 hibernate 的模式更新功能真的只是 o.k.对于开发新功能的开发人员来说。在生产环境中，需要更加小心地处理数据库升级。

Answer 3

来自community documentation：

hibernate.hbm2ddl.auto 在创建 SessionFactory 时自动验证模式 DDL 或将其导出到数据库。使用 create-drop，当 SessionFactory 显式关闭时，数据库模式将被删除。

例如验证 |更新 |创建 |创建删除

所以可能的选项列表是，

• validate：验证架构，不更改数据库。
• 更新：更新架构。
• create：创建架构，销毁以前的数据。
• create-drop：当 SessionFactory 显式关闭时删除模式，通常是在应用程序停止时。
• none：对架构不做任何事情，不对数据库做任何更改

这些选项似乎旨在成为开发人员工具，而不是促进任何生产级数据库，您可能想看看以下问题； Hibernate: hbm2ddl.auto=update in production?

Answer 4

还有“无”的未记录值可以完全禁用它。

Answer 5

我认为你应该专注于

SchemaExport Class 

这个类使你的配置动态化 因此，它允许您选择最适合的套件...

结帐[SchemaExport]

Answer 6

首先，hbm2ddl 配置属性的可能值如下：

• none - 不执行任何操作。不会生成架构。
• create-only - 将生成数据库架构。
• drop - 数据库架构将被删除。
• create - 数据库架构将被删除并在之后创建。
• create-drop - 数据库模式将被删除并在之后创建。关闭SessionFactory 后，数据库架构将被删除。
• validate - 将使用实体映射验证数据库架构。
• update - 将通过将现有数据库架构与实体映射进行比较来更新数据库架构。

如果您计划添加功能或执行一些自定义脚本，hibernate.hbm2ddl.auto="update" 很方便，但灵活性较差。

所以，最灵活的方法是使用Flyway。

但是，即使您使用 Flyway，您仍然可以使用 hbm2ddl 生成初始迁移脚本。

Answer 7

如果您不想在应用程序中使用字符串并且正在寻找预定义的常量，请查看 Hibernate JAR 中包含的 org.hibernate.cfg.AvailableSettings 类，您可以在其中找到所有可能设置的常量。以您为例：

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

Answer 8

虽然这是一篇相当老的帖子，但由于我对该主题进行了一些研究，所以想分享它。

hibernate.hbm2ddl.auto

根据文档，它可以有四个有效值：

创建 |更新 |验证 |创建删除

以下是对这些值所显示的行为的解释：

• create :- 创建架构，架构中先前存在（如果存在）的数据将丢失
• 更新：- 使用给定值更新架构。
• validate:- 验证架构。它不会对数据库进行任何更改。
• create-drop:- 创建架构并销毁先前存在的数据（如果存在）。当 SessionFactory 关闭时，它也会删除数据库架构。

以下是值得注意的重点：

• 在更新的情况下，如果数据库中不存在架构，则创建架构。
• 在 validate 的情况下，如果数据库中不存在架构，则不会创建它。相反，它会抛出一个错误：- Table not found:<table name>
• 在 create-drop 的情况下，关闭会话时不会删除架构。它仅在关闭 SessionFactory 时下降。

• 如果我给这个属性赋予任何值（比如 abc，而不是上面讨论的上述四个值）或者它只是留空。它显示以下行为：

  -如果数据库中不存在架构：- 它会创建架构

  -如果数据库中存在架构：- 更新架构。

Answer 9

自 5.0 起，您现在可以在专用的 Enum：org.hibernate.boot.SchemaAutoTooling 中找到这些值（自 5.2 起使用值 NONE 进行了增强）。

或者甚至更好，从 5.1 开始，您还可以使用 org.hibernate.tool.schema.Action Enum，它结合了 JPA 2 和“旧版”Hibernate DDL 操作。

但是，你还不能用这个以编程方式配置DataSource。将它与org.hibernate.cfg.AvailableSettings#HBM2DDL_AUTO 结合使用会更好，但当前代码需要String 值（摘自SessionFactoryBuilderImpl）：

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

... 和 org.hibernate.boot.SchemaAutoTooling 和 org.hibernate.tool.schema.Action 的内部 enum 值不会公开。

在下面，一个示例程序化 DataSource 配置（用于我的 Spring Boot 应用程序）由于.name().toLowerCase() 而使用了一个策略，但它仅适用于没有破折号的值（例如，不是create-drop）：

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

Answer 10

• validate：验证架构，数据库没有变化。
• update：使用当前执行查询更新架构。
• create：每次都会创建新的架构，并销毁以前的数据。
• create-drop：当应用程序停止或 SessionFactory 显式关闭时删除架构。

Answer 11

hibernate.hbm2ddl.auto 在创建 sessionFactory 时自动验证 DDL 并将其导出到架构。

默认情况下，它不会在 DB 上自动执行任何创建或修改。如果用户设置以下值之一，则它会自动更改 DDL 架构。

• create - 创建模式

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

• update - 更新现有架构

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

• validate - 验证现有架构

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

• create-drop - 在会话开始和结束时自动创建和删除模式

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

Answer 12

validate：它验证架构并且不对数据库进行任何更改。
假设您在映射文件中添加了一个新列并执行了插入操作，它将抛出一个异常“缺少 XYZ 列”，因为现有架构与您要插入的对象不同。如果您通过手动添加新列来更改表，然后执行插入操作，那么它肯定会将所有列与新列一起插入到表中。 意味着它不会对现有架构/表进行任何更改/更改。

update：当你执行操作时，它会改变数据库中现有的表。 您可以使用 hbm2ddl 的此选项添加或删除列。 但是，如果您要添加一个“NOT NULL”的新列，那么它将忽略将该特定列添加到数据库中。因为如果要向现有表添加“NOT NULL”列，表必须为空。

Answer 13

致寻找默认值的人...

在spring-boot 2.0.5版本和JpaProperties 1.1.0版本的源代码中编写：

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

Answer 14

综上所述... 注意这个属性叫做dll.auto，应该只控制dll操作（创建/删除模式/表），我惊讶地发现它也与dml有关：只有update允许插入数据，这是dml操作。

在尝试将数据填充到内存数据库时被这个问题抓住了；只有update 有效。