Skip to content

资源治理

资源治理是报表平台的控制面:谁拥有资源、谁能访问、发布要不要审批、跑在什么环境、查询花了多少钱、服务达没达标。在「报表中心 → 资源治理」(/report/governance)管理,页面分六个标签页。

所有报表资源(数据源、数据集、仪表盘、指标、打印模板、填报模板、资产模板)的访问同时受 RBAC 权限码、租户边界、所有权与 ACL 四层约束。

除直接打开本页外,数据源 / 数据集 / 仪表盘 / 打印报表列表的「权限与转移」操作会带着资源上下文直达本页,便于就地授权与转移。

目录与资源权限

资源目录

目录按资源类型分树:datasource | dataset | dashboard | metric | print_template | fill_template | asset_template,资源可归入目录便于组织与授权:

  • 目录不能跨资源类型移动
  • 目录非空时不能删除(需先清空或移走资源)。

ACL 授权

ACL 主体为用户或角色,权限级别为 viewer(查看)< editor(编辑)< owner(所有者)

  • 资源所有者天然拥有 owner 级别;授权操作只允许资源所有者执行;
  • ACL 可设置失效时间,可配置在目录上并向下继承
  • 有效权限 = 直接 ACL、继承 ACL 与所有权的最高级别,但不会跨租户;
  • 「有效权限检查」可输入用户 + 资源,查询系统最终判定的访问级别,便于排查授权问题。

注意

不要给全局目录补租户 ACL,也不要用 ACL 绕过数据集行级权限——ACL 决定「能不能打开资源」,行级权限决定「能看到哪些行」,两者独立生效。

发布审批

对资源的发布 / 环境晋级 / 废弃动作可走审批流:申请人提交(携带资源、动作、修订与发布快照)→ 审批人通过 / 拒绝,申请人可取消。状态流转为 pending → approved | rejected | cancelled

所有权转移

资源负责人变更(如人员离职)通过所有权转移完成:发起转移 → 新负责人接受 / 拒绝,发起人可取消。状态为 pending → accepted | rejected | cancelled

  • 接受后原所有者失去天然权限;确需保留访问时应显式为其创建 ACL。

环境与发布

内置 dev → staging → prod 三个环境(可自定义增删),资源通过**晋级(promotion)**在环境间发布:

  • 晋级保存源修订与源快照,禁止直接从开发环境覆盖生产环境的未审批版本;
  • 当前同步晋级流转为 pending → approved → succeeded;待处理记录可取消cancelled);
  • 成功发布可回滚rolled_back),不直接改生产快照;
  • 环境的 baseUrl/config 不存密钥,数据源凭据仍由加密字段管理。

配额与成本

查询配额

租户或用户限制查询资源用量:并发数、每日查询次数、返回行数、字节数与成本预算。

  • 日限额 0 表示不限次数,但并发上限(20)与数据源预算仍然生效
  • 可查看配额当前用量,或手动重置用量计数。

查询成本

每次取数记录成本日志(数据源、耗时、行数、字节数、估算成本),提供统计与趋势视图定位高成本查询与数据集,支持导出(report:query-cost:export)。

SLA 与违规

对数据资产定义服务等级目标并自动巡检:

SLA 类型监控目标
freshness数据新鲜度(最近刷新时间)
query_latency_p95查询 P95 延迟
availability取数可用性
dq_score数据质量评分(联动数据质量
  • 「评估」通过任务中心异步任务(report-sla-rule-evaluate)执行;
  • 未达标产出违规记录,状态 open → acknowledged | resolved 闭环处置。

权限

操作权限码
目录查看 / 新增 / 编辑 / 删除report:folder:list / :create / :update / :delete
ACL 管理report:resource:acl
有效权限检查report:resource:access
所有权转移report:resource:transfer
审批查看 / 申请(含取消) / 处理report:approval:list / :request / :approve
环境查看 / 新增 / 编辑 / 删除report:environment:list / :create / :update / :delete
环境晋级 / 回滚report:environment:promote
物化快照查看 / 刷新 / 清理report:materialization:list / :refresh / :purge
配额查看 / 新增 / 编辑(含重置) / 删除report:query-quota:list / :create / :update / :delete
成本查看 / 导出report:query-cost:list / report:query-cost:export
SLA 查看 / 新增 / 编辑(含违规处置) / 删除 / 评估report:sla:list / :create / :update / :delete / :evaluate

Built with VitePress for local documentation preview.