PhpStorm 2025.2 Help

配置连接

启用 数据库工具和 SQL 插件

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

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

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

当您 创建数据源时,PhpStorm 会自动连接到数据库以接收数据库对象。 然后连接关闭。 与数据库交互的数据源名称会在 数据库 工具窗口中显示,并带有一个小的绿色圆圈。

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

关闭数据库连接

连接选项

为连接设置时区

  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. 架构 选项卡中,在 对象筛选器(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

    数据源选项中的 Object Filter 字段

筛选数据库和架构

  1. 通过以下任一方式打开数据源属性:

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

    • 请按 Shift+Enter.

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

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

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

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

    请考虑以下示例:

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

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

    • @:@ :仅当前架构

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

连接模式

启用连接的只读模式

  1. 通过以下任一方式打开数据源属性:

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

    • 请按 Shift+Enter.

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

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

    启用连接的只读模式

单会话模式

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

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

  1. 通过以下任一方式打开数据源属性:

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

    • 请按 Shift+Enter.

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

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

  4. 点击 应用(A)

    启用单会话模式

单数据库模式

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

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

  1. 通过以下任一方式打开数据源属性:

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

    • 请按 Shift+Enter.

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

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

  4. 点击 应用(A)

    启用单一数据库模式

事务模式

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

如何将更改提交到数据库

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

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

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

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

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

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

更改事务级别

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

  1. 通过以下任一方式打开数据源属性:

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

    • 请按 Shift+Enter.

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

  3. 点击 选项 选项卡。

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

    所选的事务控制将应用于新建的 查询控制台

    数据源的默认事务模式

自动提交更改

默认情况下,只有在您按下 提交 图标 提交图标 或按下 Ctrl+Enter 时,更改才会提交到数据库。 您可以启用 立即提交更改 选项来自动提交您的更改。

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

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

  3. 点击 确定

    立即提交更改
最后修改日期: 2025年 9月 26日