# Hibernate 控制台

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件： [Jakarta EE: Persistence (JPA)](https://plugins.jetbrains.com/plugin/20202) 和 [Hibernate](https://plugins.jetbrains.com/plugin/20214)（均已捆绑）

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

> **Note:**
> 您的项目应使用 JDK 8 或更高版本才能使用 Hibernate 控制台。

> **Note:**
> 如果您的项目具有   Hibernate   Facet，将有一个专用工具窗口   Hibernate Console  可用。 否则， [JPA Console](using-jpa-console.html) 用于 JPQL 和 HQL 查询。

> **Tip:**
> 将您的会话工厂与相应的 [data sources](managing-data-sources.html#data_sources)关联。 否则，您将在使用 JPA 控制台时需要手动指定数据库连接设置。 更多信息请参阅 [将持久性单元与数据源关联](persistence-tool-window.html#assign_data_source)。
>
>
>
> 如果您使用的自定义实体类或数据库表名称映射 PostgreSQL 没有完全反映在您的代码和配置文件中，请指定相应的  `命名策略` 实现，参见 [将持久化单元与命名策略关联](persistence-tool-window.html#assign_naming_strategy)。

Procedure: 打开 Hibernate 控制台

* 在 [Persistence](persistence-tool-window.html)工具窗口中，右键点击会话工厂或实体并选择   JPA 控制台  。 或者，您也可以点击工具栏中的 ![控制台按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.consoleRun.svg) 或者按下 `Ctrl+Shift+F10` (Windows), `⌘ ⇧ F10` (macOS), `⌘ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F10` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `⌘ ⇧ F10` (Sublime Text (macOS)), `Ctrl+Shift+F10` (Visual Studio), `⌘ ⇧ F10` (Visual Studio (macOS)), `Ctrl+Shift+F10` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌘ ⇧ F10` (Eclipse (macOS))。

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

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

|  ![执行查询](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.run.svg)  |  `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS))  |  运行当前查询。  |
|  ![打开数据库设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)  |  |  打开 [数据库页面](settings-tools-database.html)的   设置  对话框 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))。  |
|  ![查看参数](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.parameter.svg)  |  |  打开   参数  窗格以查看查询中使用的参数并设置它们的值。  |
|  ![浏览查询历史](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.history.svg)  |  `Ctrl+Alt+E` (Windows), `⌘ ⌥ E` (macOS), `⌘ ⌥ E` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ E` (macOS System Shortcuts), `Ctrl+Alt+E` (XWin), `Ctrl+Alt+E` (GNOME), `Ctrl+Alt+E` (KDE), `Ctrl+Alt+E` (Emacs), `Ctrl+Alt+E` (Sublime Text), `⌘ ⌥ E` (Sublime Text (macOS)), `Ctrl+Alt+E` (Visual Studio), `⌘ ⌥ E` (Visual Studio (macOS)), `Ctrl+Alt+E` (NetBeans), `Ctrl+Alt+E` (Eclipse), `⌘ ⌥ E` (Eclipse (macOS))  |  打开控制台历史对话框，显示您在此控制台中运行过的所有查询。  |
|  ![恢复默认布局](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.layout.svg)  |  |  在布局更改后恢复原始工具窗口布局。  |
|  ![选择属性源](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.preview.svg)  |  |  选择属性来源（如果  `persistence.xml`  外部配置了持久单元，则可用）。  |
|  ![终止进程](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.run.stop.svg)  |  `Ctrl+F2` (Windows), `⌘ F2` (macOS), `⌘ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ .` (macOS System Shortcuts), `Ctrl+F2` (XWin), `Ctrl+F2` (GNOME), `Ctrl+2` (KDE), `Ctrl+F2` (Emacs), `Ctrl+F2` (Sublime Text), `Ctrl+F2` (Sublime Text (macOS)), `Shift+F5` (Visual Studio), `⇧ F5` (Visual Studio (macOS)), `Shift+F5` (NetBeans), `Ctrl+F2` (Eclipse), `⌘ F2` (Eclipse (macOS))  |  终止当前控制台会话。  |
|  ![关闭](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.close.svg)  |  `Ctrl+Shift+F4` (Windows), `⌃ ⇧ F4` (macOS), `⌘ ⇧ F4` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ F4` (macOS System Shortcuts), `Ctrl+Shift+F4` (XWin), `Ctrl+Shift+F4` (GNOME), `Ctrl+Shift+4` (KDE), `Ctrl+Shift+F4` (Emacs), `Ctrl+Shift+F4` (Sublime Text), `⌃ ⇧ F4` (Sublime Text (macOS)), `Ctrl+Shift+F4` (Visual Studio), `⌃ ⇧ F4` (Visual Studio (macOS)), `Ctrl+Shift+F4` (NetBeans), `Ctrl+W` (Eclipse), `⌘ W` (Eclipse (macOS))  |  关闭当前控制台。  |

Procedure: 运行 HQL 查询

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

* 按下 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS))。

* 请在工具栏中点击 ![执行查询按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.run.svg)。

当您执行带有参数的查询时，您将需要输入它们的值。 或者，点击 ![“视图形参”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.parameter.svg)以打开   参数  窗格。

IntelliJ IDEA 存储您执行的所有查询。 按 `Up` (Windows), `↑` (macOS), `↑` (IntelliJ IDEA Classic (macOS)), `↑` (macOS System Shortcuts), `Up` (XWin), `Up` (GNOME), `Up` (KDE), `Up` (Emacs), `Up` (Sublime Text), `↑` (Sublime Text (macOS)), `Up` (Visual Studio), `↑` (Visual Studio (macOS)), `Up` (NetBeans), `Up` (Eclipse), `↑` (Eclipse (macOS)) 查看之前执行的命令，从最近的一个开始。 要查看完整历史记录，请点击 !["浏览查询历史"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.history.svg)。

Procedure: 导航到类或字段的声明处

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

* 按住 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS))并点击相关的对象或属性。

* 将文本光标放置在相关对象或属性的名称处，然后按 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) 或从主菜单中选择  `导航 | 转到声明` 。

## 使用自定义 JVM 选项运行 Hibernate 控制台

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

Procedure:

1. 创建一个   应用程序   运行配置

请转到  `运行 | 编辑配置` ，点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)，并选择   应用程序  。

2. 在   VM 选项  字段中，指定您希望传递给 JVM 的启动选项。 其他的运行配置设置无关紧要，您不需要指定它们。

点击   OK   以保存运行配置。

3. 当您 [打开 Hibernate 控制台](#open-hibernate-console)时，IntelliJ IDEA 将显示一个附加的   虚拟机和环境配置  弹出窗口，其中包含可用的运行配置。 请选择具有必要 JVM 选项的那个，或使用默认设置运行。

