GoLand 2025.2 Help

运行查询

启用 数据库工具和 SQL 插件

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

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

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

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

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

运行语句和过程

在查询控制台中运行语句

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

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

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

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

  4. 点击工具栏中的 执行按钮执行(X)。 或者，按下 Ctrl+Enter。

    如果有多个语句，选择是执行所有语句还是单个语句。 建议列表始终包含运行所有语句的选项。

    运行查询

从打开的文件中运行语句

在 GoLand 中，您可以打开并运行文件。 文件大小限制为 20 MB。 打开大于 20 MB 的文件时，仅显示前 2.5 MB 的内容。 文件应与 SQL 文件类型相关联。

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

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

  2. 单击要执行的语句。

    此外，您还可以选择（高亮）要执行的代码片段。 可以是子查询或一组语句。 GoLand 仅执行所选内容。

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

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

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

    有关将 SQL 文件附加至数据源的更多信息，请参见 数据源附加。

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

    有关运行脚本文件的其他示例，请参见 youtube.com 上的以下视频。

运行存储过程

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

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

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

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

    运行存储过程

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

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

    有关连接会话的更多信息，请参见 会话。

  2. 右键点击 SELECT 语句。

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

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

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

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

取消正在运行的语句

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

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

如果您连续点击 取消正在运行的语句图标取消正在运行的语句 按钮两次，GoLand 会显示一个警告，您可以选择终止远程进程或稍等片刻。 该警告是为了确保安全，因为停用某些进程可能会对当前正在进行的操作造成潜在危险。

此外，IDE 会在取消空闲状态达到 10 秒后显示警告。

取消连接

您不仅可以中断请求的执行，还可以中断连接的创建。 这对 控制台 中的第一个查询尤为重要，因为它也会创建连接。

您可以终止创建连接的过程。 为此，请在创建连接过程中点击工具栏上的 取消正在运行的语句 按钮（取消正在运行的语句图标）。 连接将被终止，并显示 连接已取消 消息。

解析模式

为运行 SQL 脚本、将数据库对象的用法视为链接并为您提供正确的代码补全，GoLand 必须将代码中的数据库对象解析至某个上下文。 默认情况下，IDE 会使用以下两者之一作为解析数据库对象的起点： <schema> 选择器或默认数据库（如未设置上述任意项）。

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

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

    如果您的代码由多个无关联的 SQL 语句组成，且不拟作为单一脚本运行，请使用此模式。

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

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

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

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

用户参数

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

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

运行带参数语句

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

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

    执行带参数语句

命名行为

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

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

请参考以下示例：

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

  • \?\w+ ：位置型用户参数模式。 ?x 参数被视为两个不同的用户参数。 值的请求取决于参数的顺序。

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

  • \?(\w+) ：命名型用户参数模式。 两个 ?x 被视为同一用户参数，其中 x 是参数名称。

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

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

示例

数组作为参数

在 GoLand 中，用值替换参数非常简单。 要将数组用作值，请在对应字段中指定数组。

在以下示例中， ? 参数可以用 206，'John'，'Smith' 值进行替换：

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

有关参数的详细信息，请参阅数据库文档。

参数模式

如果脚本中包含具有特定语法的参数，请使用正则表达式指定其模式。

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

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 脚本以及其他有关该表的信息。

有关此功能的更多信息，请参考 快速文档。

在编辑器选项卡中预览表结构

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

使用查询历史记录对话框

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

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

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

    • 要筛选信息，请开始输入搜索查询。

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

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

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

查看结果

通常，执行查询后，您会以表格形式收到结果。 GoLand 会在 数据编辑器 中显示结果。 默认情况下，对于每条语句，带有结果的数据编辑器都会在 服务 工具窗口中的单独标签页中打开。

有关查看查询结果的更多信息，请参阅 查询结果。

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