GoLand 2025.2 Help

用户参数

有关使用用户参数的更多信息,请参阅 运行查询 主题中的相关章节。

项

说明

在查询控制台和SQL 文件中启用

Apply parameter patterns to SQL in SQL files and 查询控制台 s. 您可以在 各个模式 的级别上限制使用范围。

如果此复选框被清除,则无论各个模式指定了何种使用范围,都不会在 SQL 文件和控制台中使用这些模式。

使用SQL 注入在字符串字面量中启用

对通过 SQL 注入的字符串字面量应用参数模式。 如果需要,您可以在 各个模式 的级别上限制使用范围。

如果清除此复选框,则无论各个模式指定了何种使用范围,都不会在字符串字面量中使用这些模式。

在SQL 字符串中替换

对 SQL 代码中的字符串字面量应用参数模式。

例如,请参考以下代码。

SELECT ${column_name} FROM actor WHERE actor_id='${actor_id}'

如果清除该复选框,GoLand 将只在其中找到参数 column_name。 参数 actor_id 将被视为字符串。

但如果选择 在SQL 字符串中替换 选项,则参数 actor_id 会被视为用户参数。

“在 SQL 字符串中替换”设置已禁用
“在 SQL 字符串中替换”设置已启用

形参模式

参数模式及其使用范围列表。

The patterns are specified using regular expressions. 位于括号 () 中的值将被视为参数名称。 初始提供的模式具有以下含义:

  • \?(\d+) — 一个问号后跟一个或多个数字,例如 ?69 ,此时 69 是参数名称。

  • %\w+ — % 后跟一个或多个单词字符,例如 %xyz。

  • \$\{([^$\{\}]*)\} — $ ,然后是 { ,然后是除 $、 { 或 } 外的任意字符零次或多次,随后是 } ,例如: ${}、 ${value}。

  • \$\(([^\)]+)\) — $ ,然后是 ( ,然后是除 ) 外的任意字符一次或多次,然后是 ) ,例如 $(x)。

  • \$(\w+)\$ — $ ,然后是一个或多个单词字符,随后再出现 $ ,例如 $x1$。

  • \#(\w+)\# — # ,然后是一个或多个单词字符,随后再出现 # ,例如 #field_3#。

有关参数命名行为的详细信息,请参阅 命名行为。

使用 “添加”按钮 Alt+Insert、 “移除”按钮 Alt+Delete、 “上一处匹配”按钮 Alt+Up 和 “下一处匹配”按钮 Alt+Down 添加、删除及重新排序模式。

要编辑模式或其使用范围,请点击该模式并使用以下控件:

  • 在脚本中 :如果不希望在 SQL 文件和 查询控制台 中使用该模式,请取消选中此复选框。

  • 在字面量中 :如果不希望在注入 SQL 的字符串字面量中使用该模式,请取消选中此复选框。

  • 所有语言 :点击该链接并清除您不想使用该模式的语言复选框。

最后修改日期: 2025年 9月 26日