0

0

如何在 JPA 标准模式下正确生成数据库表结构(DDL)

心靈之曲

心靈之曲

发布时间:2026-01-19 23:37:08

|

828人浏览过

|

来源于php中文网

原创

如何在 JPA 标准模式下正确生成数据库表结构(DDL)

hibernate 6.x 中使用 jpa 标准 ddl 生成配置时,仅设置脚本导出属性无法自动创建数据库表,必须显式指定 `jakarta.persistence.schema-generation.database.action` 才能同步更新数据库。

在 Hibernate 6.1+ 中,JPA 规范定义了一套标准化的 Schema 生成机制(jakarta.persistence.schema-generation.*),它与传统的 Hibernate 原生属性(如 hibernate.hbm2ddl.auto)互不兼容。当您切换到 JPA 标准方式时,脚本生成(.sql 文件输出)和数据库实际执行是两个独立控制的行为——这意味着即使 scripts.create-target 正确生成了 tables.sql,若未启用数据库操作,H2 内存库中依然不会创建任何表。

关键配置项如下:

  • jakarta.persistence.schema-generation.scripts.action:控制是否生成 SQL 脚本(none / create / drop-and-create / drop)
  • jakarta.persistence.schema-generation.create-source:指定 DDL 源(metadata 表示基于实体注解;script 表示读取外部 SQL 文件)
  • jakarta.persistence.schema-generation.scripts.create-target:指定生成的 SQL 文件路径(如 tables.sql)
  • jakarta.persistence.schema-generation.database.action决定是否对数据库执行操作(none / create / drop-and-create / drop)——该属性默认为 none,即“只生成脚本,不操作数据库”,这正是您遇到问题的根本原因。

✅ 正确的 persistence.xml 配置应补充该关键属性:

星月写作
星月写作

专为网络小说、 剧本创作者打造的AI增效工具

下载
<property name="jakarta.persistence.schema-generation.database.action" value="create"/>

完整示例(含脚本导出 + 数据库执行):

<persistence-unit name="com.whatever.persistence.jpa">
    <properties>
        <property name="jakarta.persistence.jdbc.driver" value="org.h2.Driver"/>
        <property name="jakarta.persistence.jdbc.url" value="jdbc:h2:mem:db1;DB_CLOSE_DELAY=-1"/>
        <property name="jakarta.persistence.jdbc.user" value="sa"/>
        <property name="jakarta.persistence.jdbc.password" value=""/>

        <property name="hibernate.show_sql" value="true"/>
        <property name="hibernate.format_sql" value="true"/>

        <!-- 启用 JPA 标准 DDL 生成 -->
        <property name="jakarta.persistence.schema-generation.scripts.action" value="create"/>
        <property name="jakarta.persistence.schema-generation.create-source" value="metadata"/>
        <property name="jakarta.persistence.schema-generation.scripts.create-target" value="target/tables.sql"/>

        <!-- ✅ 关键:触发数据库实际建表 -->
        <property name="jakarta.persistence.schema-generation.database.action" value="create"/>
    </properties>
</persistence-unit>

⚠️ 注意事项:

  • database.action 和 scripts.action 可独立设置(例如:database.action=none + scripts.action=create → 仅导出 SQL;database.action=create + scripts.action=none → 仅建库不写文件)。
  • 若同时启用两者,Hibernate 会先执行数据库操作,再生成对应脚本(顺序固定)。
  • 使用内存数据库(如 H2)时,请确保应用启动后有至少一次 EntityManagerFactory 初始化(如 Spring Boot 中 spring.jpa.hibernate.ddl-auto 已弃用,应完全依赖 JPA 标准属性)。
  • 生产环境强烈建议将 database.action 设为 none,改用 Flyway/Liquibase 管理 Schema 版本,避免运行时自动 DDL 带来的风险。

总结:JPA 标准 DDL 是面向可移植性的设计,其“生成”与“执行”职责分离。遗漏 database.action 就如同写了建表语句却忘了按回车——脚本有了,但数据库仍是空的。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

1133

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

381

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2152

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

380

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

1663

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

585

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

440

2024.04.29

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号