# 运行 SQL 文件

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

Procedure: 启用 数据库工具和 SQL 插件

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

> **Note:**
> 没有 Ultimate 订阅时，数据库工具和 SQL 的功能支持在 IntelliJ IDEA 中受限。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

> **Note:**
> 此页面介绍如何使用 数据库工具和 SQL 插件运行 SQL 文件。 有关运行应用程序和其他文件的更多信息，请参阅 [运行应用程序](running-applications.html)。

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

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

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

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

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

## 运行 SQL 文件

运行小部件:

Procedure:

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

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

* 在 [Navigation bar](guided-tour-around-the-user-interface.html#navigation-bar) 可见 ( `查看 | 外观 | 导航栏` ) 的情况下，从运行/调试配置选择器中选择 `编辑配置` 。

* 请按 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) 然后按 `0` (Windows), `0` (macOS), `0` (IntelliJ IDEA Classic (macOS)), `0` (macOS System Shortcuts), `0` (XWin), `0` (GNOME), `0` (KDE), `0` (Emacs), `0` (Sublime Text), `0` (Sublime Text (macOS)), `0` (Visual Studio), `0` (Visual Studio (macOS)), `0` (NetBeans), `0` (Eclipse), `0` (Eclipse (macOS))。

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

* 要创建新的运行配置，请点击 添加新配置 图标（ ![新建配置图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后选择 数据库脚本 。

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

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

* 目标数据源 / 架构 ：要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您将数据源选为目标，IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

* 脚本文件 ：您要运行的 SQL 文件。 要添加文件，请点击 添加 按钮（ !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后导航到您要运行的文件。 如果脚本包含架构切换，您会看到警告（ ![警告](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.warning.svg)）。

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

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

* 要立即运行该配置，请点击 运行 。

![使用运行/调试配置运行文件](https://resources.jetbrains.com/help/img/idea/2026.3/db_run_debug_configurations_script_files.png)

项目工具窗口:

Procedure:

1. 在   项目   工具窗口中，右键点击要运行的 SQL 文件，然后选择   运行 '<file_name>'  。 或者，按 `Alt+Shift+R` (Windows), `⌘ ⌃ R` (macOS), `⌘ ⌃ R` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ R` (macOS System Shortcuts), `Alt+Shift+R` (XWin), `Alt+Shift+R` (GNOME), `Alt+Shift+R` (KDE), `Alt+Shift+R` (Emacs), `Alt+Shift+R` (Sublime Text), `⌘ ⌃ R` (Sublime Text (macOS)), `Alt+Shift+R` (Visual Studio), `Alt+Shift+R` (Visual Studio (macOS)), `Alt+Shift+R` (NetBeans), `Alt+Shift+G` (Eclipse), `⌘ ⌃ R` (Eclipse (macOS))。

![从项目工具窗口运行 SQL 文件](https://resources.jetbrains.com/help/img/idea/2026.3/run_sql_files_from_project_tool_window.png)

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

* 目标数据源 / 架构 ：要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您将数据源选为目标，IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

* 脚本文件 ：您要运行的 SQL 文件。 要添加文件，请点击 添加 按钮（ !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后导航到您要运行的文件。 如果脚本包含架构切换，您会看到警告（ ![警告](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.warning.svg)）。

![编辑配置对话框](https://resources.jetbrains.com/help/img/idea/2026.3/db_run_configuration_select_target.png)

3. 点击   运行  。

数据库工具窗口:

Procedure:

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

![从数据库工具窗口运行 SQL 文件](https://resources.jetbrains.com/help/img/idea/2026.3/run_sql_file_from_database_tool_window.png)

2. 在打开的文件浏览器窗口中，导航到您要运行的 SQL 文件。

3. 点击   打开  。

您可以在   运行   工具窗口中查看输出。 有关工具窗口控件的更多信息，请参阅 [运行工具窗口](run-tool-window.html)。

拖动文件:

Procedure:

1. 打开   项目  工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))），导航到 SQL 文件并选择它。

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

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/drag_script_file_to_run.mp4)

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

* 目标数据源 / 架构 ：要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您将数据源选为目标，IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

* 脚本文件 ：您要运行的 SQL 文件。 要添加文件，请点击 添加 按钮（ !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后导航到您要运行的文件。 如果脚本包含架构切换，您会看到警告（ ![警告](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.warning.svg)）。

![编辑配置对话框](https://resources.jetbrains.com/help/img/idea/2026.3/db_run_configuration_select_target.png)

4. 点击   运行  。

运行当前文件:

Procedure:

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

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

2. 点击工具栏中   当前文件   选项旁边的 ![运行](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg)。

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

* 目标数据源 / 架构 ：要针对其运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您将数据源选为目标，IntelliJ IDEA 会显示脚本将运行的架构。 该架构是默认架构。

* 脚本文件 ：您要运行的 SQL 文件。 要添加文件，请点击 添加 按钮（ !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)），然后导航到您要运行的文件。 如果脚本包含架构切换，您会看到警告（ ![警告](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.warning.svg)）。

![编辑配置对话框](https://resources.jetbrains.com/help/img/idea/2026.3/db_run_configuration_select_target.png)

4. 点击   运行  。

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

Procedure: 为多个数据源运行 SQL 文件

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

2. 右键点击选择并调用   运行 <file_names>  （或按 `Ctrl+Shift+F10` (Windows), `⌃ ⇧ R` (macOS), `⌃ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ R` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `Ctrl+Shift+F10` (Sublime Text (macOS)), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS))）。 此操作会创建临时运行配置。

3. 在   编辑配置  窗口中，点击   添加  按钮 !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，在   目标数据源 / 架构  窗格中选择您要运行所选文件的数据源或方案。

您可以点击   最近  按钮( ![最近图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.history.svg))来选择您最近使用的数据源。

![为多个数据源运行 SQL 文件](https://resources.jetbrains.com/help/img/idea/2026.3/db_run_sql_files_select_data_source.png)

4. 点击   运行  。

## 数据源附件

Procedure: 将 SQL 文件附加到数据源

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

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_attach_sql_file_to_data_source.mp4)

Procedure: 切换 SQL 文件的数据源

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

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_switch_data_sources_for_sql_file.mp4)

Procedure: 将 SQL 文件从数据源分离

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

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/db_detach_sql_file_from_data_source.mp4)

## 停止执行

Procedure:

* 在   运行  工具窗口中，点击工具栏上的 ![停止按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)   停止  。 或者，按 `Ctrl+F2` (Windows), `⌘ F2` (macOS), `⌘ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ .` (macOS System Shortcuts), `Ctrl+F2` (XWin), `Ctrl+F2` (GNOME), `Ctrl+2` (KDE), `Ctrl+F2` (Emacs), `Ctrl+F2` (Sublime Text), `Ctrl+F2` (Sublime Text (macOS)), `Shift+F5` (Visual Studio), `⇧ F5` (Visual Studio (macOS)), `Shift+F5` (NetBeans), `Ctrl+F2` (Eclipse), `⌘ F2` (Eclipse (macOS)) 并选择要停止的进程。

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

## 查看输出

当您运行文件或使用运行配置时，输出显示在一个   运行  工具窗口的选项卡中。 有关工具窗口控件的更多信息，请参阅 [运行工具窗口](run-tool-window.html)。

![文件运行输出](https://resources.jetbrains.com/help/img/idea/2026.3/db_file_run_output.png)

Procedure: 暂停输出

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

![暂停输出](https://resources.jetbrains.com/help/img/idea/2026.3/pause_output.png)

> **Note:**
> 仅暂停输出。 暂停输出不会影响程序的执行。

## 提示和技巧

Procedure: 从搜索对话框执行文件

1. 按两次 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS))。

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

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

4. 按下 `Ctrl+Shift+F10` (Windows), `⌃ ⇧ R` (macOS), `⌃ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ R` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `Ctrl+Shift+F10` (Sublime Text (macOS)), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS))。

5. 在   编辑配置   窗口中，点击   添加   按钮 ( !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg))，然后选择您想要运行所选文件的数据源或方案。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置对话框](run-debug-configurations-dialog.html)