WebStorm 2025.2 Help

运行查询

您可以通过快捷键、工具栏按钮与图标、上下文菜单以及运行/调试配置来运行代码。 您可以从 查询控制台、 临时文件和 用户文件中运行查询。

有关在何处以及如何查看查询结果的更多信息，请参见 查询结果。

运行语句和过程

在查询控制台中运行语句

您可以将 查询控制台 理解为一个可以输入和运行代码的终端。

  1. 在 数据库 工具窗口中，单击数据源。

  2. 按 F4 打开 查询控制台。 有关控制台使用的更多信息，请参见 使用控制台。

  3. 输入或粘贴要执行的语句。

  4. 单击工具栏上的 执行按钮执行(X)。 或，按 Ctrl+Enter。

    如果有多个语句，请选择是否执行所有语句或单个语句。 建议列表中始终包含一项，用于运行所有语句。

    运行查询

从打开的文件中运行语句

在 WebStorm 中，您可以打开并运行文件。 文件大小限制为 20 MB。 当打开大于 20 MB 的文件时，只显示文件的前 2.5 MB。 该文件应与 SQL 文件类型关联。 关于文件类型关联的更多信息，请参阅 文件类型关联主题。

  1. 打开 项目 工具窗口（视图(V) | 工具窗口 | 项目 ），然后双击一个 SQL 文件。

    关于在 WebStorm 中附加目录和文件的更多信息，请参阅 用户文件。

  2. 点击要执行的语句。

    此外，您还可以选择（高亮）要执行的代码片段。 它可以是子查询或一组语句。 WebStorm 仅执行选中的部分。

  3. 点击工具栏上的 执行(X) 按钮（执行按钮）。 或者按 Ctrl+Enter。

    要自定义查询执行设置，请点击 自定义 链接。 或者，按下 Ctrl+Alt+S 打开设置，然后导航到 工具 | 数据库 | 查询执行。 。

  4. （可选）如果 SQL 文件未附加到数据源，请在 <数据源> 列表中选择要附加的数据源。

    关于将 SQL 文件附加到数据源的更多信息，请参阅 数据源关联。

  5. 在 语句 窗口中，按 Enter 来运行所选语句。 您可以在其他条目之间切换以运行另一组语句。 即将执行的语句会在查询编辑器中高亮显示。

    有关运行脚本文件的另一个示例，请参阅 位于 youtube.com 的以下视频。

运行存储过程

存储过程是一组具有指定名称的 SQL 语句。 您可以在 PostgreSQL、Microsoft SQL Server、Oracle 和 MySQL 中执行存储过程。

  1. 右键点击要执行的存储函数，然后选择 运行函数。

  2. 在 执行例程 窗口中，填写所有必要的参数值，然后点击 确定。

    如有需要，勾选 从此处运行 复选框并选择要从中运行存储函数的文件或控制台。

    运行存储过程

运行 SELECT 语句并将结果保存到文件中

  1. （可选）如果文件未连接到数据源，请在工具栏的数据源列表中选择一个数据源。 然后在 会话 列表中选择连接会话。

    关于连接会话的更多信息，请参阅 会话。

  2. 右键点击一个 SELECT 语句。

  3. 选择 执行到文件 并选择输出格式。

  4. 在 导出数据 对话框中，指定要使用的提取器及其他设置。

    关于 导出数据 对话框的更多信息，请参阅 导出数据主题。

将 SELECT 语句的结果保存到文件中

取消正在运行的语句

  • 要取消正在运行的语句，请点击工具栏上的 取消正在运行的语句图标取消正在运行的语句。

    或者，将鼠标悬停在边距上的进度指示器上，点击替换进度图标的 取消正在运行的语句图标取消正在运行的语句。

如果您连续点击两次 取消正在运行的语句图标取消正在运行的语句 按钮，WebStorm 会显示一个警告，您可以选择终止远程进程或稍候片刻。 显示此警告是为了确保安全，因为停用某些正在同时进行的进程可能存在潜在危险。

在 10 秒未取消的空闲时间后，IDE 也会显示警告。

取消连接

您不仅可以中断请求的执行，还可以中断连接的创建。 这对于 控制台 中的首个查询尤其相关，因为它也会创建连接。

您可以停止创建连接的进程。 为此，请在正在创建连接时，点击工具栏上的 取消正在运行的语句 按钮（取消正在运行的语句图标）。 连接将被停止，您将看到 连接已取消 消息。

解析模式

为了运行 SQL 脚本，将数据库对象的用法视为链接，并为您提供正确的代码补全，WebStorm 必须将代码中的数据库对象解析到特定上下文。 默认情况下，IDE 使用以下之一作为解析数据库对象的起点： <schema> 选择器，或默认数据库（若未设置上述选项）。

根据您的代码是单个脚本，还是包含多个无关 SQL 语句，请选择以下解析模式之一以正确解析数据库对象：

  • Playground ：查询控制台 的默认模式。 所有数据库对象都解析到相同的上下文。

    如果您的代码是一组未连接的 SQL 语句，且不打算作为单个脚本运行，请使用此模式。

  • 脚本 ：本地 SQL 文件的默认模式。 USE SQL 语句（PostgreSQL 中为 SET search_path TO ）会覆盖默认解析数据库对象的上下文。

    如果您的代码旨在作为单个脚本运行，请使用此模式。

