# 查询文件

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

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

此功能依赖于 数据库工具和 SQL 插件，该插件在 CLion 中默认捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

## 概述

查询文件s  是可为数据源在 IDE 中创建并存储于 IDE 项目中的 SQL 与 JS 文件。 在 查询文件s 中，您可以编写、运行并保存您的 SQL 语句。 如果您选择将 查询文件 存储在 [当前项目目录](null)中，它将被包含在项目上下文中。 另外，如果您的任务需要将文件作为通用的 SQL 语句存储，查询文件也可以从任何数据源分离。

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

有关在查询文件中处理查询结果的更多信息，请参阅 [查询结果](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)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (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)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (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)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (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)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (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)), `⌘ ⌃ E` (Xcode), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `F2` (ReSharper), `F2` (ReSharper (macOS)), `Ctrl+Shift+R` (QtCreator), `⌘ ⌃ R` (QtCreator (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)), `⌘ ⌃ E` (Xcode), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `F2` (ReSharper), `F2` (ReSharper (macOS)), `Ctrl+Shift+R` (QtCreator), `⌘ ⌃ R` (QtCreator (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)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (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)), `⌫` (Xcode), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (ReSharper), `⌦` (ReSharper (macOS)), `Delete` (QtCreator), `⌦` (QtCreator (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)), `⌫` (Xcode), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (ReSharper), `⌦` (ReSharper (macOS)), `Delete` (QtCreator), `⌦` (QtCreator (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.  选择您希望与查询文件关联的数据源。

CLion 会自动将 查询文件 与您选择的数据源关联。 关联后，查询文件名称保持不变，并且数据源会在   项目  工具窗口中显示在查询文件名称旁。

## 查询文件参考

有关查询文件上下文菜单和工具栏按钮的信息，请参阅 [代码编辑器技巧与参考](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)

