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日