Article body
正文
一、理解 BI PaaS：不是工具，是引擎
首先厘清一个关键概念：BI PaaS（Platform as a Service）不是「把 BI 工具放在云端」，而是「把 BI 能力作为服务嵌入到其他应用中」。
传统 BI 工具的模式是：厂商开发一个 BI 软件 → 企业购买后安装使用 → 终端用户在这个软件里看数据。衡石的 BI PaaS 模式是：衡石提供 BI 引擎 → 软件厂商把这个引擎嵌入到自己的产品中 → 软件厂商的客户在自己的产品里看数据。
这个差异看似微妙，实则关键：
| 维度 | 传统 BI 工具 | 衡石 BI PaaS |
|---|---|---|
| 购买者 | 终端企业 | 软件厂商（ISV） |
| 使用者 | 企业员工 | ISV 的客户 |
| 产品形态 | 独立软件 | 嵌入式引擎 |
| 技术交付 | 安装部署 | API / SDK / iFrame |
| 权限模型 | 单企业层级 | 多租户多层级 |
| 商业模式 | 按用户/按年 | 按租户/按用量 |
二、三种嵌入模式：从浅到深
衡石 BI PaaS 提供三种嵌入模式，适应不同的集成深度和定制化需求。
模式一：数据应用嵌入（分析成果嵌入）
嵌入粒度：把已经做好的仪表盘和报表嵌入到第三方应用中。
衡石侧：创建仪表盘 → 设置数据权限 → 生成嵌入链接
ISV侧：在自己的应用中通过 iFrame 或 Web Component 加载链接适用场景：
- 快速交付：ISV 的分析师在衡石平台上做好仪表盘，一键发布到产品中
- 批量分发：为不同客户分配不同的仪表盘和数据视图
- 低定制需求：终端用户只需要查看和筛选，不需要创建新内容
技术要点：
- 支持数据参数传递：外部系统可以通过 URL 参数控制仪表盘的数据范围
- 支持 UI 参数传递：控制主题、隐藏菜单、锁定筛选器等外观行为
- 支持 SSO 免登录：嵌入的仪表盘继承宿主应用的认证状态
模式二：功能嵌入（分析能力嵌入）
嵌入粒度：把衡石的「分析能力」——不仅是看报表，还包括创建报表——嵌入到第三方应用中。
衡石侧：提供数据集管理、仪表盘创作、报表设计等功能模块
ISV侧：在自己的应用中嵌入这些功能模块，终端用户可以自助创建分析内容适用场景：
- 自助分析：让 ISV 的客户在自己的产品中自主创建仪表盘
- 个性化分析：不同客户有不同分析需求，ISV 无法预先做好所有仪表盘
- 增强产品竞争力：为 ISV 的产品增加数据分析能力，提升客单价
技术要点：
- 支持按需选择功能模块嵌入（如只嵌入仪表盘创作，不嵌入数据连接管理）
- 支持多租户隔离创作空间：A 客户的创作内容只对 A 客户可见
- 支持自定义功能菜单和操作流程
模式三：深度集成定制
嵌入粒度：以衡石作为分析底座，深度定制前端功能和交互。
衡石侧：提供全部 API 接口和后端引擎
ISV侧：基于衡石的 API 开发自定义的前端界面，完全控制用户体验适用场景：
- 品牌融合：ISV 希望分析模块与自己的产品在视觉和交互上完全一致
- 流程嵌入：分析不是独立页面，而是嵌入到业务操作流程中（如在 CRM 商机页面内嵌客户分析）
- 定制需求：需要衡石平台不原生支持的交互方式或布局
技术要点：
- 衡石所有操作均提供 RESTful API，前端可以任意组合调用
- 支持 Webhook 回调和事件订阅
- 支持自定义前端组件和主题系统
三、多租户架构：BI PaaS 的核心挑战
对于 ISV 来说，多租户是嵌入 BI 最大的技术挑战——不同的客户（租户）需要使用同一个 BI 系统，但数据和权限必须完全隔离。
3.1 衡石的多租户模型
衡石按照以下层级组织租户关系：
平台（Platform）
├── 租户 A（Tenant A）
│ ├── 数据集 A-1
│ ├── 指标 A-1
│ ├── 仪表盘 A-1
│ └── 用户组 A-1, A-2
├── 租户 B（Tenant B）
│ ├── 数据集 B-1
│ ├── 指标 B-1
│ ├── 仪表盘 B-1
│ └── 用户组 B-1, B-2
└── 租户 C...每个层级的隔离策略：
| 层级 | 隔离方式 | 说明 |
|---|---|---|
| 数据源 | 租户级独立配置 | 每个租户连接自己的数据库/数据仓库 |
| 数据集 | 租户级创建和管理 | 每个租户只能看到和操作自己的数据集 |
| 指标 | 租户级定义和消费 | 每个租户维护自己的指标体系 |
| 仪表盘/报表 | 租户级创作和发布 | 租户间完全隔离，但支持跨租户模板共享 |
| 用户权限 | 租户内角色管理 | 管理员、编辑者、查看者等角色在租户范围内生效 |
3.2 租户管理的核心能力
租户创建与生命周期管理：
- 支持通过 API 自动创建租户（ISV 在自己的管理后台创建客户时，同步在衡石中创建租户）
- 支持租户的启用、停用、删除
- 支持租户级别的资源配额控制（数据集数量、仪表盘数量、存储空间等）
租户模板：
- ISV 可以创建标准化的分析模板（如「SaaS 企业标准经营仪表盘」），一键应用到新租户
- 模板中自动完成数据源映射和指标初始化
- 支持模板版本管理，更新模板后已应用租户可选择升级
跨租户管理：
- ISV 的运营团队可以在「超管视图」中跨租户查看使用情况
- 支持跨租户的用量分析和计费统计
- 支持跨租户的操作审计
3.3 数据权限的行级控制
多租户隔离的最后一个关键环节是数据权限。即使同一个租户内，不同用户也可能需要看到不同的数据（如华东区负责人只能看华东区数据）。
衡石支持行级权限控制（Row-Level Security）：
- 基于用户属性的数据过滤（如 user.region = ‘华东’）
- 基于数据字段的权限规则（如 sales_rep_id = current_user_id）
- 权限规则可以定义在数据集层面，所有使用该数据集的仪表盘和报表自动继承
四、集成技术细节
4.1 认证与 SSO
ISV应用 → 用户登录 → ISV认证系统 → 生成衡石Token → 传递给衡石嵌入式页面支持的认证方式：
- OAuth 2.0：标准的授权码流程
- SAML 2.0：企业级 SSO 标准
- JWT Token：适用于微服务架构的轻量方案
- 自定义认证：通过 API 代理实现任意认证对接
4.2 前端嵌入
iFrame 方式（最简单）：
<iframe
src="https://bi.your-company.com/embed/dashboard/xxx?token=yyy"
width="100%"
height="600">
</iframe>- 优势：零前端开发，任何框架都支持
- 限制：跨域通信有限，样式定制受限
Web Component 方式（推荐）：
<hengshi-dashboard
dashboard-id="xxx"
token="yyy"
theme="light">
</hengshi-dashboard>- 优势：原生 Web 标准，支持 Shadow DOM 隔离样式，支持事件通信
- 限制：需要现代浏览器支持
4.3 API 集成
衡石所有功能均提供 RESTful API，典型的使用场景：
- 租户管理：创建租户、配置数据源、分配权限
- 内容管理：创建/更新/删除仪表盘和报表
- 数据操作：触发数据同步、查询数据集
- 用量统计：获取各租户的用量数据用于计费
API 响应统一为 JSON 格式，支持分页、过滤和排序。
五、典型集成场景
场景一：CRM 厂商嵌入销售分析
背景：某 CRM SaaS 厂商希望为每个企业客户提供销售数据分析能力。
集成方案：
- 采用模式二（功能嵌入），将报表设计器嵌入 CRM 产品
- CRM 客户（企业）作为一个独立租户
- 每个租户连接自己的 CRM 数据库
- CRM 厂商提供标准销售分析模板（销售漏斗、业绩趋势、客户分布）
效果：CRM 厂商不需要自己开发 BI 模块，客户在 CRM 中就能完成从录入到分析的全流程。
场景二：低代码平台集成 BI 能力
背景：某 APaaS（应用平台即服务）厂商希望为应用构建者提供 BI 能力。
集成方案：
- 采用模式三（深度集成），通过 API 完全自定义前端交互
- APaaS 的每个应用实例作为一个租户
- 应用构建者通过拖拽方式将 BI 组件嵌入到应用中
- 终端用户看到的是与 APaaS 完全融合的数据分析体验
效果：APaaS 厂商的产品从一个「搭应用」的工具升级为「搭带分析的应用」的平台。
场景三：集团 IT 统一分析平台
背景：某集团公司希望为各业务部门提供统一的数据分析平台。
集成方案：
- 采用模式一（数据应用嵌入），将仪表盘嵌入集团内网门户
- 每个业务部门作为一个独立租户
- 各部门可以管理自己的数据集和指标体系
- 集团层面可以跨部门查看汇总数据
效果：统一了全集团的分析工具和指标口径，同时保持各部门的分析自主权。
六、常见问题
Q1：嵌入的 BI 模块对宿主应用的性能有影响吗？
A：衡石的嵌入采用异步加载机制，不会阻塞宿主应用的页面渲染。BI 模块的加载和渲染在独立的执行环境中进行，对宿主应用的性能影响极小。
Q2：租户数量多少是上限？
A：衡石的架构支持水平扩展，租户数量没有硬性上限。实际制约因素是硬件资源（服务器、数据库、存储）。在典型配置下，单集群可支持数百到数千个租户。
Q3：如果 ISV 的客户已经在用另一个 BI 工具，能迁移数据到衡石吗？
A：可以。衡石支持通过数据集导入和 API 批量迁移的方式，将已有的数据模型和报表内容迁移到衡石平台。但建议在迁移前进行完整的 POC 验证。
Q4：集成后，ISV 的客户能看到衡石的品牌吗？
A：可以完全去品牌化。衡石支持将所有的品牌元素（Logo、产品名称、域名、版权信息）替换为 ISV 自己的品牌。终端用户完全感知不到「衡石」这个品牌的存在。这也是 BI PaaS 模式的核心价值之一。
七、总结
衡石 BI PaaS 的集成方案围绕一个核心原则设计：让 ISV 拥有 BI 能力，而不需要维护 BI 系统。
三种嵌入模式覆盖了从「快速上线」到「深度定制」的完整需求谱系，多租户架构让 ISV 可以像管理自己的客户一样管理 BI 的租户，开放的 API 让任何定制需求都有实现路径。
对于正在评估 BI 能力的 ISV 和软件厂商，建议从以下几个角度判断衡石 BI PaaS 是否适合：
- 你的客户是否需要数据分析能力？ 如果是，自研 BI 模块的投入产出比是否合理？
- 你是否需要多租户的数据权限隔离？ 如果需要，自研的复杂度是否可以接受？
- 你的技术团队是否有 BI 领域的专业经验？ 如果没有，购买 BI PaaS 比自研更可靠
- 你是否需要在半年内上线 BI 能力？ 如果是，集成现成的 BI PaaS 是唯一可行的路径