官方 Recipes 中文实战

这一部分基于 Cube 官方仓库里的 examples/recipes/ 示例，做中文化整理。

目标不是逐行翻译示例代码，而是帮你快速理解：

• 这个 recipe 解决什么问题；
• 它在 Cube 里用到了哪些关键机制；
• 你在自己的项目里该怎么迁移这个思路。

这一批收录了什么

分析建模

1. Active Users：滚动窗口活跃用户
2. Non-additivity：为什么有些指标很难预聚合

权限治理

3. Role-based Access：基于角色改写查询
4. Column-based Access：按列 / 关联条件控制可见范围
5. Mandatory Filters：强制附加过滤条件

数据源与多租户

6. Multiple Data Sources：按租户切换数据源
7. Using Different Schemas for Tenants：按租户切换模型目录

刷新与性能

8. Refreshing Select Partitions：只刷新需要更新的分区

怎么读最合适

• 如果你在做 指标建模：先看 Active Users 与 Non-additivity；
• 如果你在做 权限治理：先看 Role-based / Column-based / Mandatory Filters；
• 如果你在做 SaaS 多租户：先看 Multiple Data Sources 与 Tenant Schemas；
• 如果你在做 预聚合运维：看 Refreshing Select Partitions。

与官方示例的关系

这些内容都基于上游官方仓库中的 example recipes（核对日期：2026-05-22），并结合本教程主线重新组织。

一句话总结

这一部分的价值在于：把 Cube 官方零散 recipes 变成适合中文读者吸收的“问题 → 方案 → 迁移方法”实战索引。