JPA 控制台

使用 JPA 控制台编写和运行 JPQL 查询。它为 JPQL 关键词、对象和属性名提供了有用的高亮和自动完成功能。

请确保 persistence.xml 包含持久性单元运行 JPQL 查询所需的信息：持久性提供者、持久类列表和连接属性。例如，对于 EclipseLink 和 MySQL，可能类似如下内容：

        
        <persistence-unit name="NewPersistenceUnit">
            <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
            <class>com.example.MyApp.models.ProductsEntity</class>
            ...

            <properties>
                <property name="eclipselink.jdbc.url" value="jdbc:mysql://localhost:3306/database"/>
                <property name="eclipselink.jdbc.driver" value="com.mysql.jdbc.Driver"/>
                <property name="eclipselink.jdbc.user" value="root"/>
                <property name="eclipselink.jdbc.password" value="root"/>
            </properties>
        </persistence-unit>
        
    
 

打开 JPA 控制台

请执行以下任一操作：

在 Persistence工具窗口中，右键点击一个持久化单元或实体，然后选择 JPA 控制台。或者，您也可以点击工具栏中的或者按下 Ctrl+Shift+F10。
直接在编辑器中运行查询方法。

JPA 控制台输入窗格作为单独的选项卡打开，您可以在其中编写和执行 JPQL 查询。

JPA 控制台工具栏包含以下按钮：

	`Ctrl+Enter`	运行当前查询。
		生成 SQL 语句或 DDL 脚本。 `Ctrl+Shift+Enter`生成SQL ：生成当前 JPQL 语句的 SQL 等效语句。 `Ctrl+Alt+Shift+Enter`生成DDL ：为与当前持久化单元关联的所有对象（类）生成相应的 `CREATE TABLE`、 `ALTER TABLE` 和 `DROP TABLE` 语句。
		打开 Database \| Query execution页面的设置对话框 `Ctrl+Alt+S`。
		打开形参窗格以查看查询中使用的参数并设置它们的值。
	`Ctrl+Alt+E`	打开控制台历史对话框，显示您在此控制台中运行过的所有查询。
		在布局更改后恢复原始工具窗口布局。
		选择属性来源（如果 `persistence.xml` 外部配置了持久单元，则可用）。
	`Ctrl+F2`	终止当前控制台会话。
	`Ctrl+Shift+F4`	关闭当前控制台。

运行 JPQL 查询

编写查询后，执行以下操作之一：

按下 Ctrl+Enter。
请在工具栏中点击。

当您执行带有参数的查询时，您将需要输入它们的值。或者，点击以打开形参窗格。

IntelliJ IDEA 存储您执行的所有查询。按 Up 查看之前执行的命令，从最近的一个开始。要查看完整历史记录，请点击。

从编辑器运行 Spring Data 查询方法

使用 IntelliJ IDEA，您可以直接从编辑器运行您的 Spring Data repository 查询方法。这让您在不运行应用程序的情况下验证方法的查询。您可以运行：

在 Spring Data JPA 存储库中派生查询方法：IntelliJ IDEA 解析方法名，从中派生出一个查询，并在 JPA 控制台中运行。
带有显式 JPQL 查询执行的 @Query 和 @NamedQuery 注解的方法。
带有 @NamedNativeQuery 注解的方法和带有 @Query 注解的方法以及 nativeQuery = true 属性——用于运行原生 SQL 查询。

打开您的存储库源代码。
在装订区域，点击（在控制台中运行查询）旁边的查询方法。
如果一个方法有参数，请在打开的参数对话框中输入它们的值，按下 Enter ，然后点击执行。

您可以在运行该方法时自动打开的 JPA 控制台工具窗口中检查结果查询。对于原生 SQL 查询，相应的数据库会话会在服务工具窗口中打开。查询的输出显示在工具窗口的结果标签中。

导航到类或字段的声明处

编写查询时，查看相应类或字段的声明是很有用的。

按住 Ctrl 并点击相关的对象或属性。
将文本光标放置在相关对象或属性的名称处，然后按 Ctrl+B 或从主菜单中选择导航 | 转到声明。

使用自定义 JVM 参数运行 JPA 控制台

JPA 控制台是一个 Java 进程。如果必要，您可以用自定义 JVM 选项启动它：

创建一个应用程序运行配置
请转到运行 | 编辑配置(E) ，点击，并选择应用程序。
在虚拟机选项字段中，指定您希望传递给 JVM 的启动选项。其他的运行配置设置无关紧要，您不需要指定它们。
点击确定(O) 以保存运行配置。
当您打开 JPA 控制台时，IntelliJ IDEA 将显示一个额外的虚拟机和环境配置弹出窗口，其中包含可用的运行配置。请选择具有必要 JVM 选项的那个，或使用默认设置运行。

最后修改日期： 2025年 9月 22日