NCV61-语义模型红皮书new.doc

商业分析平台 语义模型红皮书 版本：V6.1.0目 录 一、 前言 4 1. 概念 4 2. 定位 4 二、 结构 4 1. 应用模型 4 2. 语义模型 5 定义形态 5 执行流程 7 数据形态 7 3. 语义提供者 8 a) 接口 8 b) 扩展 10 4. 函数 14 a) 函数解析 14 b) 函数扩展 14 5. 参数 16 参数定义 17 参数引用 17 参数设置 17 参照依赖 17 自定义参照 18 6. 宏变量 19 7. 描述器 20 8. 数据加工 21 概念 21 定位 21 执行原理 21 使用 22 常见问题 24 9. 物化策略 24 10. 复合语义模型 25 11. 语义上下文 29 12. 脚本规则 29 三、 语义模型的管理 32 1. 对象管理 32 2. 环境配置 35 3. 导入导出 37 3.1 导出逻辑： 37 3.1.1 导出文件的规则 37 3.1.2 使用导出功能 37 3.2 导入逻辑： 39 3.2.1 导入的规则 39 3.2.2 使用导出功能 40 四、 功能扩展 42 1. 扩展语义提供者 42 2. 扩展业务函数 43 3. 使用数据加工 43 4. 自定义执行策略 43 5. 业务规则扩展 43 6. 元定义驱动扩展 44 五、 范例 47 1. 脚本中引用参数范例 47 六、 附录 51 1. 入门 51 2. 语义模型API 57 3. 语义函数 59 4. 其他函数 59 5. 脚本引擎 61 6. 针对查询引擎的改进 61 7. 性能监控 61 8. 多语言支持 63 8.1 全局宏变量 63 8.2 语义模型抽取多语 63 8.3 配置文件多语支持 63 前言 概念 SMART，即Semantic?Modeling?for?Analysis?Report?Toolkit ,?分析报表语义建模工具 结构 应用模型 上图为语义模型应用结构图。语义模型通过语义提供者，可以将多个数据源的数据进行整合。 语义模型 定义形态 下图展示了语义模型的内部结构， 语义模型主要由以下几部分构成： 元数据 元数据是指描述数据的数据，是为了外界使用数据而对数据本身含义的阐述。拿我们最常见的二维数据（行列结构）举例来说，如果只有这些行列结构的数据，对我们来说这将毫无意义。因为我们无法知道哪一列的数据代表什么含义，无法知道如何操作这些数据，更别提由这些数据分析出有用的信息。反过来，如果针对这些数据指定了元数据，我们就可以了解哪一列代表的业务含义，并且知道该列的数据类型、长度、精度 等。这样，我们就能对这些数据进行加工处理，分析提取出有价值的信息。 同理，语义模型的元数据是对执行语义模型后获取的二维数据的描述。元数据针对结果数据的每一列都提供了下列信息：数据类型、字段显示名、字段名、备注、长度、精度 等。有了这些信息，我们就能知道在业务应用中该如何使用语义模型。 语义提供者 语义提供者，表述了一类取数方式，或者说如何提供数据的方式。在语义模型中，语义提供者负责把一类业务取数过程以语义脚本的形式描述出来。 为了能更好的理解这个概念，我们可以打这样一个比方：NC元数据、数据仓库、报表数据、总账数据 等 这些可提供数据的对象好比“数据水源”，而语义提供者好比“水泵”，语义模型好比“抽水机”。每种“数据水源”只支持特定的“水泵”来抽取数据。我们有了一种语义提供者“水泵”，就能抽取其对应的“数据水源”里的数据。语义模型中能指定多个语义提供者，就相当于“抽水机”挂接了多个“水泵”，我们就能从多个不同类型的“数据水源”来抽取数据。 语义提供者负责抽取数据，同时对外提供元数据来描述这些数据。语义提供者的元数据一般是在语义模型内部使用。 更多细节以及语义提供者的扩展说明参见章节《语义提供者》。 描述器 描述器是指对数据操作的描述，例如：过滤、排序、分页、汇总 等。在语义模型中，描述器表述了对语义提供者抽取的数据的加工处理过程。 更多细节参见章节《描述器》。 首选项 语义模型中的首选项包括三类数据：参数、宏变量、配置项。下面将分别介绍： 参数 参数是模型中代表动态信息的元素,用于响应用户的输入。参数给用户提供了控制模型执行过程的机会。 更多细节参见章节《参数》。 宏变量 宏变量与参数类似，区别是，参数在模型执行时需要用户输入值；而宏变量不需要与用户交互，系统后台会根据上下文计算该值。 更多细节参见章节《宏变量》。 配置项 配置项用于控制语义模型的执行方式。 执行流程 语义模型的执行流程如下图所示： 语义模型执行过程可分为以下步骤： 第一步：语义模型脚本化 语义模型中的对象结构将转变为字符串形式的语义脚本。 第二步：脚本对象化 通过脚本引擎把语义脚本解析为脚本模型，即把字符