PyCharm 2026.1 Help

查询文件

启用 数据库工具和 SQL 插件

此功能依赖 数据库工具和 SQL 插件,默认随 PyCharm 一起提供并启用。 如果相关功能不可用,请确保没有禁用该插件。

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

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

概述

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

查询文件

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

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

位置

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

工具窗口中的查询文件。

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

代码编辑器

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

代码编辑器控件 中查找代码编辑器工具栏控件。 在 编辑器基础 中了解有关编辑器的更多信息。

SQL 语句执行

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

  • 如果执行的语句检索数据(例如, SELECT ),结果会显示在 结果 选项卡中,该选项卡的标题为限定表名。 有关为结果选项卡创建自定义标题的详细信息,请参阅 为结果选项卡使用自定义标题

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

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

    2. 服务 工具窗口。

    3. 输出结果 选项卡。 结果 选项卡处于活动状态。

    4. 结果选项卡工具栏

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

    2. 服务 工具窗口。

    3. 输出结果 选项卡。 输出 选项卡处于活动状态。

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

创建查询文件

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

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

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

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

打开查询文件

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

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

打开查询控制台

重命名查询文件

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

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

  • 项目 工具窗口(Alt+1 )中:

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

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

  • 数据库 工具窗口中:

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

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

重命名查询文件

删除查询文件

  1. 项目 工具窗口(Alt+1 )中:

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

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

  2. 数据库 工具窗口中:

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

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

重命名查询控制台

将数据源附加到查询文件

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

  • 代码编辑器:

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

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

  • 数据库 工具窗口中:

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

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

    3. 选择要和查询文件关联的数据源。

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

查询文件参考

关于查询文件的上下文菜单和工具栏按钮的更多信息,请参见 代码编辑器提示和参考 主题。

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

2026年 3月 24日