PhpStorm 2026.1 Help

查询文件

启用 数据库工具和 SQL 插件

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

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

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

概述

查询文件s 是可以在 IDE 中为数据源创建,并存储在 IDE 项目中的 SQL 和 JS 文件。 在 查询文件s 中,您可以编写、运行并存储您的 SQL 语句。 如果您选择将 查询文件 存储在 当前项目目录中,则它会被包含在项目上下文中。 另外,如果您的任务需要将文件作为通用 SQL 语句存储,查询文件也可以从任何数据源中分离。

查询文件

有关在查询文件中处理查询结果的更多信息,请参阅 查询结果

您可以使用工具栏上的数据源下拉菜单, 将查询文件与其他数据源关联

Location

您可以在 创建查询文件时指定其位置。 如果查询文件存储在 当前项目目录或附加到项目的目录中,您可以在 Project 工具窗口(Alt+1 )中找到它。

工具窗口中的查询文件

要将新的查询文件存储到其他位置,请在创建查询文件时指定目录。 您也可以将现有的查询文件移动到其他目录。

代码编辑器

代码编辑器中,您可以使用 解析模式和代码辅助功能编写 SQL 语句,并对关联的数据源执行这些语句。

代码编辑器控件中查找代码编辑器工具栏控件。 请阅读有关编辑器的详细信息,请参阅 编辑器基础

SQL 语句执行

当您执行语句时, 服务 工具窗口会打开。 服务 工具窗口显示可用的连接会话、 输出Result 选项卡。 有关工具窗口的更多信息,请参阅 服务工具窗口 主题。

  • 如果执行的语句检索数据(例如, 选择 ),结果将显示在具有合格表名称标题的 Result 选项卡中。 有关为结果选项卡创建自定义标题的更多信息,请参阅 使用自定义标题显示结果标签

  • 如果执行的语句未检索到数据,结果将显示在 输出 选项卡中。

    查询控制台与服务工具窗口的活动结果选项卡
    1. 代码编辑器工具栏

    2. .

    3. 服务 工具窗口。

    4. 输出结果标签。 Result 选项卡处于活动状态。

    5. 结果选项卡工具栏.

    带有 服務 工具窗口活动输出选项卡的查询控制台
    1. 代码编辑器工具栏

    2. .

    3. 服务 工具窗口。

    4. 输出结果标签。 输出 选项卡处于活动状态。

    5. 输出选项卡的右侧工具栏

创建查询文件

要创建 查询文件,请在 数据库 工具窗口中使用以下操作之一。

  • 选择一个数据源,然后在主菜单中选择 文件(F) | 新建(N) | 查询文件

  • 右键点击数据源并选择 新建 | 查询文件

  • 选择一个数据源,按 Alt+Insert ,然后选择 查询文件

打开查询文件

  • Project 工具窗口(Alt+1 )中,导航到您要打开的查询文件,然后双击它。

  • 数据库 工具窗口中,展开数据源节点,然后展开 查询文件 文件夹并双击要打开的查询文件。

打开查询控制台

重命名查询文件

要重命名 查询文件,请执行以下任一操作:

  • 右键点击 查询文件 选项卡并选择 重命名文件

  • Project 工具窗口 Alt+1 中:

    1. 导航到该文件。 默认情况下,它位于文件树的顶部。

    2. 右键点击该文件,然后选择 重命名Shift+F6)。

  • 数据库 工具窗口:

    1. 展开数据源节点和 查询文件 文件夹。

    2. 右键点击查询文件,然后选择 重命名Shift+F6)。

重命名查询文件

删除查询文件

  1. Project 工具窗口 Alt+1 中:

    1. 导航到您要删除的查询文件。

    2. 右键点击查询文件,然后选择 删除。 或者按 Delete

  2. 数据库 工具窗口:

    1. 展开数据源节点,然后展开 查询文件 文件夹。

    2. 右键点击查询文件,然后选择 删除Delete)。

重命名查询控制台

将数据源附加到查询文件

要将数据源附加到查询文件,请执行以下操作:

  • 代码编辑器:

    1. 在 查询文件 的工具栏上,点击数据源下拉列表。

    2. 转到 全部 子菜单,并选择您希望与 查询文件 关联的数据源。

  • 数据库 工具窗口:

    1. 导航到您的查询文件并选择它。

    2. 右键点击查询文件,然后选择 附加数据源

    3. 选择您希望与查询文件关联的数据源。

PhpStorm 会自动将 查询文件 与您选择的数据源关联。 关联后,查询文件名称保持不变,在 Project 工具窗口中,数据源会显示在查询文件名称旁边。

查询文件参考

代码编辑器技巧与参考手册。 主题中查找有关查询文件上下文菜单和工具栏按钮的信息。

编辑器基础 中了解更多关于代码编辑器的信息。

2026年 3月 24日