PhpStorm 2026.3 Help

配置连接

启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件,该插件默认情况下已捆绑并在 PhpStorm 中启用。 如果相关功能不可用,请确保您未禁用该插件。

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

  2. 找到 数据库工具和 SQL 插件,然后点击 启用。

当您 创建数据源时,PhpStorm 会自动连接到数据库,以 内省默认或选定的架构。

连接选项

为连接设置时区

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

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

    • 请按 Shift+Enter.

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

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

  4. 应用设置并点击 确定。

    在"时间区域"字段中选择一个时区

保持连接活跃

您可以在指定的时间段后运行一个保持活动查询来保持与数据库的连接。 您可以在驱动程序设置中为不受支持的数据库定义自定义查询。

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

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

    • 请按 Shift+Enter.

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

  3. 在 选项 选项卡上,选择 运行保活查询的间隔 复选框并输入秒数,以便 PhpStorm 再次运行 keep-alive 查询。

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

您可以指定 PhpStorm 终止连接的秒数。

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

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

    • 请按 Shift+Enter.

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

  3. 在 选项 选项卡上,选中 自动断开连接后 复选框,并输入终止 PhpStorm 连接所需的秒数。

设置预定义查询以建立连接

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

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

    • 请按 Shift+Enter.

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

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

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

更新数据库状态

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

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

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

    • 请按 Shift+Enter.

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

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

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

    更新数据库状态

使用对象筛选器筛选对象

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

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

    • 请按 Shift+Enter.

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

  3. 在 架构 选项卡上的 对象筛选器 字段中输入过滤选项。

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

    <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。

    数据源选项中的 Object Filter 字段

筛选数据库和架构

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

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

    • 请按 Shift+Enter.

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

  3. 在 架构 选项卡上的 架构模式 字段中输入过滤选项。

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

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

    请考虑以下示例:

    • *:* :所有数据库中的所有 schema。

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

    • @:@ :仅当前架构

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

连接模式

启用连接的只读模式

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

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

    • 请按 Shift+Enter.

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

  3. 在 选项 选项卡上,选中 只读 复选框。

    启用连接的只读模式

单数据库模式

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

请考虑使用此设置,用于 PostgreSQL 、 Azure SQL 数据库 、 Greenplum 、 Amazon Redshift 。

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

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

    • 请按 Shift+Enter.

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

  3. 在 选项 选项卡上,选择 单数据库模式。

  4. 点击 应用。

    启用单一数据库模式

事务控制

在 PhpStorm 中,您可以使用一种可用方式将事务提交到数据库,也可以选择事务的隔离级别。

事务模式

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

如何将更改提交到数据库

数据编辑器会累积您所做的所有更改。 当您点击 提交按钮提交 时,PhpStorm 会提交这些更改,并根据所选提交模式处理它们:

Tx:Auto

在 Tx:Auto 模式下,PhpStorm 会在您点击 提交按钮提交 后自动提交所有更改。

Tx:手册

在 Tx:手册 模式下,变更将存储在数据库的事务中。 当您点击 提交和提交按钮提交并提交 时,事务将提交到数据库。 当您提交事务时, 提交和提交按钮提交并提交 按钮会被禁用(显示为灰色)。 这意味着所有的事务都已提交。

Tx:透明

该模式只能在 查询控制台s 中切换。

在 Tx:透明 模式下,PhpStorm 只发送您执行的语句。 您需要像在 Tx:手册 模式下一样手动提交事务,但 IDE 不会自动发出 SQL 语句来读取隔离级别、重新读取当前搜索路径,或在您的语句周围创建临时保存点。

建立连接时,PhpStorm 仍会读取当前搜索路径,并在配置了其他搜索路径时进行设置。

Tx:透明 不能设置为数据源或驱动程序的默认事务模式。 对会话事务模式的更改仅适用于该会话,不会更改数据源的默认模式。 新会话会使用 Tx:Auto 或 Tx:手册 ,具体取决于数据源的配置。

如果提交模式设置为 Tx:Auto ,则每次更改值、行或列都会被隐式提交且无法回滚。 在 Tx:Auto 提交模式下, 提交和提交按钮提交并提交 和 "回滚"按钮回滚 按钮会被禁用并隐藏。

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

事务隔离

Tx 开关也可以用来选择事务的 隔离级别。

可用事务隔离级别列表取决于 DBMS。

设置数据源的默认事务控制设置

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

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

    • 请按 Shift+Enter.

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

  3. 点击 选项 选项卡。

  4. 从 事务控制 列表中,选择所选数据源的默认事务模式和事务隔离级别。

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

    数据源的默认事务模式

更改数据编辑器中的事务控制设置

  1. 在数据编辑器工具栏上,点击事务控制下拉列表。

  2. 从列表中选择事务模式和隔离级别。

更改事务级别

自动提交更改

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

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

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

  3. 点击 确定。

    立即提交更改
2026年 11月 9日