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日