PyCharm 2026.2 Help

会话

启用 数据库工具和 SQL 插件

此功能依赖 数据库工具和 SQL 插件,默认随 PyCharm 一起提供并启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 数据库工具和 SQL 插件,并选中其名称旁边的复选框。

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

在会话内,连接可在需要时并按照定义的 设置 打开和关闭。

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

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

服务工具窗口

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

  1. 数据源。

  2. 未连接的会话。

  3. 已连接的会话。

  4. 会话客户端。

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

如果您关闭 PyCharm 并重新打开,您所有的会话都会在 服务 工具窗口中可用,但它们将为空。

新建会话

根据您创建新会话的方式,它可以自动连接,也可以在执行某个操作后再连接。 会话图标角上的绿色圆点表示已连接状态。

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

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

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

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

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

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

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

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

管理会话

PyCharm 提供三种在会话间分配客户端连接的模式: 单个共享会话两个会话: 共享与内省专用会话

单个共享会话

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

例如,当每个新查询都需要 MFA 批准时,请使用此模式。

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

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

如果需要使用 单个共享会话 模式但又希望将内省保留在单独会话中,请切换到此模式。 这样,如果内省耗时较长,就不会阻塞其他客户端。

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

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

要启用 introspection 会话的显示,请按 Ctrl+Alt+S 打开 IDE 设置,转到 数据库 | 查询执行 | 输出与结果 ,然后选择 在“服务”工具窗口中显示内部会话

专用会话

每个新客户端会创建单独的会话。

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

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

要启用 1 会话的显示,请按 Ctrl+Alt+S 打开 IDE 设置,转到 数据库 | 查询执行 | 输出与结果 ,然后选择 在“服务”工具窗口中显示内部会话

更改会话模式

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

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

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

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

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

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

    应用更改对话框
    • :保留已连接的会话不变。

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

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

切换会话

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

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

在服务工具窗口中为 SQL 文件切换会话

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

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

设置事务模式。

切换会话

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

切换数据源

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

在新选项卡中打开

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

Deleete

删除该会话。

跳转到源代码

将焦点移至会话的客户端。

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

  • 右键点击会话并选择 在新选项卡中打开

  • 所有会话

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

    会话的单独选项卡

服务工具窗口参考

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

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