大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:ADD SQLBLACKLIST

· 52CE 我爱测

将一个 SQL 正则表达式添加至 SQL 黑名单。启用 SQL 黑名单功能后,StarRocks 会将所有需要执行的 SQL 语句与黑名单中的 SQL 正则表达式进行比较。StarRocks 不会执行与黑名单中任何正则表达式相匹配的 SQL,并返回错误。

ADD SQLBLACKLIST

功能

将一个 SQL 正则表达式添加至 SQL 黑名单。启用 SQL 黑名单功能后,StarRocks 会将所有需要执行的 SQL 语句与黑名单中的 SQL 正则表达式进行比较。StarRocks 不会执行与黑名单中任何正则表达式相匹配的 SQL,并返回错误。

有关 SQL 黑名单的更多信息,请参阅 管理 SQL 黑名单。

  • 该操作需要 SYSTEM 级的 BLACKLIST 权限。请参考 GRANT 为用户赋权。
  • 黑名单仅适用于 SELECT 语句、INSERT 语句(v3.1 及以上版本)以及 CTAS 语句(v3.4 及以上版本)。

语法

ADD SQLBLACKLIST "<sql_reg_expr>"

参数说明

sql_reg_expr:用于指定 SQL 语句的正则表达式。为了区分 SQL 语句中的特殊字符和正则表达式中的特殊字符,您需要使用转义符(\)作为 SQL 语句中特殊字符的前缀,如 (、) 以及 +。由于 ( 和 ) 在 SQL 语句中经常被使用,StarRocks 可以直接识别 SQL 语句中的 ( 和 )。所以您无需为 ( 和 ) 添加转义符。

示例

示例一:将 count(\*) 添加到 SQL 黑名单。

mysql> ADD SQLBLACKLIST "select count(\\*) from .+";

示例二:将 count(distinct ) 添加到 SQL 黑名单。

mysql> ADD SQLBLACKLIST "select count(distinct .+) from .+";

示例三:将 order by limit x, y,1 <= x <=7, 5 <=y <=7 加入SQL黑名单。

mysql> ADD SQLBLACKLIST "select id_int from test_all_type_select1 
    order by id_int 
    limit [1-7], [5-7]";

示例四:将复杂的 SQL 正则表达式添加到 SQL 黑名单中。该示例是为了演示如何使用转义符来表示 SQL 语句中的 * 和 -。

mysql> ADD SQLBLACKLIST 
    "select id_int \\* 4, id_tinyint, id_varchar 
        from test_all_type_nullable 
    except select id_int, id_tinyint, id_varchar 
        from test_basic 
    except select (id_int \\* 9 \\- 8) \\/ 2, id_tinyint, id_varchar 
        from test_all_type_nullable2 
    except select id_int, id_tinyint, id_varchar 
        from test_basic_nullable";

示例五:禁止所有 INSERT INTO 语句:

ADD SQLBLACKLIST "(?i)^insert\\s+into\\s+.*";

示例六:禁止所有 INSERT INTO ... VALUES 语句:

ADD SQLBLACKLIST "(?i)^insert\\s+into\\s+.*values\\s*\\(";

示例七:禁止所有 INSERT INTO ... VALUES 语句,但针对系统定义视图 _statistics_.column_statistics 的操作除外:

ADD SQLBLACKLIST "(?i)^insert\\s+into\\s+(?!column_statistics\\b).*values\\s*\\(";

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。