# 运行 SQL 文件

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

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

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

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

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

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

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

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

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

在 CLion 中，您可以从 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)), `⌘ ⌃ ⌥ ⇧ R` (Xcode), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+R` (ReSharper), `⌘ ⌥ ⇧ R` (ReSharper (macOS)), `Ctrl+T` (QtCreator), `⌘ T` (QtCreator (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` (Xcode), `0` (Visual Studio), `0` (Visual Studio (macOS)), `0` (ReSharper), `0` (ReSharper (macOS)), `0` (QtCreator), `0` (QtCreator (macOS)), `0` (NetBeans), `0` (Eclipse), `0` (Eclipse (macOS))。

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

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

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

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

* 目标数据源/架构 ：您要运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您选择一个数据源作为目标，CLion 会显示将运行脚本的模式。 这是默认模式。

* 脚本文件 ：需要运行的 SQL 文件。 若要添加文件，请点击 Add 按钮( ![添加按钮](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. 您可以立即运行该配置，也可以保存配置以便稍后运行。

* 要保存运行配置以供稍后运行，请点击 确定 。

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

![使用运行/调试配置运行文件](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)), `⌘ ⌃ R` (Xcode), `Alt+Shift+R` (Visual Studio), `Alt+Shift+R` (Visual Studio (macOS)), `Alt+Shift+R` (ReSharper), `Alt+Shift+R` (ReSharper (macOS)), `Alt+Shift+R` (QtCreator), `Alt+Shift+R` (QtCreator (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. 请选择您的运行配置设置。

* 目标数据源/架构 ：您要运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您选择一个数据源作为目标，CLion 会显示将运行脚本的模式。 这是默认模式。

* 脚本文件 ：需要运行的 SQL 文件。 若要添加文件，请点击 Add 按钮( ![添加按钮](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)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (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. 请选择您的运行配置设置。

* 目标数据源/架构 ：您要运行数据库脚本的数据库或架构。 此设置依赖于方言。 如果您选择一个数据源作为目标，CLion 会显示将运行脚本的模式。 这是默认模式。

* 脚本文件 ：需要运行的 SQL 文件。 若要添加文件，请点击 Add 按钮( ![添加按钮](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)), `⌘ ⌥ U` (Xcode), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Ctrl+Alt+F5` (ReSharper), `⌃ ⌥ F5` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌃ ⇧ R` (QtCreator (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS))）。 此操作会创建临时运行配置。

3. 在   编辑配置  窗口中，点击   Add  按钮 !["添加"图标](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)), `⌘ .` (Xcode), `Shift+F5` (Visual Studio), `⇧ F5` (Visual Studio (macOS)), `Shift+F5` (ReSharper), `⇧ F5` (ReSharper (macOS)), `Shift+F5` (QtCreator), `⌘ ⇧ Y` (QtCreator (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: 暂停输出

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

> **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` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS))。

2. 在   Search Everywhere  对话框中输入文件名。

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)), `⌘ ⌥ U` (Xcode), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Ctrl+Alt+F5` (ReSharper), `⌃ ⌥ F5` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌃ ⇧ R` (QtCreator (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS))。

5. 在   编辑配置   窗口中，点击   Add   按钮 ( !["添加"图标](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)

