指标建模理论——指标、API与数据

1. 背景

指标建模工具是笔者大数据平台XSailboat中的一个模块，它对于一个大数据分析平台来说有重要的意义。在大数据分析平台上进行数据开发的一项重要产物就是统计计算结果，这其中很大一部分数据可以称之为指标数据。指标建模就是定义、梳理指标的工具。

它的主要功能有：

1. 定义指标。面向的是数据开发人员。
2. 自定义指标视图。面向的是最终用户。
3. 指标和API绑定。通过指标找数据，通过指标获取数据。
4. 提供指标数据的API契约及任务管理。指标建模工具可以是前期整理、分析、明确数据开发需求的工具。一项数据开发任务完成的重要标志是提供出了任务指标相关的API，通过API能获得符合契约要求的数据。
5. 通过指标看数据。如果指标建模工具上只能看到它的定义信息，而无法看到指标数据，将是一个非常大的缺憾。指标是线，指标数据是鱼钩上的鱼，拉起鱼线，另一段有鱼才好。这里的看数据不仅提供表格型数据，还应该可以提供自由切换类型的图表形式展示。我们大数据平台上的图表都是可分享的，可以分享给其它用户，也可以被其它web页面内嵌。
6. 将指标和数据开发过程关联起来，规范汇总层(DWS，Data Warehouse Summary)数据表的设计。将指标和数据表关联起来。因我们大数据平台主要是以数据服务API的形式对外提供数据，所以这里数据表跟指标定义关联，并不是发布目的，一方面是指导和约束开发流程及表模式，另一方面也是为了定位及结合血缘关系，更好地排查分析数据问题，另外的也得到了计算指标数据规模的基础条件。

2. 指标与API绑定

指标与API绑定分两种关系：
a. 约束绑定
b. 相关关联

一个指标只能有一个约束绑定，关联上一个API。这个API的参数名必须和指标的未限定维度名相同，类型兼容。而且返回格式亦有统一要求。维度包含显示名和名称，这里的名称必须符合数据库字段的命名规范，它也符合Java和REST API的参数命名要求。正因为有参数名和返回格式上的限制，才得以使得点击指标可以以表格形式和图表形式查看指标数据。关于指标返回数据的格式，见《指标建模概念和设计》

相关关联主要是用来方便查找指标相关的接口的。它对接口没有任何限制，只要任务某个接口提供的数据里面包含了这个指标的数据，就可以关联起来。因为指标数据不仅仅只有一种组织形式，很多时候会根据其它用户的需求，数据的自然特性，实现多个API，这些API也可能包含多个指标。