PyCharm 2025.3 Help

用户参数

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

描述

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

将参数模式应用于 SQL 文件和 查询文件s 中的 SQL。 您可以在 单个模式 级别限制使用范围。

如果清除此复选框,则无论单个模式指定的使用范围为何,这些模式都不会用于 SQL 文件和 查询文件s。

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

将参数模式应用于由 SQL 注入的字符串字面量。 如有必要,您可以在 单个模式 级别限制使用范围。

如果清除此复选框,则无论单个模式指定的使用范围为何,这些模式都不会用于字符串字面量。

在SQL 字符串中替换

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

例如,请考虑以下代码。

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

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

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

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

形参模式

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

模式使用正则表达式指定。 位于括号 () 中的值被视为参数名称。 初始提供的模式具有以下含义:

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

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

  • \$\{([^$\{\}]*)\} - $ ,然后是 { ,随后是除 ${} 之外的任意字符零次或多次,接着是 } ,例如, ${}${value}

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

  • \$(\w+)\$ - $ ,然后是一个或多个单词字符,然后再次是 $ ,例如, $x1$

  • \#(\w+)\# - # ,然后是一个或多个单词字符,然后再次是 # ,例如, #field_3#

有关参数命名行为的更多信息,请参阅 命名方式

使用 添加按钮 Alt+Insert移除按钮 Alt+Delete上一个匹配项按钮 Alt+Up下一个匹配项按钮 Alt+Down 来添加、删除并重新排序这些模式。

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

  • 在脚本中 :如果不应在 SQL 文件和 查询文件s 中使用该模式,请清除此复选框。

  • 在字面量中 :如果不应在由 SQL 注入的字符串字面量中使用该模式,请清除此复选框。

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

最后修改日期: 2025年 12月 2日