WebStorm 2026.2 Help

会话

在 WebStorm 中,与数据库的连接通过特殊的封装器——sessions 建立。 每个会话都是对单个连接的封装,并存储该连接的信息(例如,是否处于活动状态、事务控制模式以及其他设置)。

在一个会话内,连接可以按需并根据定义的 设置 打开和关闭。

会话可以有 客户端——文件,其查询通过会话持有的连接发送。 数据编辑器 也可以作为会话的客户端。

您可以在 服务 工具窗口中查看数据源、会话和会话客户端。 会话图标角落的绿色点表示该会话已连接。

服务工具窗口

在上图中, 服务 工具窗口显示以下节点:

  1. 数据源。

  2. 会话已断开。

  3. 连接会话。

  4. 会话客户端。

有关会话管理选项和工具栏控件的更多信息,请参阅 服务工具窗口 主题。

如果您关闭 WebStorm 并再次打开,所有会话将在 服务 工具窗口中可用,但它们将是空的。

新会话

根据您创建新会话的方式,它可以自动连接或在某些操作后连接。 会话图标角落的绿色点表示连接状态。

您可以通过以下任一方式创建新会话:

  • 打开 查询控制台 、在数据编辑器中查看数据库对象的数据,或将 SQL 文件附加到数据源。

    结果是在 服务 工具窗口的数据源节点下,会出现新的会话节点,并在其下包含一个客户端节点。

    1. 对于 查询控制台,在您执行需要与数据库交互的操作后,会话将连接。 例如,当您 运行查询 时。

    2. 对于表,会话会自动连接,因为 WebStorm 需要活动连接从数据库请求表数据、接收数据并在数据编辑器中显示。

    3. 对于 SQL 文件,会话会自动连接。 要针对数据源的数据库或架构运行查询,您必须在 <schema> 列表中选择它们,以将您的文件附加到它们。

  • 执行需要与数据库交互的操作。 例如, 运行存储过程 或使用 运行配置 运行脚本。

    结果是在 服务 工具窗口的数据源节点下会出现新的已连接会话节点。

管理会话

WebStorm 提供三种模式将客户端连接分配到会话中: 单个共享会话两个会话: 共享与内省专用会话

单个共享会话

单个会话被多个客户端共享,包括内省。 共享会话是 默认

例如,如果每个新查询都需要 MFA 批准,可以使用此模式。

所有连接都在一个共享会话中。
两个会话: 共享与内省

IDE 使用两个会话:一个用于内省,另一个 默认 会话由其他所有客户端共享。

如果想使用 单个共享会话 模式但保持内省在独立会话中,则切换至此模式。 这样,如果内省耗时较长,也不会阻塞其他客户端。

数据库内省会话会在数据源节点下的 服务 工具窗口中显示为 introspection

所有连接在一个会话中,内省在一个单独的会话中。

若要启用显示 introspection 会话,请按 Ctrl+Alt+S 打开 IDE 设置,进入 数据库 | 查询执行 | 输出和结果 ,并选择 在服务工具窗口中显示内部会话

专用会话

每个新客户端都会创建独立会话。

数据库内省会话会在数据源节点下的 服务 工具窗口中显示为 1

每个客户端使用单独的会话。

若要启用显示 1 会话,请按 Ctrl+Alt+S 打开 IDE 设置,进入 数据库 | 查询执行 | 输出和结果 ,并选择 在服务工具窗口中显示内部会话

更改会话模式

要控制客户端如何使用会话,请执行下列操作:

  1. 打开 数据源与驱动程序 对话框(Shift+Enter ),然后选择您的数据源。

  2. 在对话框的右侧窗格中,打开 选项 选项卡。

  3. 连接 设置部分,从 会话控制},{ 下拉菜单中选择模式。

  4. 点击 确定 以应用更改。

  5. (可选)如果出现 应用更改 对话框,请选择您想要继续的方式。

    “应用更改”对话框
    • :保持已连接的会话完好无损。

    • :断开所有已连接的会话。

在数据源和驱动程序对话框中为数据源更改会话模式

切换会话

如果您需要在不同的会话中运行查询或 SQL 文件,您可以切换到另一个会话。

  • 要切换会话,请在 服务 工具窗口中,右键点击您要切换会话的文件,点击 切换会话 并选择您要附加文件的会话。

在“服务”工具窗口中切换 SQL 文件的会话

使用上下文菜单,可以对会话执行以下基本操作:更改事务模式、取消会话中正在运行的语句,以及切换客户端的会话或数据源。 您还可以 将会话移动到单独的选项卡 ,在 服务 工具窗口中。

数据库会话上下文菜单
事务模式

设置事务模式。

切换会话

将客户端附加到其他会话。

切换数据源

将客户端附加到其他数据源。

在新标签页中打开

将会话或数据源移动到单独的选项卡。

删除

删除会话。

跳转到源

将焦点移动到会话的客户端。

将会话移动到单独的选项卡

  • 右键点击会话并选择 在新标签页中打开

  • 所有会话

    所有数据库会话在一个选项卡中
  • 单独选项卡

    会话的单独选项卡

服务工具窗口参考

有关工具窗口控件和选项卡的更多信息,请参阅 Services 工具窗口主题。

在 服務 工具窗口中的数据库服务
2026年 7月 14日