# 查询文件

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

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  是可在 IDE 中为数据源创建并存储在 IDE 项目中的 SQL 和 JS 文件。 在查询文件s中，可以编写、运行和存储 SQL 语句。 如果选择将其存储在 [当前项目目录](null)中，则 查询文件 会包含在项目上下文中。 此外，如果任务需要将文件用作常规 SQL 语句存储，也可以将查询文件从任何数据源分离。

![查询文件](https://resources.jetbrains.com/help/img/idea/2026.3/query_file_overview.png)

有关在查询文件s中处理查询结果的更多信息，请参阅 [查询结果](viewing-query-results.html)。

可以使用工具栏上的数据源下拉列表 [将 查询文件 与其他数据源关联](null)。

### 位置

可以在 [创建](#create_a_query_file) 查询文件 时指定其位置。 如果 查询文件 存储在 [当前项目目录](null)中或附加到项目的目录中，可以在   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中找到它。

![工具窗口中的查询文件](https://resources.jetbrains.com/help/img/idea/2026.3/query_file_overview_tool_window.png)

要将新的 查询文件 存储在其他位置，请在创建 查询文件 时指定目录。 也可以将现有 查询文件 移动到其他目录。

### 代码编辑器

在  代码编辑器 中，您可以使用 [解析模式](run-a-query.html#resolve_modes)和代码辅助功能编写 SQL 语句，并对关联的数据源执行这些语句。

在 [代码编辑器控件](#reference)中查找代码编辑器工具栏控件。 请阅读有关编辑器的详细信息，请参阅 [编辑器基础](using-code-editor.html)。

### SQL 语句执行

当您执行语句时，   服务   工具窗口会打开。   服务  工具窗口显示可用的连接会话、   输出  和   结果  选项卡。 有关工具窗口的更多信息，请参阅 [“服务”工具窗口](services-tool-window.html) 主题。

* 如果执行的语句检索数据（例如， `SELECT` ），结果将显示在具有合格表名称标题的 结果 选项卡中。 有关为结果选项卡创建自定义标题的更多信息，请参阅 [使用自定义标题显示结果标签](viewing-query-results.html#use-custom-titles-for-tabs-with-results)。

* 如果执行的语句未检索到数据，结果将显示在 输出 选项卡中。 结果选项卡: ![查询控制台与服务工具窗口的活动结果选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/db_ui_query_file_result_tab.png) 1. [代码编辑器工具栏](null)。 2. [](null). 3. 服务 工具窗口。 4. [输出](services-tool-window.html#db_output_tab)和 [结果](services-tool-window.html#db_result_tab)选项卡。 选项卡。 结果 选项卡处于活动状态。 5. [结果选项卡工具栏](services-tool-window.html#db_result_tab_toolbar)。 输出选项卡: ![带有 服務 工具窗口活动输出选项卡的查询控制台](https://resources.jetbrains.com/help/img/idea/2026.3/db_ui_query_file_output_tab.png) 1. [代码编辑器工具栏](null)。 2. [](null). 3. 服务 工具窗口。 4. [输出](services-tool-window.html#db_output_tab)和 [结果](services-tool-window.html#db_result_tab)选项卡。 选项卡。 输出 选项卡处于活动状态。 5. [输出选项卡右侧工具栏](services-tool-window.html#db_output_tab_right_toolbar)。

Procedure: 创建查询文件

要创建 查询文件，请在   数据库   工具窗口中使用以下操作之一。

* 选择一个数据源，然后从主菜单中选择  `文件 | 新建 | 查询文件` 。

* 右键点击数据源并选择  `新建 | 查询文件` 。

* 选择一个数据源，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后选择   查询文件  。

Procedure: 打开查询文件

* 在   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，导航到要打开的 查询文件，然后点击两次。

* 在   数据库   工具窗口中，展开数据源节点，然后展开   查询文件   文件夹，再点击要打开的 查询文件 两次。

![打开查询控制台](https://resources.jetbrains.com/help/img/idea/2026.3/query_file_open.png)

Procedure: 重命名查询文件

要重命名 查询文件，请执行以下操作之一：

* 右键点击 查询文件 选项卡，然后选择   重命名文件  。

* 在   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中：

1.  导航到该文件。 默认情况下，它位于文件树的顶部。

2.  右键点击该文件，然后选择   重命名   ( `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS)))。

* 在   数据库   工具窗口中：

1.  展开数据源节点，然后展开   查询文件   文件夹。

2.

右键点击 查询文件，然后选择   重命名   ( `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS)))。

![重命名查询文件](https://resources.jetbrains.com/help/img/idea/2026.3/query_file_rename.png)

Procedure: 删除查询文件

1. 在   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中：

1.  导航到要删除的 查询文件。

2.  右键点击 查询文件，然后选择   删除  。 或者按 `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))。

2. 在   数据库   工具窗口中：

1.  展开数据源节点，然后展开   查询文件   文件夹。

2.

右键点击 查询文件，然后选择   删除   ( `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/help/img/idea/2026.3/query_file_delete.png)

Procedure: 将数据源附加到查询文件

要将数据源附加到 查询文件，请执行以下操作：

* 在代码编辑器中：

1.

在 查询文件 的工具栏上，点击数据源下拉列表。

2.

导航到   全部   子菜单，然后选择要与 查询文件 关联的数据源。

* 在   数据库   工具窗口中：

1.  导航到 查询文件 并选择它。

2.  右键点击 查询文件，然后选择   附加数据源  。

3.  选择要与 查询文件 关联的数据源。

IntelliJ IDEA 会自动将 查询文件 与所选数据源关联。 关联后，查询文件 名称保持不变，数据源会显示在   项目   工具窗口中 查询文件 名称旁边。

## 查询文件参考

在 [代码编辑器提示和参考资料。](code-editor-tips-and-ref-db-tools-and-sql.html) 主题中查找有关 查询文件 上下文菜单和工具栏按钮的信息。

在 [编辑器基础](using-code-editor.html) 中展开代码编辑器的更多内容。

## See also

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

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

### 过程

[运行查询](run-a-query.html) [查询结果](viewing-query-results.html)

### 参考

[Query execution page](query-execution.html) [代码编辑器提示和参考资料。](code-editor-tips-and-ref-db-tools-and-sql.html)