一、功能介绍
注意：1. 当前该功能为白名单灰度开放，若需要体验可通过 提交工单 开通白名单使用。
注意：2. SQL 拦截功能底层依赖 StarRocks 社区 SQL Blacklist 能力，支持动态配置、即时生效，无需重启集群。
二、前提条件
1. 集群类型为 StarRocks，且版本 ≥ v2.3。不同拦截范围对 StarRocks 版本有不同要求：
·≥ v2.3 <v3.1仅拦截 SELECT，
·≥ v3.1 < 3.4仅拦截 SELECT + INSERT
2. 集群状态为“运行中”，FE 节点正常运行。
3. 登录账号需具有集群管理权限。
三、注意事项
1. 所有 SQL 拦截规则配置动态生效，无需重启 FE/BE 进程。
2. 同一 SQL 命中多条正则规则时，底层按规则创建顺序（Index）进行匹配，命中第一条即终止拦截，不继续匹配后续规则。
3. 正则表达式中，括号 ( ) 由平台自动处理转义，其他特殊字符（. * + ? 等）需用户手动添加 \\ 前缀。
4. 拦截功能开关默认为关闭状态，开启后已启用的规则将立即生效。
5. 删除的规则无法恢复，请谨慎操作。
四、步骤一：进入 SQL 拦截管理页面
1. 登录 EMR 控制台，单击目标 StarRocks 集群 ID，进入集群详情页。
2. 在顶部导航栏中，单击SQL 拦截标签页，进入 SQL 拦截管理页面。
3. 页面顶部展示 SQL 拦截配置状态栏，包含拦截功能总开关和规则统计信息。
五、步骤二：开启 SQL 拦截功能
1. 在 SQL 拦截管理页面顶部，找到“SQL 拦截配置”开关。
2. 单击开关，将其切换为“开启”状态（绿色）。
3. 开启后，所有状态为“已启用”的拦截规则将立即生效，开始拦截不符合规则的 SQL 语句。
4. 关闭拦截功能总开关时，系统将弹出确认弹窗，提示“关闭后 N 条已启用规则暂停生效，SQL 将不受任何限制执行”，请确认后操作。
六、步骤三：创建拦截规则
1. 在“拦截规则”下，单击“新建规则”按钮，弹出规则配置弹窗，按以下说明配置规则：
2. 规则类型选择：
| 类型 | 说明 | 支持状态 |
| SQL 正则黑名单 | 通过正则表达式匹配 SQL 文本，命中即拒绝执行 | 支持 |
3. SQL 正则黑名单配置项（选择此类型后展示）：
·规则名称（必填）：长度限制 1~128 个字符，支持字母、数字、中文、-、_。
·匹配模式（必填）：支持两种模式：• 快捷选择：内置高频拦截场景复选项，可多选，每项生成一条独立规则• 自定义正则：自由输入正则表达式，括号由平台自动转义
·拦截范围（必填）：单选：仅 SELECT / SELECT + INSERT / SELECT + INSERT + CTAS，系统根据集群 StarRocks 版本自动屏蔽不支持的选项
快捷选项说明（快捷选择模式）：
| 选项 | 说明 | 对应正则（示例） |
| 禁止 SELECT * | 防止全表扫描大表 | select \\\\* from .+ |
| 禁止 count(*) | 高频慢查询场景 | select count\\\\(\\\\*\\\\) from .+ |
| 禁止 count(distinct …) | 聚合去重内存消耗过大 | select count\\\\(distinct .+\\\\) from .+ |
| 禁止 ORDER BY 无 LIMIT | 可能导致全量排序 OOM | select .+ order by .+(?!.*limit).* |
4. 配置完成后，可选择：
·“保存并生效”（推荐）：规则创建后立即下发生效。
·“保存并禁用”：规则创建为禁用状态，不立即生效，后续可按需启用。
·“取消”：放弃当前配置，关闭弹窗。
注意：警告：
注意：下发黑名单：服务重启及服务角色 FE 节点重启时，黑名单规则将失效，需重新点击下方黑名单方可生效。
七、步骤四：管理拦截规则
在“拦截规则”列表中，可对已有规则进行以下管理操作：
1. 启用 / 禁用规则：单击规则行右侧开关，即时启用或禁用单条规则，无需重启集群。
2. 查看规则详情：单击规则名称，展开规则详情，查看完整的匹配正则和拦截范围。
3. 删除规则：单击操作列的删除，在确认弹窗中输入验证信息后完成删除。（注意：删除后无法恢复。）