查询控制台

启用数据库工具和 SQL 插件

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

按 Ctrl+Alt+S 打开设置，然后选择 Plugins。
打开已安装选项卡，找到数据库工具和 SQL插件，然后选择插件名称旁边的复选框。

概述

查询控制台s 是附加到数据源的 SQL 文件。您可以像在终端中一样，在查询控制台s 中编写并执行 SQL 语句。控制台不包含在项目上下文中。

创建数据源时，会自动创建该数据源的默认查询控制台。如有需要，您可以创建其他查询控制台。

每个 console 都会创建新的连接会话。如果您不想创建新连接，请启用单会话模式。

所有创建的查询控制台都位于内部目录数据库控制台中。要打开此文件夹，请打开 Project 工具窗口 Alt+1 并导航到临时文件和控制台｜数据库控制台。在您的计算机上，查询控制台文件存储在控制台子目录中，该目录位于 IDE 配置目录下。

如需详细了解如何在查询控制台中处理查询结果，请参阅查询结果。

代码编辑器

在代码编辑器中，您可以使用解析模式和代码辅助功能编写 SQL 语句，并对关联的数据源执行这些语句。

在代码编辑器控件中查找代码编辑器工具栏控件。请阅读有关编辑器的详细信息，请参阅编辑器基础。

SQL 语句执行

当您执行语句时，服务工具窗口会打开。服务工具窗口显示可用的连接会话、 Output 和 Result 选项卡。有关服务工具窗口的更多信息，请参阅服务工具窗口。

如果执行的语句检索数据（例如， SELECT ），结果将显示在具有合格表名称标题的 Result 选项卡中。有关为结果选项卡创建自定义标题的更多信息，请参阅为带有结果的选项卡使用自定义标题。
如果执行的语句未检索到数据，结果将显示在输出选项卡中。
1. 查询控制台选项卡工具栏。
2. 代码编辑器。
3. 服务工具窗口。
4. 输出和结果标签。 Result 选项卡处于活动状态。
5. 结果选项卡工具栏.
1. 查询控制台选项卡工具栏。
2. 代码编辑器。
3. 服务工具窗口。
4. 输出和结果标签。输出选项卡处于活动状态。
5. 右侧工具栏的输出选项卡。

处理控制台文件

创建查询控制台

要创建 console，请在数据库工具窗口（视图(V) | 工具窗口 | 数据库）中执行以下操作之一。

点击数据源并选择文件｜新建｜查询控制台。
右键点击数据源并选择新建｜查询控制台。
点击数据源，按 Alt+Insert ，然后选择查询控制台。
点击数据源，按 Ctrl+Shift+F10 ，然后选择新查询控制台。
点击一个数据源，然后按 Ctrl+Shift+Q。

打开控制台

当控制台打开时，您可以在这里编写 SQL，运行并获取结果。

在 Project 工具窗口中，导航到临时文件和控制台 | 数据库控制台 | <data_source_name> ，双击一个控制台文件。
在数据库工具窗口中，单击跳转到查询控制台… ，导航至全部子菜单，然后选择要打开的控制台或创建新控制台。
要打开数据源的默认查询控制台，请单击该数据源并按 F4。

重命名查询控制台

要重命名查询控制台文件，请执行以下任一操作：

右键点击控制台选项卡，并选择重命名文件。
打开 Project 工具窗口（视图(V) | 工具窗口 | Project ），并导航到临时文件和控制台｜数据库控制台。展开包含您 console 的数据源组，右键点击控制台文件，然后选择重命名（Shift+F6）。

将控制台分组到数据源目录下

在 Project 工具窗口中，导航到临时文件和控制台｜数据库控制台。
右键点击您要在其中创建新目录的数据源组，然后选择新建 | 目录。
指定目录名称。
选择并拖动控制台文件到目录中。
在移动对话框中，点击重构。

删除查询控制台

在 Project 工具窗口中，导航到临时文件和控制台｜数据库控制台。
展开一个包含您的控制台的数据源组。
右键点击控制台文件并选择删除。

将控制台文件复制到新位置

在 Project 工具窗口中，导航到临时文件和控制台｜数据库控制台。
展开一个包含您的控制台的数据源组。
右键点击控制台文件并选择重构 | 复制文件…。
在到目录(D) 字段中，指定文件的新位置。

在文件浏览器中打开一个控制台文件

要在文件浏览器中打开 console 文件，请执行以下任一操作：

右键点击某个 console 选项卡，并选择在 | <file_browser> 中打开。
打开 Project 工具窗口（视图(V) | 工具窗口 | Project ），并导航到临时文件和控制台｜数据库控制台。展开包含您 console 的数据源组，右键点击 console 文件，然后选择在 | <file_browser> 中打开。

配置控制台设置

设置默认架构

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

要设置默认架构或数据库，请点击工具栏右上角的 <schema> 下拉菜单。然后，选择您需要的架构。
有关架构的更多信息，请参阅架构主题。

修改控制台设置

请打开控制台并点击打开查询执行设置... 按钮()。

配置控制台方言

在代码编辑器中更改 SQL 方言

