WHERE 过滤表达式，限制不同主体在同一张表中可见的行范围。配置后，受控表的查询请求在所有 SQL、Notebook、仪表盘等鉴权场景下都会自动追加对应的过滤条件，仅返回满足条件的行。region = 'south' 的订单，华北区运营人员只能看到 region = 'north' 的订单，运营总监能看到全部行——可以通过为不同用户组分别添加行过滤表达式实现。限制项 | 说明 |
适用对象 | 行级权限规则按表配置，作用于该表。 |
授权主体类型 | 支持 用户 与 用户组 ；同一主体出现在用户层与用户组层时，权限范围取并集。 |
表达式格式 | 行过滤表达式为标准 SQL WHERE 子句片段，例如 year > 2010 AND country != 'US'。 |
表达式长度 | 单条行过滤表达式最大长度为 2000 字符 。 |
规则数量 | 单张表可配置的行权限规则数量无硬上限。 |
校验项 | 表达式支持一键校验，包括字段是否存在、逻辑、语法等基础检查；校验失败需修正后才能保存。 |
Schema 变更行为 | 当行过滤表达式引用的字段在表 Schema 中被重命名或删除后，相关行权限规则自动失效 ；需重新编辑表达式才能恢复行权限管控。 |
用户组成员变更 | 用户组成员新增 / 移除后，已经在执行中的查询不会实时切换 可见行集合；变更对后续新发起的查询生效。 |
权限继承 | 行权限 Tab 的可见性继承表详情页的 权限 Tab 可见性；+ 授权 > 行权限 按钮的可点击性继承 + 授权 按钮本身的权限。 |
配套能力范围 | 列权限、ABAC 策略、动态视图等高级安全能力当前版本暂未对外开放 ，将在后续版本中逐步上线。 |
WHERE 子句片段，例如 year > 2010 AND country != 'US'。参数 | 说明 | 是否必填 | 默认值 | 取值范围 |
授权对象 | 选择行规则作用的主体，可在「用户」「用户组」之间切换，支持模糊搜索、多选与全选。 | 是 | - | 当前工作空间内已存在的用户 / 用户组 |
行过滤表达式 | 标准 SQL WHERE 子句片段。引用的字段必须为该表的真实字段。最大长度 2000 字符。 | 是 | - | 例如 region = 'south'、year > 2010 AND country != 'US' |
SELECT * FROM <表名>，返回的行集合仅包含表达式条件成立的行。region = 'south'、用户规则为 vip = true，该用户最终可见的行是「region = 'south' 或 vip = true」的所有记录。WHERE 子句片段。可使用比较运算符（= != > < >= <=）、逻辑运算符（AND OR NOT）、IN 列表、BETWEEN、LIKE 等常见语法。具体函数和算子的支持范围以底层引擎实际能力为准，建议在编辑时使用 校验 功能验证表达式是否合法。文档反馈