llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

JPA 控制台

JPA 控制台 可让您使用以下语言编写、验证和运行查询:

前提

打开控制台

如果想运行代码中不存在的 JPQL、JDQL、HQL 或 EQL 查询,或者希望控制台使用自定义 JVM 选项,请手动打开 JPA 控制台。

使用默认设置打开控制台

  1. 打开 Persistence 工具窗口(视图 | 工具窗口 | Persistence)。

  2. 选择持久性单元。

  3. 在工具窗口工具栏中,点击 控制台图标JPA 控制台。

    Persistence 工具窗口中 JPA 控制台图标的位置
    • 或者按 Ctrl+Shift+F10。

JPA 控制台 将在专用工具窗口中打开。 现在可以 运行查询。

JPA 控制台工具窗口

要了解控制台中图标的含义,请参阅 参考:JPA 控制台。

使用自定义 JVM 选项打开控制台

JPA 控制台 在单独的 Java 进程中运行。 可以通过创建 运行配置 ,然后在打开控制台时选择该配置,使用自定义 JVM 选项运行此进程。

  1. 打开 运行/调试配置 对话框:

    • 在主工具栏,点击 运行微件并选择 编辑配置…。

    • 或者,转到 运行 | 编辑配置…。

  2. 在对话框左侧,选择 新增配置图标 新增配置 | 应用程序图标 应用程序。

  3. 在对话框右侧,选择 修改选项 | 添加虚拟机选项。

  4. 在 VM 选项 字段中,指定打开 JPA 控制台 时要传递给 JVM 的选项。

    在运行/调试配置对话框的虚拟机选项字段中填入 -Xmx512m

    也可以设置其他 运行配置设置 ,但控制台不需要这些设置。

  5. 点击 应用 ,然后 OK。

  6. 打开 持久化 工具窗口 (视图 | 工具窗口 | Persistence)。

  7. 选择持久性单元。

  8. 在工具窗口的工具栏中,选择 JPA 控制台图标 JPA 控制台 | 应用程序图标 <您的配置名称>;。

    运行配置工具栏
  9. JPA 控制台 将在应用了 JVM 选项的专用工具窗口中打开。 现在可以 运行查询。

要了解控制台中图标的含义,请参阅 参考:JPA 控制台。

运行查询

可以从控制台本身或从编辑器在 JPA 控制台 中运行查询。

JPA 控制台 会针对 数据库工具窗口中的数据源运行查询。 如果有多个数据源,IDE 会按以下配置(按此顺序)查找匹配项:正在运行的 Spring 调试器 会话、 持久化 工具窗口中的显式赋值,或 Spring Boot 配置文件中的数据源 URL。 如果 IntelliJ IDEA 无法确定要使用哪个数据源,系统会提示选择一个。

从 JPA 控制台运行查询

  1. 打开 JPA 控制台。

  2. 键入或粘贴查询。

  3. 在控制台工具栏中,点击 指向右侧的绿色三角形执行查询。

    • 或者按 Ctrl+Enter。

  4. 如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。

JPA 控制台 将执行查询,并在新选项卡中 显示其结果。

从编辑器运行查询

  1. 将文本光标放在编辑器中的查询处。

  2. 右键点击查询并选择 灰色灯泡图标 显示上下文操作 | 控制台图标 在控制台中运行查询。

    • 或者,按 Alt+Enter 并选择 控制台图标在控制台中运行查询。

  3. 如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。

JPA 控制台 会执行查询并 显示其结果。

从装订区域运行 Jakarta Data 查询方法

如果项目使用 Jakarta Data 仓库,可以直接从编辑器装订区域运行其查询方法。

  1. 在编辑器中打开 Jakarta Data 仓库。

  2. 在装订区域中,点击查询方法旁边的 控制台图标在控制台中运行查询。

  3. 如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。

JPA 控制台 会执行查询并 显示其结果。

使用装订区域图标在 JPA 控制台中运行 Jakarta Data 仓库方法并填写形参值

从装订区域运行 Spring Data 查询方法

如果项目使用 Spring Data 仓库 ,可以直接从编辑器装订区域运行其查询方法。

  1. 在编辑器中打开 Spring Data 仓库。

  2. 在装订区域中,点击查询方法旁边的 控制台图标在控制台中运行查询。

  3. 如果查询接受形参, 参数 对话框将打开。 指定值,然后点击 执行。

如果查询以 JPQL 编写或从方法名称派生, JPA 控制台 将执行查询并 显示其结果。

使用装订区域图标在 JPA 控制台中运行 Spring Data 仓库方法并填写形参值

如果查询以原生 SQL 编写,则由特定于数据库的 查询控制台执行该查询,并由 服务 工具窗口 显示其结果。

参考:JPA 控制台

JPA 控制台,其中 JPQL 查询检索具有指定国籍的书籍作者

