JPA 控制台
JPA 控制台 可让您使用以下语言编写、验证和运行查询:
Jakarta Persistence 查询语言 (JPQL)
Jakarta Data 查询语言 (JDQL)
Hibernate 查询语言 (HQL)
EclipseLink 查询语言 (EQL)
前提
以下插件已启用:
数据库工具和 SQL(捆绑)
要检查插件是否已启用,请 打开插件设置。
项目使用 JDK 8 或更高版本。
构建文件( pom.xml 或 build.gradle )至少包含以下 API 之一:
Jakarta 持久化
Hibernate
EclipseLink
Spring Data JPA
项目文件至少包含一个实体类。
数据库 工具窗口至少列出一个数据源。
打开控制台
如果想运行代码中不存在的 JPQL、JDQL、HQL 或 EQL 查询,或者希望控制台使用自定义 JVM 选项,请手动打开 JPA 控制台。
使用默认设置打开控制台
打开 Persistence 工具窗口()。
选择持久性单元。
在工具窗口工具栏中,点击
JPA 控制台。

或者按 Ctrl+Shift+F10。
JPA 控制台 将在专用工具窗口中打开。 现在可以 运行查询。

要了解控制台中图标的含义,请参阅 参考:JPA 控制台。
使用自定义 JVM 选项打开控制台
JPA 控制台 在单独的 Java 进程中运行。 可以通过创建 运行配置 ,然后在打开控制台时选择该配置,使用自定义 JVM 选项运行此进程。
打开 运行/调试配置 对话框:
在主工具栏,点击 运行微件并选择 编辑配置…。
或者,转到 。
在对话框左侧,选择 。
在对话框右侧,选择 。
在 VM 选项 字段中,指定打开 JPA 控制台 时要传递给 JVM 的选项。

也可以设置其他 运行配置设置 ,但控制台不需要这些设置。
点击 应用 ,然后 OK。
打开 持久化 工具窗口 ()。
选择持久性单元。
在工具窗口的工具栏中,选择 。

JPA 控制台 将在应用了 JVM 选项的专用工具窗口中打开。 现在可以 运行查询。
要了解控制台中图标的含义,请参阅 参考:JPA 控制台。
运行查询
可以从控制台本身或从编辑器在 JPA 控制台 中运行查询。
JPA 控制台 会针对 数据库工具窗口中的数据源运行查询。 如果有多个数据源,IDE 会按以下配置(按此顺序)查找匹配项:正在运行的 Spring 调试器 会话、 持久化 工具窗口中的显式赋值,或 Spring Boot 配置文件中的数据源 URL。 如果 IntelliJ IDEA 无法确定要使用哪个数据源,系统会提示选择一个。
从 JPA 控制台运行查询
键入或粘贴查询。
在控制台工具栏中,点击
执行查询。
或者按 Ctrl+Enter。
如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。
JPA 控制台 将执行查询,并在新选项卡中 显示其结果。
从编辑器运行查询
将文本光标放在编辑器中的查询处。
右键点击查询并选择 。
或者,按 Alt+Enter 并选择
在控制台中运行查询。
如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。
JPA 控制台 会执行查询并 显示其结果。
从装订区域运行 Jakarta Data 查询方法
如果项目使用 Jakarta Data 仓库,可以直接从编辑器装订区域运行其查询方法。
在编辑器中打开 Jakarta Data 仓库。
在装订区域中,点击查询方法旁边的
在控制台中运行查询。
如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。
JPA 控制台 会执行查询并 显示其结果。

从装订区域运行 Spring Data 查询方法
如果项目使用 Spring Data 仓库 ,可以直接从编辑器装订区域运行其查询方法。
在编辑器中打开 Spring Data 仓库。
在装订区域中,点击查询方法旁边的
在控制台中运行查询。
如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。
如果查询以 JPQL 编写或从方法名称派生, JPA 控制台 将执行查询并 显示其结果。

参考:JPA 控制台

