# 运行查询

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

> **TL;DR**
> 要运行 SQL 代码，请按 `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))
>
>
>
> 要取消正在运行的语句，请按 `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))

Procedure: 启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件，该插件默认情况下在 IntelliJ IDEA 中绑定并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 没有 Ultimate 订阅时，数据库工具和 SQL 的功能支持在 IntelliJ IDEA 中受限。

1. 按 `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)) 打开设置，然后选择  `插件` 。

2. 找到  数据库工具和 SQL  插件并点击   启用  。

可以使用快捷键、工具栏按钮、上下文菜单以及运行/调试配置来运行查询。 您可以在 [查询控制台s](query-consoles.html)、 [临时文件](scratches.html)和 [用户文件](working-with-user-files.html)中执行此操作。

[Video](https://www.youtube.com/v/-MFoSwcPkb4)

> **Tip:**
> 查询控制台  与用户文件和临时文件等其他 SQL 文件并无不同。 唯一的区别是 查询控制台 已连接到数据源，因此可以立即输入并运行代码。 可以像使用终端一样使用 查询控制台。 输入、按 `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))，然后运行您的代码。

有关在哪里以及如何查看查询结果的更多信息，请参阅 [查询结果](viewing-query-results.html)。

## 运行语句和过程

Procedure: 在查询控制台中运行语句

1. 在   数据库   工具窗口中，点击数据源。

2. 按 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) 打开一个 查询控制台。 有关使用 查询控制台s 的更多信息，请参阅 [查询控制台](query-consoles.html)。

3. 请输入您想要执行的语句。

4. 请点击 ![“执行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.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/db_run_query.png)

> **Tip:**
> IntelliJ IDEA 可以在查询运行超过 20 秒后完成时通知您。 要 [启用此通知](notifications.html#configure_notifications_per_event_group)，请按 `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)) 打开设置并选择   外观与行为 | 通知  。 在事件组列表中，选择   耗时较长的数据库查询   并启用通知类型。

Procedure: 从打开的文件运行语句

在 IntelliJ IDEA 中，您可以打开并运行文件。 文件大小限制为 20 MB。 当您打开一个大于 20 MB 的文件时，您只能看到文件的前 2.5 MB。 该文件应与 SQL 文件类型相关联。 有关文件类型关联的更多信息，请参阅 [文件类型关联](creating-and-registering-file-types.html#configure-associations-between-filename-patterns-and-file-types)主题。

1. 打开   项目  工具窗口（  `视图 | 工具窗口 |   项目` ），然后双击一个 SQL 文件。

有关在 IntelliJ IDEA 中附加目录和文件的更多信息，请参阅 [用户文件](working-with-user-files.html)。

2. 点击您要执行的语句。

此外，您可以选择（高亮显示）要执行的代码片段。 该片段可以是子查询或一组语句。 IntelliJ IDEA 仅执行所选内容。

3. 点击工具栏上的   执行   按钮 ( ![“执行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.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))。

若要自定义查询执行设置，请点击   自定义  链接。 或者，按下 `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)) 打开设置，然后导航至  `工具 | 数据库 | 查询执行` 。 。

4. （可选）如果 SQL 文件未连接到数据源，请在   <数据源>   列表中选择您想连接的数据源。

有关将 SQL 文件附加到数据源的更多信息，请参阅 [数据源附件](run-sql-files.html#data_source_attachment)。

5. 在   语句  窗口中，按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))以运行选定的语句。 您可以切换到其他条目以运行另一组语句。 您将要执行的语句会在查询编辑器中高亮显示。

> **Tip:**
> 在   语句   窗口中，您可以点击   自定义   来定义您是否希望看到选择器或始终运行文本光标下的语句。

如需运行脚本文件的另一个示例，请参阅 [youtube.com 上的以下视频](https://www.youtube.com/watch?v=U5SOD-eeK50&t=1913s)。

[Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/run-individual-statements.mp4)

Procedure: 运行存储过程

存储过程是一组具有指定名称的 SQL 语句。 您可以在 PostgreSQL、Microsoft SQL 服务器、甲骨文 和 MySQL 中执行存储过程。

1. 右键点击要执行的存储函数，然后选择   运行功能  。

2. 在   执行例程  窗口中，输入所有必要的参数值，然后点击   OK  。

如有必要，请选中   从以下位置运行  复选框并选择文件或控制台以运行存储的函数。

![运行存储过程](https://resources.jetbrains.com.cn/help/img/idea/2026.3/run_stored_functions.png)

Procedure: 运行 SELECT 语句并将结果保存到文件中

1. （可选）如果文件没有连接到数据源，请从工具栏上的数据源列表中选择一个数据源。 然后从   会话  列表中选择连接会话。

如需了解有关连接会话的更多信息，请参阅 [会话](managing-connection-sessions.html)。

2. 右键点击  `SELECT` 语句。

3. 请选择   执行到文件   并选择输出格式。

4. 在   导出数据  对话框中，指定您要使用的 extractor 和其他设置。

有关   导出数据   对话框的更多信息，请参阅 [导出数据](export-data.html#export-data-from-the-database-tool-window) 主题。

![将 SELECT 语句的结果保存到文件中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_execute_to_file.png)

Procedure: 从结构工具窗口运行语句

* 在 [结构

工具窗口](viewing-structure-of-a-source-file.html#structure-tool-window) `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS))中，选择一个或多个语句，右键点击它们，然后选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   执行  。