右键点击编辑区域并选择将方言 (<current_dialect>) 更改为。在更改SQL 方言窗口中，选择一种方言。

提高效率的提示

查看查询控制台的历史记录

在 console 中，右键点击任意区域并选择 Local History ｜显示历史记录。

在编辑器中应用代码样式

右键点击编辑器中的任何区域或代码选择，然后选择重新设置代码格式(R)。或者按 Ctrl+Alt+L。

查看查询控制台的文件路径

要查看某个文件的详细信息，将鼠标悬停在 console 选项卡上。

从“在...中选择”窗口导航到控制台文件

请按 Alt+F1 ，选择 Project 视图并按 Enter。

在 INSERT 语句中将数据编辑为表格

选择 INSERT 语句进行编辑。
右键点击所选内容，然后点击作为表编辑。
在打开的表格编辑器中，在表格单元格中进行必要的更改。按 Enter 确认。

上下文菜单

在代码编辑器的上下文菜单中，使用以下操作来提高您的生产力：

作为表编辑

在 INSERT 语句中，打开编辑器以表格格式处理数据。

更改方言（<CurrentDialect>）

仅限 Oracle。更改 SQL 方言。从列表中选择一个方言。更改 SQL 方言。从列表中选择一个方言。

Explain Plan ｜ Explain Plan

显示当前语句的执行计划（或 explain plan）。结果将在专用计划选项卡中以树形／表格混合格式显示。

要构建执行计划图示，请单击显示图表（位于计划选项卡左侧），或按 Ctrl+Alt+Shift+U。

要生成 flame graph，请单击火焰图。

Explain Plan ｜ Explain Plan (Raw)

显示当前语句的执行计划（或 explain plan）。结果以表格形式显示。系统会执行 EXPLAIN <CURRENT_STATEMENT> 或类似语句。

执行 Ctrl+Enter

执行当前语句或所选语句序列。

执行到文件

执行当前语句并将结果保存到文本文件中。选择输出格式并指定文件位置和名称。

运行 'console [data_source]' Ctrl+Shift+F10

执行查询控制台中的所有语句。

图表 | 显示可视化 Ctrl+Alt+Shift+U

在独立编辑器选项卡中打开图示。

图表 | 显示可视化弹出窗口 Ctrl+Alt+U

在弹出窗口中打开图示。

查询控制台参考

使用代码编辑器编写和执行您的 SQL 语句以及执行其他相关任务。

了解有关编辑器的更多信息，请参阅编辑器基础。

工具栏控件

图标	操作和快捷键	描述
	执行 `Ctrl+Enter`	执行选中的 SQL 语句。如果未选择任何内容，则执行当前语句。
	浏览查询历史记录 `Ctrl+Alt+E`	打开一个对话框，显示您为相应数据源运行的所有语句。另请参阅，使用“查询历史”对话框。
	查看形参	打开或关闭形参对话框。有关用户参数的更多信息，请参阅运行查询主题。
	打开查询执行设置…	打开工具 \| 数据库 \| 查询执行部分的设置对话框以查看或编辑查询执行设置。有关这些设置的更多信息，请参阅 Query Execution。
	在编辑器中查看结果	切换是否在查询控制台的代码编辑器中显示查询结果。有关编辑器内结果的更多信息，请参阅 In-Editor Results。
	事务模式和事务隔离	为数据库事务选择隔离级别及提交方式。自动：当前的事务会在您提交本地更改到数据库服务器时自动提交。手动：提交到数据库服务器的更改会累积在一个事务中，您可以通过工具栏上的发送并提交或回滚按钮显式提交或回滚这些更改。有关数据库事务模式和隔离的更多信息，请参阅 Submit changes to a database。
	提交	（对于手册事务模式。）提交当前事务。此按钮仅在手动 transaction 模式下可用。另请参见， transaction mode 和 isolation。
	回滚	（适用于手册事务模式。）回滚更改。此按钮仅在手动 transaction 模式下可用。另请参见，事务模式和隔离级别。
	取消正在运行的语句 `Ctrl+F2`	终止执行当前语句或语句。
	文件解析模式	选择解析模式以管理代码中的数据库对象的解析上下文。 Playground ：查询控制台的默认模式。所有数据库对象都解析到相同的上下文。脚本：本地 SQL 文件的默认模式。 `USE` SQL 语句（适用于 PostgreSQL 的 `SET search_path TO` ）会覆盖默认上下文以解析数据库对象。如需了解有关 resolve modes 的更多信息，请参阅 Resolve modes。
	启用 DBMS_OUTPUT	（仅限 Oracle 和 IBM Db2 LUW）切换 `DBMS_OUTPUT` 以控制台。
	使用 AI 生成代码	打开用于向 AI Assistant 输入提示的输入字段。如需了解有关 AI Assistant 的代码编辑器中代码生成的更多信息，请参阅 AI Assistant 文档，
<schema>	切换当前架构	选择默认架构或数据库。对于 PostgreSQL、Amazon Redshift 和 Greenplum，请使用 <schema> 列表来形成架构搜索路径。有关默认架构的更多信息，请参阅设置默认架构。