会话
启用 数据库工具和 SQL 插件
此功能依赖 数据库工具和 SQL 插件,默认随 PyCharm 一起提供并启用。 如果相关功能不可用,请确保没有禁用该插件。
按下 Ctrl+Alt+S 以打开设置,然后选择 。
打开 已安装 选项卡,找到 数据库工具和 SQL 插件,并选中其名称旁边的复选框。
在 PyCharm 中,与数据库的连接是在特殊包装器中建立的——会话。 每个会话是对单个连接的包装器,并存储该连接的信息(例如是否处于活动状态、事务控制模式及其他设置)。
在会话内,连接可在需要时并按照定义的 设置 打开和关闭。
会话可以有 客户端——文件,这些文件的查询通过会话持有的连接发送。 数据编辑器 也可以作为会话的客户端。
您可以在 服务 工具窗口中查看数据源、会话及会话客户端。 会话图标角上的绿色圆点表示该会话已连接。

在上图中, 服务 工具窗口显示以下节点:
数据源。
未连接的会话。
已连接的会话。
会话客户端。
有关会话管理选项和工具栏控件的详细信息,请参阅 服务工具窗口 主题。
如果您关闭 PyCharm 并重新打开,您所有的会话都会在 服务 工具窗口中可用,但它们将为空。
新建会话
根据您创建新会话的方式,它可以自动连接,也可以在执行某个操作后再连接。 会话图标角上的绿色圆点表示已连接状态。
您可以通过以下任一方式创建新会话:
打开 查询控制台 ,在数据编辑器中查看数据库对象的数据,或将 SQL 文件附加到数据源。
结果是在 服务 工具窗口的数据源节点下,会出现新的会话节点,并在其下方显示一个客户端节点。
对于 查询控制台,在您执行需要与数据库交互的操作后,会话将连接。 例如,当您 运行查询 时。
对于表,会话会自动连接,因为 PyCharm 需要活动连接来向数据库请求表数据、接收数据,并在数据编辑器中显示。
对于 SQL 文件,会话会自动连接。 要针对任一数据源数据库或架构运行查询,您必须在 <schema> 列表中选择它们,将您的文件附加到它们。
执行需要与数据库交互的操作。 例如, 运行存储过程 ,或使用 运行配置 运行脚本。
结果是在 服务 工具窗口的数据源节点下,会出现新的已连接会话节点。
管理会话
PyCharm 提供三种在会话间分配客户端连接的模式: 单个共享会话、 两个会话: 共享与内省 和 专用会话。
单一会话被多个客户端共享,包括内省。 共享会话为
默认。例如,当每个新查询都需要 MFA 批准时,请使用此模式。

IDE 使用两个会话:一个用于内省,另一个
默认会话由所有其他客户端共享。如果需要使用 单个共享会话 模式但又希望将内省保留在单独会话中,请切换到此模式。 这样,如果内省耗时较长,就不会阻塞其他客户端。
数据库内省会话会在数据源节点下的 服务 工具窗口中以
introspection形式显示。
要启用
introspection会话的显示,请按 Ctrl+Alt+S 打开 IDE 设置,转到 ,然后选择 在“服务”工具窗口中显示内部会话。- 专用会话
每个新客户端会创建单独的会话。
数据库内省会话会在数据源节点下的 服务 工具窗口中以
1形式显示。
要启用
1会话的显示,请按 Ctrl+Alt+S 打开 IDE 设置,转到 ,然后选择 在“服务”工具窗口中显示内部会话。
更改会话模式
要控制客户端如何使用会话,请执行以下操作:
打开 数据源与驱动程序 对话框(Shift+Enter ),并选择您的数据源。
在该对话框的右侧窗格中,打开 选项 选项卡。
在 连接 设置部分,从 会话控制 下拉菜单中选择模式。
点击 确定 以应用更改。
(可选)如果出现 应用更改 对话框,请选择您希望继续的方式。

否 :保留已连接的会话不变。
是 :断开所有已连接的会话。

切换会话
如果您需要在不同的会话中运行查询或 SQL 文件,可以切换到其他会话。
要切换会话,请在 服务 工具窗口中,右键点击要切换会话的文件,点击 切换会话 并选择要附加该文件的会话。

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

- Tx 模式
设置事务模式。
- 切换会话
将客户端附加到其他会话。
- 切换数据源
将客户端附加到其他数据源。
- 在新选项卡中打开
将会话或数据源移至单独的选项卡。
- Deleete
删除该会话。
- 跳转到源代码
将焦点移至会话的客户端。
将会话移动到单独的选项卡
右键点击会话并选择 在新选项卡中打开。
所有会话

单独选项卡

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