JPA 控制台 由以下组件组成:
会话选项卡:保存单个控制台 会话并包含其他组件。 该选项卡按持久性单元的名称命名。
查询工具栏:用于执行查询、配置查询执行设置以及管理控制台会话。
控制台选项卡:显示控制台日志,并允许键入查询。 该选项卡按持久性单元的名称命名。
结果选项卡:显示单个已执行查询的结果,并允许自定义结果的显示方式。 每次执行查询都会打开一个新选项卡。
查询工具栏
执行查询 (Ctrl+Enter)
运行当前键入的查询。
打开查询执行设置…
打开 查询执行 页面(位于 设置 对话框中)。
查看参数
打开 参数 窗格,查看查询接受的形参并设置其值。
浏览查询历史 (Ctrl+Alt+E)
打开 历史记录 对话框,查看已为此持久性单元运行的所有查询,并可选择将选定的查询复制到控制台。
恢复默认布局
恢复原始控制台布局。
终止进程 (Ctrl+F2)
断开控制台与数据库的连接,但保持会话选项卡打开。
关闭 (Ctrl+Shift+F4)
断开控制台与数据库的连接,并关闭当前打开的会话选项卡。
Console(控制台)选项卡页
自动换行
在控制台日志中对长行自动换行。
滚动到末尾
跳转到控制台日志底部。
打印…
打开 打印对话框。
全部清除
清除控制台日志。
结果选项卡
切换到表
以数据库表的形式查看结果。
有关更多信息,请参阅 探索值。
切换到图表
以图表形式查看结果。
有关更多信息,请参阅 可视化数据。
重新加载页面 (Ctrl+F5)
重新加载数据。
表结果自动刷新
选择数据自动刷新的频率。
固定选项卡
固定当前打开的结果选项卡。
在当前页查找
在当前显示的页面上搜索特定值的数据。
表结果本地筛选器
为所有列启用筛选或清除所有筛选器。
有关更多信息,请参阅 使用本地过滤器。
记录视图
打开侧边窗格以查看所选记录中的数据。
有关更多信息,请参阅 单记录视图。
表着色选项
配置表单元格的颜色映射。
有关更多信息,请参阅 应用热力图。
显示地理位置查看器
打开交互式地图,以查看结果中的地理坐标。
有关更多信息,请参阅 查看地理数据。
数据提取器
选择数据的输出格式。
有关更多信息,请参阅 数据提取工具。
导出数据 (表视图)
打开 导出数据对话框。
导出为 PNG (图表视图)
将图表下载为 PNG 图像。
导入
打开 导入对话框。
比较数据
将此结果与 查询控制台中的结果进行比较。
视图方式
选择数据视图模式。
有关更多信息,请参阅 数据视图模式。
显示选项菜单 (表视图)
打开包含以下选项的列表:
显示值编辑器 :打开 值编辑器 ,查看所选单元格中的数据。
显示汇总视图 :打开 聚合视图。
管理列… :显示表中的所有列列表。
粘贴格式设置 :选择如何对从剪贴板粘贴的文本进行格式设置。
重置视图 :恢复初始表布局。
视图查询 :查看生成结果的查询。
将查询复制到控制台 :将查询复制到控制台。
将查询复制到剪贴板 :将查询复制到剪贴板。
打开数据视图设置 :打开 数据编辑器和查看器设置。
打开数据视图外观设置 :打开 数据编辑器和查看器外观设置。
显示系列设置 (图表视图)
打开 系列设置窗格以配置图表显示选项。
效率提示
从实体的表中检索所有记录
可以通过在其实体类中调用专用操作,快速检索数据库表中的所有记录。 这会在 JPA 控制台 中执行 SELECT entity FROM <ClassName> entity 语句。
在编辑器中打开一个实体类。
在装订区域中,选择 。
或者,将文本光标放在类名称处,按 Alt+Enter ,然后选择
在 JPA 控制台中运行查询。
从查询导航到实体类
可以从任何 JPQL、JDQL、HQL 或 EQL 查询快速导航到实体类声明或实体字段声明。 这适用于 JPA 控制台 和编辑器中的查询。
按住 Ctrl 并点击查询中的实体名称或字段名称。
将文本光标放在查询中的实体名称或字段名称处,然后按 Ctrl+B。
将文本光标放在查询中的实体名称或字段名称处。 从主菜单中选择 。