Procedure: 运行跨数据库查询

在 IntelliJ IDEA 中，可以跨不同数据库查询数据并直接查看结果，而无需事先复制数据。

1. 在   数据库   工具窗口工具栏上，点击 !["添加"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.add.svg)   添加  ，然后选择 ![工作区数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.homeFolder.png)   工作区数据源  。

IntelliJ IDEA 创建   工作区   数据源并自动打开其默认的 查询控制台。

2. 在 查询控制台 中，编写  `SELECT ... FROM`  查询。 使用 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) 代码补全来选择数据源和数据库对象。

例如，联接来自   PostgreSQL   和   MySQL   数据源的数据：

```SQL
SELECT c.first_name, c.last_name, p.amount
FROM #PostgreSQL.guest.public.customer c
         JOIN #MySQL.sakila.payment p
              ON c.customer_id = p.customer_id;

```

有关特殊语法的更多信息，请参阅 [语法](cross-database-queries.html#syntax)。

3. 请点击 ![“执行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.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))。

有关中间节点和语法的更多信息，请参阅 [跨数据库查询](cross-database-queries.html) 主题。

![联接来自 PostgreSQL 和 MySQL 数据源的数据的跨数据库查询示例](https://resources.jetbrains.com.cn/help/img/idea/2026.3/cross_database_query_join.png)

Procedure: 视图查询执行设置。？

* 打开 查询控制台，然后点击其工具栏上的 ![“打开数据库设置”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.settings.svg)   打开查询执行设置  。

* 通过按下 `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/modify_console_settings.png)

## 取消运行语句

Procedure:

* 要取消正在执行的语句，请点击工具栏上的 ![“取消正在运行的语句”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.stop.svg)   取消正在运行的语句  。

或者，将鼠标悬停在装订区域的进度指示器上，然后点击替换进度图标的 ![“取消正在运行的语句”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.stop.svg)   取消正在运行的语句  。

[Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_cancel_running_statements.mp4)

> **Note:**
> 如果您点击   停用  按钮（ ![停用图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.killDataSourceProcess.svg)）位于   数据库  工具窗口的工具栏上，它将停止 IntelliJ IDEA 中的查询，但查询将在数据库中继续执行。

如果您点击 ![“取消正在运行的语句”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.stop.svg)   取消正在运行的语句  按钮两次，IntelliJ IDEA会显示一个警告，您可以终止远程进程或稍等片刻。 显示此警告是为了确保安全，因为停用可能会对某些同时发生的进程造成潜在危险。

此外，IDE 会在空闲取消 10 秒后显示警告。

[Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_cancel_running_statements_warning.mp4)

## 取消连接

您不仅可以中断请求的执行，还可以中断连接的创建。 这对于 查询控制台 中的第一个查询尤为重要，因为该查询也会创建连接。

您可以停止创建连接的过程。 要做到这一点，请在创建连接时点击工具栏上的   取消正在运行的语句  按钮（ ![“取消正在运行的语句”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.stop.svg)）。 连接将会停止，并且您将看到   连接已取消   消息。

## 解决模式

为了运行 SQL 脚本，将数据库对象的用法视为链接，并为您提供正确的代码补全，IntelliJ IDEA 必须将代码中的数据库对象解析到某个特定的上下文。 默认情况下，IDE 使用以下之一作为解析数据库对象的起点： [&lt;schema&gt;](null) 选择器，或默认数据库（如果未设置上述任何一项）。

根据您的代码是单个脚本还是包含多个不相关的 SQL 语句，请选择以下一种解析模式，以正确解析数据库对象：

* 试验场 ：查询控制台s的默认模式。 所有数据库对象都解析到相同的上下文。 如果您的代码是一组不打算作为单个脚本运行的独立 SQL 语句，请使用此模式。

* 脚本 ：本地 SQL 文件的默认模式。 `USE` SQL 语句（对于 PostgreSQL 为 `SET search_path TO` ）会覆盖数据库对象解析到的默认上下文。 如果您的代码旨在作为单个脚本运行，请使用此模式。 > **Note:** > 默认情况下，本地 SQL 文件不可用 <schema> 选择器。 要使 <schema> 选择器出现，请将会话附加到您的 SQL 文件。 为此，请点击 <session> 按钮 ( `<session>` ) 并选择会话。 或者，右键点击 项目 工具窗口中的文件，然后选择 切换会话 。

在下面的视频中，  `public`  架构被选为 查询控制台 的默认架构。 该架构包含  `actor`  表，而  `information_schema`  架构不包含该表。 当解析模式为   试验场  时，数据库对象在  `SELECT` 语句中解析为默认架构，因为所有语句都被视为无关。

一旦将解析模式更改为   脚本  ，第二个  `SELECT`  语句就会被视为与  `SET search_path TO information_schema`  语句相关。 该  `actor` 表在该语句中不再解析。

[Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/resolve_modes_example.mp4)

## 用户参数

根据数据库供应商，问号  `?` 在 SQL 语句中被视为参数。 您可以在   工具 | 数据库 | 查询执行 | 用户参数  设置页面 `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))中指定哪些其他字符及其序列应被视为形参，以及在什么位置。

