llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

运行 SQL 文件

启用 数据库工具和 SQL 插件

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

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

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

SQL 文件使用运行配置对选定的数据库或架构运行。 根据您的目的,您可以通过以下方式之一运行 SQL 文件:

  • 通过运行配置小组件创建新的运行配置或编辑现有的运行配置。

  • 通过 项目 工具窗口运行所选文件来创建新的运行配置。

  • 通过 数据库 工具窗口运行文件以针对所选数据库或架构创建新的运行配置。

在 IntelliJ IDEA 中,您可以从 SQL 文件运行的 DML 语句的最大数目是 1000。

运行 SQL 文件

  1. 通过以下任一方式打开 运行/调试配置 对话框:

    • 从主菜单中选择 运行 | 编辑配置。

    • 在 Navigation bar 可见 (查看 | 外观 | 导航栏) 的情况下,从运行/调试配置选择器中选择 编辑配置。

    • 请按 Alt+Shift+F10 然后按 0。

  2. 在 运行/调试配置 对话框中,您可以创建一个新的运行配置或编辑现有的配置。

    • 要创建新的运行配置,请点击 添加新配置 图标(新建配置图标 ),然后选择 数据库脚本。

    • 要编辑现有的运行配置,请展开 数据库脚本 节点,并从列表中选择您要编辑的运行配置。

  3. 右侧窗格中显示的字段显示了所选配置类型的设置。

    • 目标数据源 / 架构 :要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。

      如果您将数据源选为目标,IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

    • 脚本文件 :您要运行的 SQL 文件。 要添加文件,请点击 添加 按钮("添加"按钮 ),然后导航到您要运行的文件。 如果脚本包含架构切换,您会看到警告(警告)。

  4. 您可以立即运行该配置,或保存该配置以便稍后运行。

    • 要保存运行配置以供稍后使用,请点击 OK。

    • 要立即运行该配置,请点击 运行。

使用运行/调试配置运行文件
  1. 在 项目 工具窗口中,右键点击要运行的 SQL 文件,然后选择 运行 '<file_name>'。 或者,按 Alt+Shift+R。

    从项目工具窗口运行 SQL 文件
  2. 选择您的运行配置的设置。

    • 目标数据源 / 架构 :要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。

      如果您将数据源选为目标,IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

    • 脚本文件 :您要运行的 SQL 文件。 要添加文件,请点击 添加 按钮("添加"按钮 ),然后导航到您要运行的文件。 如果脚本包含架构切换,您会看到警告(警告)。

    编辑配置对话框
  3. 点击 运行。

  1. 在 数据库 工具窗口中,右键点击数据源或架构,然后选择 SQL 脚本 | 运行 SQL 脚本…。

    从数据库工具窗口运行 SQL 文件
  2. 在打开的文件浏览器窗口中,导航到您要运行的 SQL 文件。

  3. 点击 打开。

    您可以在 运行 工具窗口中查看输出。 有关工具窗口控件的更多信息,请参阅 运行工具窗口。

  1. 打开 项目 工具窗口(Alt+1 ),导航到 SQL 文件并选择它。

  2. 将 SQL 文件拖动到 数据库 工具窗口中,放到您要运行的目标数据源、数据库或架构上。

  3. 选择您的运行配置的设置。

    • 目标数据源 / 架构 :要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。

      如果您将数据源选为目标,IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

    • 脚本文件 :您要运行的 SQL 文件。 要添加文件,请点击 添加 按钮("添加"按钮 ),然后导航到您要运行的文件。 如果脚本包含架构切换,您会看到警告(警告)。

    编辑配置对话框
  4. 点击 运行。

您可以使用工具栏上的专用选项运行单个文件。 运行和调试按钮可用,可让您立即运行当前打开的文件。

  1. 在编辑器中,打开您要运行的文件。

  2. 点击工具栏中 当前文件 选项旁边的 运行。

  3. 选择您的运行配置的设置。

    • 目标数据源 / 架构 :要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。

      如果您将数据源选为目标,IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

    • 脚本文件 :您要运行的 SQL 文件。 要添加文件,请点击 添加 按钮("添加"按钮 ),然后导航到您要运行的文件。 如果脚本包含架构切换,您会看到警告(警告)。

    编辑配置对话框
  4. 点击 运行。

您可以通过展开列表访问其他运行模式。 在打开的小部件中,您可以调试代码、带覆盖率运行、对其进行分析,或打开运行配置以指定更多选项。

为多个数据源运行 SQL 文件

  1. 在 项目 工具窗口中,选择您要运行的文件。

  2. 右键点击选择并调用 运行 <file_names> (或按 Ctrl+Shift+F10)。 此操作会创建临时运行配置。

  3. 在 编辑配置 窗口中,点击 添加 按钮 "添加"图标 ,在 目标数据源 / 架构 窗格中选择您要运行所选文件的数据源或方案。

    您可以点击 最近 按钮(最近图标 )来选择您最近使用的数据源。

    为多个数据源运行 SQL 文件
  4. 点击 运行。

数据源附件

将 SQL 文件附加到数据源

  • 从右上角的 <data sources> 列表中,选择您想要附加文件的数据源。

切换 SQL 文件的数据源

  • 要将文件附加到另一个数据源,请点击数据源列表并选择另一个数据源。 或者,在 会话 工具窗口中,右键点击文件名称,选择 切换数据源 ,然后选择数据源。

将 SQL 文件从数据源分离

  • 要将文件从数据源中分离,请点击数据源列表并选择 分离数据源ç。

停止执行

  • 在 运行 工具窗口中,点击工具栏上的 停止按钮停止。 或者,按 Ctrl+F2 并选择要停止的进程。

    这将对程序执行强制终止,这意味着可能会绕过操作系统、虚拟机和应用程序级别的常规清理机制,可能会阻止执行关闭钩子、正确释放资源、日志记录等。

查看输出

当您运行文件或使用运行配置时,输出显示在一个 运行 工具窗口的选项卡中。 有关工具窗口控件的更多信息,请参阅 运行工具窗口。

文件运行输出

暂停输出

  • 在 运行 工具窗口中右键点击,然后在上下文菜单中选择 暂停输出。 使用同一切换按钮恢复程序。

    暂停输出

提示和技巧

从搜索对话框执行文件

  1. 按两次 Shift。

  2. 在 随处搜索 对话框中输入文件名。

  3. 通过使用上下箭头选择文件。

  4. 按下 Ctrl+Shift+F10。

  5. 在 编辑配置 窗口中,点击 添加 按钮 ("添加"图标 ),然后选择您想要运行所选文件的数据源或方案。

2026年 11月 3日