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

在上图中, 服务 工具窗口显示以下节点:
数据源。
未连接的会话。
已连接的会话。
会话客户端。
有关会话管理选项和工具栏控件的详细信息,请参阅 服务工具窗口 主题。
如果您关闭 PyCharm 并重新打开,您所有的会话都会在 服务 工具窗口中可用,但它们将为空。
新建会话
根据您创建新会话的方式,会话可以自动连接,也可以在执行某些操作后连接。 会话图标角上的绿色圆点表示已连接状态。
您可以通过以下任一方式创建新会话:
打开 查询文件 ,在数据编辑器中查看数据库对象的数据,或将 SQL 文件附加到数据源。
结果,在 服务 工具窗口的数据源节点下会出现新的会话节点,并在其下显示一个客户端节点。
对于 查询文件,一旦您执行需要与数据库交互的操作,会话即会连接。 例如,一旦您 运行查询。
对于表,会话会自动连接,因为 PyCharm 需要活动连接来从数据库请求表数据、接收数据并在数据编辑器中显示。
对于 SQL 文件,会话会自动连接。 要对任一数据源的数据库或架构运行查询,您必须在 <schema> 列表中选择它们,以将您的文件附加到它们。
执行需要与数据库交互的操作。 例如, 运行存储过程 ,或使用 运行配置 运行脚本。
结果,在 服务 工具窗口的数据源节点下会出现新的已连接会话节点。
管理会话
切换会话
如果您需要在不同的会话中运行查询或 SQL 文件,可以切换到其他会话。
要切换会话,请在 服务 工具窗口中,右键点击要切换会话的文件,点击 切换会话 并选择要附加该文件的会话。

在单个会话中工作
您可以在单个会话中运行来自多个 SQL 文件的查询,并接收多个数据库对象的数据。 例如,当每个新查询都需要 MFA 批准时。
要在单个会话中工作,请按以下步骤启用 单会话模式:
打开 数据源和驱动程序 对话框(Shift+Enter ),并选择您的数据源。
在该对话框的右侧窗格中,打开 选项 选项卡。
在 连接 设置部分,选中 单会话模式 复选框。
点击 确定 以应用更改。
(可选)如果出现 应用更改 对话框,请选择您希望继续的方式。

否 :保留已连接的会话不变。
是 :断开所有已连接的会话。
运行您的查询。
所有新查询都将在 默认 会话中运行。

下表包含用于处理会话的其他基本操作。
操作 | 说明 |
|---|---|
重命名会话 | 在 服务 工具窗口中,右键点击一个会话,然后选择 重命名会话。 ![]() |
将会话或数据源移至单独的选项卡 | 在 服务 工具窗口中,右键点击会话或数据源,然后选择 在新标签页中打开。 要还原此操作,请关闭该单独的选项卡。 ![]() |
关闭会话 | 在 服务 工具窗口中,右键点击一个会话,然后选择 关闭会话。 该会话将与其会话客户端分离,并从列表中消失。 |
关闭所有会话 | 在 服务 工具窗口中,右键点击数据源,然后选择 关闭所有会话。 ![]() |
服务工具窗口参考
有关工具窗口控件和选项卡的详细信息,请参阅 服务工具窗口 主题。



