查询控制台

概述

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

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

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

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

有关在查询控制台中使用查询结果的详细信息，请参阅查询结果。

代码编辑器

代码编辑器是您使用 resolve modes 和代码辅助功能编写 SQL 语句，并针对相关数据源执行它们的地方。

代码编辑器工具栏控件请参见代码编辑器控件。在编辑器基础中了解有关编辑器的更多信息。

SQL 语句执行

执行语句时，会打开服务工具窗口。服务工具窗口显示可用的连接会话、输出和结果选项卡。有关服务工具窗口的更多信息，请参见服务工具窗口。

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

使用控制台文件

创建查询控制台

要创建一个控制台，请在数据库工具窗口中使用以下操作之一（视图(V)｜工具窗口｜数据库）。

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

打开控制台

打开控制台时，您可以在此编写 SQL、运行并查看结果。

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

重命名查询控制台

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

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

在数据源目录下对控制台进行分组

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

删除查询控制台

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

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

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

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

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

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

配置控制台设置

设置默认架构

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

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

修改控制台设置

打开控制台并单击打开查询执行设置... 按钮（）。

配置控制台方言

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

右键单击编辑区域，然后选择将方言（<current_dialect>）更改为。在更改SQL 方言窗口中，选择一种方言。

提高效率的技巧

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

在控制台中，右键单击任意区域，然后选择 Local History｜显示历史记录。

在编辑器中应用代码样式

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

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

将鼠标悬停在控制台选项卡上以查看文件详细信息。

从“选择目标”窗口导航到控制台文件

按 Alt+F1 ，选择项目视图，然后按 Enter。

以表格形式编辑 INSERT 语句中的数据

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

上下文菜单

在代码编辑器上下文菜单中，使用以下操作提高工作效率：

作为表编辑

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

更改方言（<CurrentDialect>）

仅适用于 Oracle。更改 SQL 方言。从列表中选择一种方言。

Explain Plan｜ Explain Plan

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

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

要构建火焰图，请单击火焰图。

Explain Plan｜ Explain Plan (Raw)

显示当前语句的执行计划（或 explain plan）。结果以表格格式显示。技术上将执行 EXPLAIN <CURRENT_STATEMENT> 或类似语句。

执行 Ctrl+Enter

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

写入文件执行

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

运行“控制台 [data_source]” Ctrl+Shift+F10

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

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

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

图表｜显示可视化弹窗 Ctrl+Alt+U

在弹出窗口中打开图示。

查询控制台参考

使用代码编辑器编写并执行 SQL 语句，以及执行其他相关操作。

在编辑器基础中查看更多关于编辑器的信息。

工具栏控件

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