PyCharm 2025.3 Help

配置连接

启用 数据库工具和 SQL 插件

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

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

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

当您 创建数据源 时, PyCharm 会自动连接到数据库以获取数据库对象。 随后连接将关闭。 与数据库交互的数据源名称会在 数据库 工具窗口中以一个绿色小圆点显示。

如果您想关闭数据库连接,请选择一个数据源,然后在工具栏上点击 停用 按钮(停用按钮)。 或者,选择一个数据源并按 Ctrl+F2

关闭数据库连接

连接选项

为连接设置时区

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 选择要修改的数据源,然后点击 选项 选项卡。

  3. 时区 字段中,开始键入您要使用的时区。

  4. 应用设置并点击 确定

    在时区字段中选择一个时区

保持连接处于活动状态

您可以在指定时间后运行保活查询,以保持与数据库的连接处于活动状态。 对于不受支持的数据库,您可以在驱动程序设置中定义自定义查询。

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,选中 保持活动查询的运行间隔 复选框,并输入秒数,达到该秒数后 PyCharm 必须再次运行保活查询。

在指定时间后断开与数据库的连接

您可以指定以秒为单位的时段, PyCharm 将在该时段后终止连接。

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,选中 在以下时长后自动断开连接 复选框,并输入秒数,达到该秒数后 PyCharm 将终止连接。

设置在建立连接时运行的预定义查询

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,在 启动脚本 字段中,指定您计划在连接到数据库时运行的查询。

    在建立连接时运行预定义查询

刷新数据库状态

如果有人更改了远程数据库的数据或视图,本地的数据库视图可能与数据库的实际状态不一致。

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,选中 自动同步 复选框。

    如果清除了 自动同步 复选框,则只有当您在工具栏中点击 刷新 图标(刷新按钮 )或按 Ctrl+F5 时, 数据库 工具窗口中数据源的视图才会与数据库的实际状态同步。

    刷新数据库状态

使用对象筛选器筛选对象

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 架构 选项卡上,在 对象筛选器(F) 字段中键入筛选选项。

    在为 对象筛选器(F) 字段编写表达式时,请使用以下模式。

    <type>:[-]<pattern> ,其中:

    • <type> 可以是 aggregate、collation、event、fdw、ftable、mview、operator、package、role、routine、sequence、synonym、table、user、view、vtable。

    • <pattern> 是正则表达式。 要排除某个项,请在前面加上 - (减号)。 有关正则表达式的详细信息,请参阅 JavaTM 2 Platform Standard Edition 5.0 API 规范中的 Class Patterns

    数据源选项中的对象筛选器字段

筛选数据库与架构

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 架构 选项卡上,在 架构模式(P) 字段中键入筛选选项。

    • @ :当前数据库或架构。

    • * :每个数据库或架构。 您可以在 *: 之后列出架构。

    请参考以下示例:

    • *:* :所有数据库中的所有架构。

    • @:* :当前数据库中的所有架构。

    • @:@ :仅当前架构。

    • *:dbo|@:@|db1:s1,s2,s3 :来自所有数据库的 dbo 架构、当前架构、来自 db1 数据库的架构 s1,s2,s3

连接模式

为连接启用只读模式

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,选中 Read-only 复选框。

    为连接启用只读模式

单会话模式

单会话模式 表示数据源和所有 查询文件 使用同一个连接。 此模式允许您在数据库树中查看临时对象,或在不同的 查询文件 中使用相同的事务。 有关 查询文件 的更多信息,请参阅 查询文件

应用 单会话模式 时,您必须关闭所有已打开的连接。 PyCharm 会在您存在已打开的连接时显示通知。 要关闭所选数据源的已打开连接,请点击 是(Y)。 要关闭所有已修改数据源的已打开连接,请点击 全部是(A)

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,选择 单会话模式

  4. 点击 应用(A)

    启用单会话模式

单数据库模式

当您连接到数据源时, PyCharm 可以检索并向您显示该数据源拥有的所有数据库。 但在某些情况下(例如 PgBouncer 的特定设置),您只能或仅被允许使用某个数据库。 启用 单数据库模式 后,您在数据库树视图中仅会看到在连接设置中指定的数据库,而不是从数据源获取的所有数据库。

请考虑在 PostgreSQL、Azure SQL Database、Greenplum、Amazon Redshift 使用此设置。

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 数据源 选项卡上,选择要修改的数据源。

  3. 选项 选项卡上,选择 单数据库模式(S)

  4. 点击 应用(A)

    启用单数据库模式

事务模式

提交会结束事务,并使所有更改对其他用户可见。 在 PyCharm 中,您可以选择如何提交事务:自动或手动。

如何将更改提交到数据库

数据编辑器会累积您所做的所有更改。 当您按下 提交 按钮(提交按钮 )时, PyCharm 会提交这些更改,并根据所选的提交模式进行处理:

  • Tx:自动 模式下, PyCharm 会在您点击 提交 按钮(提交按钮 )后自动提交所有更改。

  • Tx:手动 模式下,更改会保存在事务中。 当您按下 发送并提交提交并提交事务按钮 )时,事务会提交到数据库。 当您提交事务后, 发送并提交 图标(提交并提交事务按钮 )将被禁用(变灰)。 这表示所有事务均已提交。

如果提交模式设置为 Tx:自动 ,则对值、行或列的每次更改都会隐式提交且无法回滚。 在 Tx:自动 提交模式下, 发送并提交提交并提交事务按钮 )和 回滚回滚按钮 )按钮将被禁用并隐藏。

如果提交模式设置为 Tx:手动 ,您可以通过点击 提交提交按钮 )或 回滚回滚按钮 )按钮来显式提交或回滚已提交的更改。 要将更改提交到数据库,请点击 发送并提交提交事务按钮)。

Tx 开关还可用于选择事务的 隔离级别

更改事务隔离级别

为数据源选择默认事务模式

  1. 通过执行以下任一操作打开数据源属性:

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • Shift+Enter

    打开数据源和驱动程序对话框
  2. 在已创建的数据源列表中,点击要修改的数据源。

  3. 点击 选项 选项卡。

  4. 事务控制 列表中,为所选数据源选择默认事务模式。

    所选的事务控制将应用于新的 查询文件s

    数据源的默认事务模式

自动提交更改

默认情况下,除非您点击 提交 图标 提交图标 ,或按 Ctrl+Enter ,否则更改不会提交到数据库。 您可以启用 立即提交更改 选项以自动提交您的更改。

  1. 在设置 Ctrl+Alt+S 中,导航到 工具 | 数据库 | 数据编辑器和查看器

  2. 数据修改 中选择 立即提交更改

  3. 点击 确定

    立即提交更改
最后修改日期: 2025年 12月 2日