SQL 参数的模式通过使用正则表达式指定。

Procedure: 运行参数化语句

如果您的语句中有参数，IntelliJ IDEA 会在您执行语句之前提示您指定参数的值。

* 要执行参数化语句，请点击工具栏上的   执行   按钮 ( ![“执行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.run.run.svg))，并在第二列中输入值。 或者，若要打开   参数  对话框，请点击   查看参数  按钮( ![查看参数按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.viewParameters.svg))。

![执行参数化语句](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_execute_parametrized_statement.png)

### 命名行为

在 IntelliJ IDEA 中，您可以使用  位置  和  命名  用户参数。 对于位置用户形参，每次出现都会根据其顺序单独处理。 对于有名称的用户形参，所有名称相同的出现项都会被视为同一个形参。

要使用命名参数，请按 `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)) 打开设置，并导航到  `工具 | 数据库 | 查询执行 | 用户参数` 。 在   形参模式   窗格中，将  `()`  添加到您的用户参数模式。 IDE 会将  `()`  的内容视为参数名称，并且在您运行脚本时只请求一个值。 否则，如果在脚本中多次使用同一个形参，IDE 会根据形参的顺序请求多个值。

请看以下示例：

```SQL
SELECT * FROM my_table WHERE a = ?x OR b = ?x;
```

* `\?\w+` ：位置用户参数模式。 `?x` 参数被视为两个不同的用户参数。 系统会按形参的顺序请求值。 ![使用常规用户形参运行语句](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_general_user_parameter.png)

* `\?(\w+)` ：命名用户参数模式。 两个 `?x` 被视为同一个用户参数，其中 `x` 是参数名称。 ![使用有名称的用户形参运行语句](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_named_user_parameter.png)

有关参数模式的更多信息，请参阅 [用户参数参考主题](settings-tools-database-user-parameters.html#param_patterns)。

### 示例

#### 将数组作为参数

在 IntelliJ IDEA 中，用值替换参数是直截了当的。 要使用数组作为值，请在相应字段中指定您的数组。

在下面的示例中，参数  `?`  可以替换为值  `206, 'John', 'Smith'` ：

```SQL
INSERT INTO actor (actor_id, first_name, last_name, last_update)
VALUES (?, '01.02.2023 13:34');

