PyCharm 2025.3 Help

会话

启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件,默认随 PyCharm 捆绑并启用。 如果相关功能不可用,请确保未禁用该插件。

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

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

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

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

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

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

服务工具窗口

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

  1. 数据源。

  2. 未连接的会话。

  3. 已连接的会话。

  4. 会话客户端。

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

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

新建会话

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

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

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

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

    1. 对于 查询文件,一旦您执行需要与数据库交互的操作,会话即会连接。 例如,一旦您 运行查询

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

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

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

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

管理会话

切换会话

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

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

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

在单个会话中工作

您可以在单个会话中运行来自多个 SQL 文件的查询,并接收多个数据库对象的数据。 例如,当每个新查询都需要 MFA 批准时。

要在单个会话中工作,请按以下步骤启用 单会话模式:

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

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

  3. 连接 设置部分,选中 单会话模式 复选框。

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

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

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

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

  6. 运行您的查询。

所有新查询都将在 默认 会话中运行。

多个 SQL 文件中的查询在单个会话中运行

下表包含用于处理会话的其他基本操作。

操作

说明

重命名会话

服务 工具窗口中,右键点击一个会话,然后选择 重命名会话

重命名连接会话

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

服务 工具窗口中,右键点击会话或数据源,然后选择 在新标签页中打开。 要还原此操作,请关闭该单独的选项卡。

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

关闭会话

服务 工具窗口中,右键点击一个会话,然后选择 关闭会话

该会话将与其会话客户端分离,并从列表中消失。

关闭所有会话

服务 工具窗口中,右键点击数据源,然后选择 关闭所有会话

关闭所有连接会话

服务工具窗口参考

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

服务工具窗口中的数据库服务
最后修改日期: 2025年 12月 2日