JPA 控制台 由以下组件组成:

  1. 会话选项卡:保存单个控制台 会话并包含其他组件。 该选项卡按持久性单元的名称命名。

  2. 查询工具栏:用于执行查询、配置查询执行设置以及管理控制台会话。

  3. 控制台图标 控制台选项卡:显示控制台日志,并允许键入查询。 该选项卡按持久性单元的名称命名。

  4. 数据库表图标 结果选项卡:显示单个已执行查询的结果,并允许自定义结果的显示方式。 每次执行查询都会打开一个新选项卡。

查询工具栏

执行查询 (Ctrl+Enter)

运行当前键入的查询。

设置

打开查询执行设置…

打开 查询执行 页面(位于 设置 对话框中)。

参数

查看参数

打开 参数 窗格,查看查询接受的形参并设置其值。

历史记录

浏览查询历史 (Ctrl+Alt+E)

打开 历史记录 对话框,查看已为此持久性单元运行的所有查询,并可选择将选定的查询复制到控制台。

恢复布局

恢复默认布局

恢复原始控制台布局。

终止进程

终止进程 (Ctrl+F2)

断开控制台与数据库的连接,但保持会话选项卡打开。

关闭

关闭 (Ctrl+Shift+F4)

断开控制台与数据库的连接,并关闭当前打开的会话选项卡。

Console(控制台)选项卡页

已包装文本图标

自动换行

在控制台日志中对长行自动换行。

向下滚动文本图标

滚动到末尾

跳转到控制台日志底部。

打印机图标

打印…

打开 打印对话框。

垃圾桶图标

全部清除

清除控制台日志。

结果选项卡

表图标

切换到表

以数据库表的形式查看结果。

有关更多信息,请参阅 探索值。

图表图标

切换到图表

以图表形式查看结果。

有关更多信息,请参阅 可视化数据。

刷新图标

重新加载页面 (Ctrl+F5)

重新加载数据。

时钟图标

表结果自动刷新

选择数据自动刷新的频率。

固定图标

固定选项卡

固定当前打开的结果选项卡。

放大镜图标

在当前页查找

在当前显示的页面上搜索特定值的数据。

筛选器图标

表结果本地筛选器

为所有列启用筛选或清除所有筛选器。

有关更多信息,请参阅 使用本地过滤器。

单条记录图标

记录视图

打开侧边窗格以查看所选记录中的数据。

有关更多信息,请参阅 单记录视图。

单条记录图标

表着色选项

配置表单元格的颜色映射。

有关更多信息,请参阅 应用热力图。

Web 图标

显示地理位置查看器

打开交互式地图,以查看结果中的地理坐标。

有关更多信息,请参阅 查看地理数据。

数据提取工具

数据提取器

选择数据的输出格式。

有关更多信息,请参阅 数据提取工具。

下载图标

导出数据 (表视图)

打开 导出数据对话框。

导出为 PNG (图表视图)

将图表下载为 PNG 图像。

上传图标

导入

打开 导入对话框。

差异图标

比较数据

将此结果与 查询控制台中的结果进行比较。

眼睛图标

视图方式

选择数据视图模式。

有关更多信息,请参阅 数据视图模式。

齿轮图标

显示选项菜单 (表视图)

打开包含以下选项的列表:

  • 显示值编辑器 :打开 值编辑器 ,查看所选单元格中的数据。

  • 显示汇总视图 :打开 聚合视图。

  • 管理列… :显示表中的所有列列表。

  • 粘贴格式设置 :选择如何对从剪贴板粘贴的文本进行格式设置。

  • 重置视图 :恢复初始表布局。

  • 视图查询 :查看生成结果的查询。

  • 将查询复制到控制台 :将查询复制到控制台。

  • 将查询复制到剪贴板 :将查询复制到剪贴板。

  • 打开数据视图设置 :打开 数据编辑器和查看器设置。

  • 打开数据视图外观设置 :打开 数据编辑器和查看器外观设置。

显示系列设置 (图表视图)

打开 系列设置窗格以配置图表显示选项。

效率提示

从实体的表中检索所有记录

可以通过在其实体类中调用专用操作,快速检索数据库表中的所有记录。 这会在 JPA 控制台 中执行 SELECT entity FROM <ClassName> entity 语句。

  1. 在编辑器中打开一个实体类。

  2. 在装订区域中,选择 右下角带有蓝色表格图标的数据库图标 显示实体操作 | 控制台图标 在 JPA 控制台中运行查询。

    • 或者,将文本光标放在类名称处,按 Alt+Enter ,然后选择 控制台图标在 JPA 控制台中运行查询。

可以从任何 JPQL、JDQL、HQL 或 EQL 查询快速导航到实体类声明或实体字段声明。 这适用于 JPA 控制台 和编辑器中的查询。

  • 按住 Ctrl 并点击查询中的实体名称或字段名称。

  • 将文本光标放在查询中的实体名称或字段名称处,然后按 Ctrl+B。

  • 将文本光标放在查询中的实体名称或字段名称处。 从主菜单中选择 导航 | 声明或用法。

2026年 11月 3日