```

![将值数组用作参数](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_array_as_a_parameter.png)

有关参数的更多信息，请参阅数据库文档。

#### 参数模式

如果您的脚本中有特定参数语法的参数，请使用正则表达式指定模式。

对于以下示例，必须在   工具 | 数据库 | 查询执行 | 用户参数  设置页面 `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))中设置  `%{2}(\w+_\d+)` 模式：

```SQL
SELECT title, description, release_year FROM actor
JOIN film_actor fa ON actor.actor_id = fa.actor_id
JOIN film f ON f.film_id = fa.film_id
WHERE last_name = '%%winnerpl_2';

```

![在 IDE 设置对话框中的参数模式示例](https://resources.jetbrains.com.cn/help/img/idea/2026.3/user_parameters_pattern_example.png)

## 预览表结构

在 IDE 代码编辑器中，您可以使用   快速文档  功能预览 SQL 语句中表的结构。

Procedure:

* 要预览 SQL 语句中的表结构，请选择表并按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))。

快速文档   弹出窗口中包含  `CREATE`  DDL 脚本及其他有关该表的信息。

有关此功能的更多信息，请参阅 [快速文档](viewing-reference-information.html#inline-quick-documentation)。

![在编辑器选项卡中预览表结构](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_preview_table_structure_in_editor.png)

## 查看已执行语句历史

Procedure: 使用"查询历史"对话框

IntelliJ IDEA 会存储在 查询控制台 中运行的所有语句的历史记录。

* 要打开   查询历史  对话框，请点击工具栏上的   浏览查询历史  按钮（ ![浏览查询历史按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.vcs.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))。

在   查询历史   对话框中，您可以执行以下操作：

* 要筛选信息，请开始输入您的搜索查询。

* 要将 查询历史 对话框中的查询粘贴到 查询控制台 中，请在 查询历史 对话框的左侧窗格中双击该查询。

* 要从历史记录中删除记录，请选择该记录并按下 `Delete` (Windows), `⌦` (macOS), `⌦` (IntelliJ IDEA Classic (macOS)), `⌦` (macOS System Shortcuts), `Delete` (XWin), `Delete` (GNOME), `Delete` (KDE), `Delete` (Emacs), `Delete` (Sublime Text), `⌦` (Sublime Text (macOS)), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (NetBeans), `Delete` (Eclipse), `⌦` (Eclipse (macOS))。

![查看已执行查询的历史记录](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_show_history.png)

## 查看结果

通常，运行查询时，会以表格格式收到结果。 IntelliJ IDEA 会在  data editor 中显示结果。 默认情况下，对于每个语句，带有结果的数据编辑器会在   服务  工具窗口中的单独选项卡中显示。

有关查看查询结果的更多信息，请参阅 [查询结果](viewing-query-results.html)。

![服务工具窗口选项卡中的 SELECT 语句结果](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_open_new_tab_for_each_new_query.png)

## See also

### 语言和框架特定指南

[数据库工具和 SQL](relational-databases.html)

### 过程

[注入的 SQL 语句](running-injected-sql-statements.html)

## See also

### 相关

[查询控制台](query-consoles.html) [用户文件](working-with-user-files.html)

### 参考

[查询控制台](query-consoles.html#reference) [Data editor and viewer](data-editor-and-viewer.html#reference) [查询结果](viewing-query-results.html)

