# 语言注入设置：SQL 注入

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

> **TL;DR**
> `文件 | 设置 | 语言注入 - SQL 注入`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 语言注入 - SQL 注入`  适用于 macOS
>
>
>
> `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)

在 [语言注入](language-injections-settings.html) 页面中，点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  ，并从上下文菜单中选择   SQL 注入  ，或者选择一个条目并点击 ![编辑按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.edit.svg)，将打开此对话框。

|  条目  |  描述  |
| --- | --- |
|  名称  |  注入的名称。  |
|  语言  |     要注入的语言。        * ID : 选择要 inject 的语言的 ID 或名称。    * 前缀 : 指定要添加到相应字符串值之前的字符序列。    * 后缀 : 指定要添加到相应字符串值之后的字符序列。      前缀和后缀是可选的。     |
|  位置模式集锦  |     在此字段中，输入规则，用于定义希望 IntelliJ IDEA 将文字识别为受限标识符的上下文。      > **Note:** > 这些规则由  程序结构接口模式  构建，实际上是内部 IntelliJ IDEA 语言的方法链式调用。 [程序结构接口](psi-viewer.html) 按 IntelliJ IDEA 处理文件的方式显示文件结构。       SQL 元素模式：        使用 SQL 元素模式来识别适用语言受限标识符的 SQL 元素。 可以组合模式，以按 SQL 方言、函数／方法名称、实参位置和函数／方法实参数量限制匹配。        * 基本模式： ``` sqlElement().forDialects(<DIALECT>).functionArgument(<INDEX>, <FUNCTION-PATTERN>) ``` `sqlElement()` 会启动 SQL 元素的模式。 `forDialects(<DIALECT>)` 会将匹配限制为指定的 SQL 方言。 `functionArgument(<INDEX>, <FUNCTION-PATTERN>)` 会进一步将匹配限制为在指定的从零开始的索引处用作函数／方法实参的元素。 函数调用必须匹配 `<FUNCTION-PATTERN>` 。    * `<FUNCTION-PATTERN>` : ``` sqlFunctionCall().name(<NAME>).params(<PARAMS-PATTERN>) ``` `sqlFunctionCall()` 会启动函数调用的模式。 `name(<NAME>)` 会将匹配限制为具有指定名称的函数／方法。 `params(<PARAMS-PATTERN>)` 会对函数／方法实参应用额外条件。    * `<PARAMS-PATTERN>` : ``` sqlExpressions().count(<MIN>, <MAX>) ``` `sqlExpressions()` 会启动 SQL 表达式列表的模式。 `count(<MIN>, <MAX>)` 会将匹配限制为包含 `<MIN>` 到 `<MAX>` 个表达式的列表。       组合示例：        [甲骨文]  `REGEXP_LIKE`  中的 RegExp       内置规则名称：  `Oracle RegExp` 。       ``` sqlElement()     .forDialects("Oracle")     .functionArgument(         1,         sqlFunctionCall()             .name("regexp_like")             .params(sqlExpressions().count(2, 3))     )  ```      此模式会匹配 甲骨文 方言中的 SQL 元素，前提是该元素是具有两个或三个实参的  `regexp_like`  函数调用中索引  `1`  处的实参。        `REGEXP_LIKE`  的第二个实参是正则表达式模式，因此 IntelliJ IDEA 会将匹配的字符串文字  `'^[a-z]+$'`  视为 RegExp 片段：       ```SQL SELECT 'Match' FROM dual WHERE REGEXP_LIKE('hello', '^[a-z]+$');  ```     ![\[Oracle\] REGEXP_LIKE 中的正则表达式](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_sql_injection_example_oracle_regexp.png)     更多示例：         * [甲骨文] `XMLQUERY` 中的 XPath 内置规则名称： `Oracle XPath` 。 ``` sqlElement().forDialects("Oracle").functionArgument(0, sqlFunctionCall().name("xmlquery","xmlexists")) ``` 此模式会匹配 甲骨文 `XMLQUERY` 和 `XMLEXISTS` 函数／方法调用中索引 `0` 处的实参。 IntelliJ IDEA 会将匹配的字符串文字 `'/catalog/book'` 视为 XPath 片段： ```SQL SELECT XMLQUERY( '/catalog/book' PASSING XMLTYPE('<catalog><book>SQL</book></catalog>') RETURNING CONTENT ) FROM dual; ``` ![\[Oracle\] XMLQUERY 中的 XPath](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_sql_injection_example_oracle_xpath.png)    * [Microsoft SQL 服务器] `OPENJSON` 中的 JSON 内置规则名称： `SQL Server JSON` 。 ``` sqlElement().forDialects("TSQL").functionArgument(0,sqlFunctionCall().name("openjson").params(sqlExpressions().count(1, 2))) ``` 此模式会匹配带有一个或两个实参的 T-SQL `OPENJSON` 调用中索引 `0` 处的实参。 IntelliJ IDEA 会将匹配的字符串文字 `'{"name":"Alice","age":30}'` 视为 JSON 片段： ```SQL SELECT * FROM OPENJSON('{"name":"Alice","age":30}'); ``` ![\[Microsoft SQL Server\] OPENJSON 中的 JSON](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_sql_injection_example_ms_sql_server_json.png)       多个模式        可以为单个受限标识符规则定义多个位置模式。 如果有任一模式匹配，受限标识符将被激活（它们使用 OR 逻辑组合）。 请在单独的行中添加每个模式。      > **Warning:** > 如果您正在编辑预定义的受限标识符规则，模式已被指定。 它们可确保高效与易用。 建议您使用这些配置，而不是新建。    |
|  高级  |     在此区域，可以选择指定其他设置以缩小受限标识符规则的适用上下文，从而启用对注入过程更细致的控制。        * 值模式 输入确定 inject 语言上下文的正则表达式。 通过将模式的第一个捕获组用作受限标识符的目标，可以配置该过程，使语言仅被 inject 到匹配特定模式的值中，或被 inject 到匹配该模式的多个部分中。    * 单个文件 - 如果此选项关闭，与值模式匹配的片段将被单独处理，视为不同的“文件”——例如，从片段编辑器的视角来看。 如果该选项开启，相应片段会全部合并在一起，形成一个单元或“文件”。 给定值模式 `xxx (.+) yyy (.+) zzz` 以及片段 `xxx select * yyy from family zzz` ， 如果该选项关闭， `select *` 和 `from family` 会被视为两个独立片段（或“文件”）。 如果该选项开启， `select * from family` 会被视为一个单元或“文件”。    |

## 运作方式

* [语言和引用受限标识符](using-language-injections.html)

## See also

### 概念

[语言和引用受限标识符](using-language-injections.html)

### 参考

[语言注入](language-injections-settings.html)