在以下视频中， public schema 被选为 查询控制台 的默认值。 该 schema 包含 actor 表，而 information_schema schema 不包含此表。 当解析模式为 Playground 时，两个 SELECT 语句中的数据库对象都会被解析为默认 schema，因为所有语句都被视为不相关。

一旦将解析模式更改为 脚本 ，第二个 SELECT 语句将被视为与 SET search_path TO information_schema 语句相关。 该语句中不再解析 actor 表。

用户参数

根据数据库供应商的不同，问号 ? 会被视为 SQL 语句中的参数。 您可以在 工具 | 数据库 | 查询执行 | 用户参数 设置页面中指定哪些其他字符及其组合应在何处被视为参数&#xa0; Ctrl+Alt+S。

SQL 参数的模式是通过使用正则表达式指定的。

运行参数化语句

如果语句中包含参数，WebStorm 会在执行语句之前提示您指定参数的值。

  • 要执行参数化语句，请单击工具栏上的 执行 按钮（执行按钮 ），并在第二列中输入数值。 或者，要打开 形参 对话框，请单击 查看形参 按钮（查看参数按钮）。

    执行参数化语句

命名行为

在 WebStorm 中，您可以使用 positional 和 named 用户参数。 对于 positional 用户参数，每次出现都会根据其顺序单独处理。 对于 named 用户参数，所有具有相同名称的出现将视为同一个参数。

要使用 named 参数，请按 Ctrl+Alt+S 打开设置，并导航到 工具 | 数据库 | 查询执行 | 用户参数。 在 参数模式 面板中，将 () 添加到您的用户参数模式中。 IDE 会将 () 的内容视为参数名称，并在运行脚本时只请求一个值。 否则，如果在脚本中多次使用同一个参数，IDE 会根据其顺序请求多个值。

请参见以下示例：

SELECT * FROM my_table WHERE a = ?x OR b = ?x;

  • \?\w+ ：positional 用户参数模式。 ?x 参数将被视为两个不同的用户参数。 这些参数的值根据其顺序被请求。

    使用通用用户参数运行语句

  • \?(\w+) ：named 用户参数模式。 ?x 都被视为相同的用户参数，其中 x 是参数名称。

    使用命名用户参数运行语句

有关参数模式的更多信息，请参阅 用户参数参考主题。

示例

数组作为参数

在 WebStorm 中，用值替换参数非常简单。 要使用数组作为值，请在相应字段中指定您的数组。

在以下示例中， ? 参数可以替换为 206, 'John', 'Smith' 值：

INSERT INTO actor (actor_id, first_name, last_name, last_update) VALUES (?, '01.02.2023 13:34');
使用值的数组作为参数

有关参数的更多信息，请参阅数据库文档。

参数模式

如果脚本中使用了特定语法的参数，请使用正则表达式指定相应的模式。

对于以下示例，必须在 工具 | 数据库 | 查询执行 | 用户参数 设置页面中设置 %{2}(\w+_\d+) 模式&#xa0; Ctrl+Alt+S：

SELECT title, description, release_year FROM actor JOIN film_actor fa ON actor.actor_id = fa.actor_id JOIN film f ON f.film_id = fa.film_id WHERE last_name = '%%winnerpl_2';
IDE 设置对话框中的参数模式示例

预览表结构

在 IDE 代码编辑器中，您可以使用 快速文档 功能预览 SQL 语句中表的结构。

  • 要在 SQL 语句中预览表结构，请选择该表并按 Ctrl+Q。

显示的 快速文档 弹出窗口中包含 CREATE DDL 脚本以及有关该表的其他信息。

有关该功能的更多信息，请参阅 查看内联文档。

在编辑器标签页中预览表结构

查看已执行语句的历史记录

使用查询历史记录对话框

WebStorm 会存储您在 查询控制台 中运行的所有语句的历史记录。

  • 要打开 查询历史记录 对话框，请单击工具栏上的 浏览查询历史记录 按钮（浏览查询历史记录按钮 ），或按 Ctrl+Alt+E。

    在 查询历史记录 对话框中，您可以执行以下操作：

    • 要过滤信息，请开始输入搜索查询。

    • 要将查询从 查询历史记录 对话框粘贴到 控制台，请在 查询历史记录 对话框的左侧窗格中双击该查询。

    • 要从历史记录中删除记录，请选择该记录并按 Delete。

    查看已执行查询的历史记录

查看结果

通常，当您运行查询时，会以表格格式接收结果。 WebStorm 会在 数据编辑器中显示结果。 默认情况下，对于每条语句，带有结果的数据编辑器会显示在 服务 工具窗口的一个单独选项卡中。

有关查看查询结果的详细信息，请参阅 查询结果。

SELECT 语句的结果显示在服务工具窗口的标签页中
最后修改日期： 2025年 9月 26日
数据库图表查询结果