# 查询控制台

> 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 项目外部的 SQL 和 JS 文件。 您可以在 查询控制台s 中编写并执行 SQL 语句，方式与在终端中相同。 查询控制台s 不包含在项目上下文中。

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

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

创建数据源时，会自动创建一个 查询控制台，并默认与该数据源关联。 如有需要，您可以为该数据源创建其他 查询控制台s。

### 数据库连接会话

对于每个 查询控制台，将自动创建一个数据库 [连接会话](managing-connection-sessions.html)。 您可以在 [控制台工具栏](code-editor-tips-and-ref-db-tools-and-sql.html#toolbar_controls)中创建新的连接会话并将您的 查询控制台 附加到现有会话。

### 位置

所有创建的 查询控制台 都位于内部  `数据库控制台`  目录中。 要打开此目录，请打开   项目  工具窗口（ `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))），并导航到  `Scratches and Consoles | Database Consoles` 。

在您的计算机上，查询控制台 存储在  `控制台`  子目录下的 [IDE 配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory) 中。

### 代码编辑器

在  代码编辑器 中，您可以使用 [解析模式](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_console_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_console_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))，然后选择   查询控制台  。

* 选择一个数据源，按 `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)), `⌘ ⇧ F10` (Xcode), `Ctrl+Shift+F10` (Visual Studio), `⌘ ⇧ F10` (Visual Studio (macOS)), `Ctrl+Shift+F10` (ReSharper), `⌘ ⇧ F10` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌘ ⇧ F10` (QtCreator (macOS)), `Ctrl+Shift+F10` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌘ ⇧ F10` (Eclipse (macOS))，然后选择   新 查询控制台  。

* 选择一个数据源并按 `Ctrl+Shift+Q` (Windows), `⌘ ⇧ L` (macOS), `⌘ ⇧ Q` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ L` (macOS System Shortcuts), `Ctrl+Shift+Q` (XWin), `Ctrl+Shift+Q` (GNOME), `Ctrl+Shift+Q` (KDE), `Ctrl+Shift+Q` (Emacs), `Ctrl+Shift+L` (Sublime Text), `⌘ ⇧ L` (Sublime Text (macOS)), `⌘ ⇧ L` (Xcode), `Ctrl+Shift+Q` (Visual Studio), `⌘ ⇧ L` (Visual Studio (macOS)), `Ctrl+Shift+Q` (ReSharper), `⌘ ⇧ L` (ReSharper (macOS)), `Ctrl+Shift+Q` (QtCreator), `⌘ ⇧ L` (QtCreator (macOS)), `Ctrl+Shift+Q` (NetBeans), `Ctrl+Shift+Q` (Eclipse), `⌘ ⇧ L` (Eclipse (macOS))。

> **Note:**
> 查询控制台s 可以共享单个会话，也可以使用单独的会话。 有关会话控制的更多信息，请参阅 [管理会话](managing-connection-sessions.html#manage_sessions)。

Procedure: 打开查询控制台

* 在   项目  工具窗口中，导航到  `Scratches and Consoles | Database Consoles` 目录。 展开包含您 查询控制台 的数据源组，然后双击需要打开的 查询控制台。

* 在   数据库   工具窗口中，点击 ![跳转到查询控制台图标](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.sqlScript.svg)   跳转到 查询控制台  ，转到   全部   子菜单，然后双击您想要打开的 查询控制台。

* 要打开数据源的默认 查询控制台，请点击数据源并按下 `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)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。

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

Procedure: 复制查询控制台

可以通过以下方式复制查询控制台：

* 右键点击查询控制台的编辑器选项卡页眉，然后选择   重复  。

* 右键点击编辑器区域的任意位置，然后选择   重复  。

![复制查询控制台](https://resources.jetbrains.com/help/img/idea/2026.3/db_query_console_duplicate_header.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.  导航至  `Scratches and Consoles | Database Consoles`  内部目录。

2.  展开包含您的 查询控制台 的数据源组。

3.

右键点击 查询控制台，然后选择   重命名  （ `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/rename_query_console_file.png)

Procedure: 更改默认名称

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.

3. 在   默认文件名称  中，为查询控制台s指定新名称。

4. 应用更改并关闭对话框。

![自定义查询控制台名称在编辑器标签页标题中的显示方式](https://resources.jetbrains.com/help/img/idea/2026.3/db_settings_query_console_default_name.png)

Procedure: 自定义编辑器选项卡页眉的名称。

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. 在   模板   字段中，输入您的模板。

如需为名称添加更多细节，请使用变量。 将文本光标放在需要插入细节的位置，然后点击对应的变量按钮。

3. 应用更改并关闭对话框。

若也要将此模板应用于查询文件，请选择   将此模板用于查询文件  。

![自定义查询控制台名称在编辑器标签页标题中的显示方式](https://resources.jetbrains.com/help/img/idea/2026.3/db_settings_query_console_tab_name_custom.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))），并导航到  `Scratches and Consoles | Database Consoles` 内部目录。

2. 右键点击您要在其中创建新目录的数据源组，然后选择  `新建 | 目录` 。

3. 指定目录名称。

4. 选择并拖动 查询控制台s 到目录中。

5. 在   移动  对话框中，点击   重构  。

![将控制台分组到数据源目录下](https://resources.jetbrains.com/help/img/idea/2026.3/group_consoles_under_the_data_source_directory.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.  导航至  `Scratches and Consoles | Database Consoles`  内部目录。

2.  展开包含您的 查询控制台 的数据源组。

3.  右键点击 查询控制台，然后选择   删除  。 或者按 `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_console_delete.png)

Procedure: 将查询控制台复制到新位置

1. 在   项目  工具窗口中，导航到  `Scratches and Consoles | Database Consoles` 目录。

2. 展开包含您的 查询控制台 的数据源组。

3. 右键点击 查询控制台 并选择  `重构 | 复制文件…` 。

4. 在   目标目录   字段中，为 查询控制台 指定新的位置。

![将查询控制台复制到新位置](https://resources.jetbrains.com/help/img/idea/2026.3/copy_a_console_file_to_a_new_location.png)

Procedure: 在文件浏览器中打开查询控制台

要在您的文件浏览器中打开 查询控制台，请执行以下任一操作：

* 右键点击 查询控制台 选项卡并导航到  `在 | <file_browser> 中打开` 。

* 打开   项目  工具窗口（ `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))），并导航到  `Scratches and Consoles | Database Consoles` 内部目录。 展开包含您的 查询控制台 的数据源组。 右键点击该 查询控制台，然后选择  `在 | <file_browser> 中打开` 。

![在文件浏览器中打开查询控制台](https://resources.jetbrains.com/help/img/idea/2026.3/open_console_in_file_browser.png)

Procedure: 设置默认架构

为 查询控制台 选择默认模式后，您可以在语句中省略该模式或数据库的名称。

* 要设置默认架构或数据库，请点击工具栏右上角的   <schema>   下拉菜单。 然后，选择您需要的架构。

有关架构的更多信息，请参阅 [架构](schemas.html) 主题。

![选择默认架构或数据库](https://resources.jetbrains.com/help/img/idea/2026.3/db_select_default_schema.png)

## 查询控制台参考

在 [代码编辑器技巧与参考](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)

