银行CognosTransformer模型开发手册

1、银行银行银行银行 CognosCognosCognos TransformerTransformerTransformer 模型开模型开模型开模型开 发手册发手册发手册发手册 修改记录修改记录 编号日期描述 版本作者审核发布日期 1 2007 -07- 01 初稿 V1.0 RTAO Team 2 目录目录 1.前言.3 1.1.编写目的3 1.2.参考文档3 1.3.预期读者3 1.4.术语定义3 2.POWERPLAY TRANSFORMER 模型开发手册.4 2.1.PowerPlay Transformer 功能简介 4 2.2.Transformer 界面简介4 2.3.建立模型设计

2、的方法5 2.4.制作 IQD 文件6 2.5.建立多维模型8 2.5.1.定义数据源连接8 2.5.2.添加数据源9 2.5.3.添加 MEASURE度量11 2.5.4.建立层次维11 2.6.模型的一些属性说明和设置14 2.6.1.NUMERIC型 COLUMN的设置14 2.6.2.ROLLUP设置16 2.6.3.设置数值的格式16 2.6.4.添加 CUBE文件17 2.6.5.维度内容显示配置19 2.7.运行模型生成 Cube 20 2.8.Cube 的权限设置 21 2.8.1.导入角色21 2.8.2.权限设计23 2.9.Cube 增量更新 25 2.10. 模型打包发

3、布25 1. 前言前言 1.1. 编编写写目目的的 中国银行 Cognos Transformer 模型开发手册是 Cognos Transformer 模型设计的操作手册，包括了 Transformer 模型设计的基本方法和一些使用技巧， 为建行 Cognos Transformer 模型开发和设计人员提供参考和指导。 1.2. 参参考考文文档档 中国银行 Cognos 报表开发交付规范 Cognos 的帮助文档 1.3. 预预期期读读者者 Transformer 模型设计人员 Transformer 模型开发人员 1.4. 术术语语定定义义 2. PowerPlay Transformer

4、 模型开发手册模型开发手册 2.1. PowerPlay Transformer 功功能能简简介介 PowerPlay Transformer（以下简称 Transformer）是 Cognos8 中一个重要的 组件，也是一个 OLAP 服务器，主要用来创建模型，帮助你组织数据，将不同 数据源的数据整合到 PowerCube 当中，形成多维数据源。而根据生成好的 PowerCube 模型，Analysis Studio 便可在此基础上各种报表，比较数据和发现业 务发展趋势。 Transfomer 模型能够帮助将数据从各种数据源组织进多维的 PowerCube 中， 创建能够比较数据和发现趋势的

5、报表。在用 Transfomer 建立模型之前，首先要 评测数据，以及确定如何构造它们，以使它们能够支持业务分析的类型；然后 用 Transfomer 构造创建数据的模型；最后生成一个 PowerCube，让用户通过 Analysis Studio 直接查看和应用其中的数据。 2.2. Transformer 界界面面简简介介 Transformer 界面包括以下四个基本窗格： 数据源(Data Sources)窗格 数据源窗格的作用是将数据集成到模型中来。根据模型设计文档，从能够 支持应用的数据仓库及数据库中确定要查询哪些数据，并将它们加载进数据源 窗格。然后再将数据源窗格的数据用于建立维度

6、图，并创建 PowerCube。 在数据源窗格中可以有一个或多个数据源，每个数据源来自于一个数据源 文件 (例如.iqd 等) ，每个数据源都有自己的数据源名。每个数据源由构成它的 若干列(Columns)组成。这是做模型的原始基本素材。 数据源窗格中列的数据类型： 打开列的属性(双击列名)-General标签页-Data class 如果数据源不是来源于.iqd，则它的列的数据类型开始为Unspecified(未指 定)。 维度图（Dimension Map）窗格 维度图窗格是一个用于建立多维立方体结构的工作区。根据数据源中的文 本数据，各个维度以及每个维度下层的设定在此组织 (维度和层)。

7、最底层要对 应数据源窗格中的一个列。 度量（Measures）窗格 度量窗格用于建立和显示模型所需要的度量。度量值是在 PowerPlay 报表单 元中可视的数据。根据模型设计文档，定义应用中需要的度量。模型中至少要 有一个度量，度量与维度的最底一层关联。每个标准度量要在数据源中对应有 一个列 (计算度量除外)。 PowerCube 窗格 PowerCube 窗格显示用模型创建的 PowerCube。 2.3. 建建立立模模型型设设计计的的方方法法 建立模型设计时，应首先选择度量，然后选择能够支持度量的维度和层。 作模型设计时，选好要说明的业务领域： 1)选定能够说明业务领域关键成功因素的度量

8、指标； 2)确定能够准确地反映数据等级结构的层。为了使应用导航比较快速和易 于操作，尽量保持每个维度中的层数不超过 5 层。 3)选择的维度与度量要匹配。推荐维度数尽量保持在 57 个，因为较少的 维度可以使得应用几乎更直观和易于使用。 在生成 PowerCube 前，在 Transfomer 模型中必须完成： 1)集成数据源数据 2)建立维度图 3)定义需求的度量 建立模型的一般流程： 2.4. 制制作作 IQD 文文件件 IQD 文件用于在多维模型中组织数据源，实际的作用就是将所需要的维表 和事实表从数据库中读出来，成为生成 Cube 的数据来源。 根据以往的经验，虽然 IQD 文件中可以

9、手写较为复杂的 SQL 语句，但如 果是事实表 IQD 不建议这样做，IQD 文件中最好只有简单的 SELECT 语句，这 样不至于影响效率。 可以通过一个 IQD 的模版手工编写 IDQ 文件： 制作 IQD 文件 建立多维模型 运行模型生成 CUBE 模型打包发布 a)第 1、2 行是固定语句 b)第 3 行指明了到数据库的逻辑连接名 c)第 4 行实际是表名 d)从第 5 行到第 8 行是 IQD 中的查询语句主体 e)从第 9 行到结束是对查询出来的每个字段的申明 以上皆为固定格式 也可通过 Framework 生成 IQD 文件，避免手写的劳动。由软件自动完成， 可以避免出错的可能性

10、： 1、首先把查询对象的属性修改成 iqd 2、然后发布模型时把下面的选项的勾打上，并且设置好存放 iqd 脚本的路径 如下图： 2.5. 建建立立多多维维模模型型 2.5.1. 定义数据源连接定义数据源连接 使用 IQD 作为多维模型的数据源首先要在 Cognos 安装路径下的 Cognos.ini 文件中正确定义到数据库的连接，连接字符串可以从 Cognos 的 Portal 上获得。 打开 Cognos.ini（Cognos cs7g.ini）文件，在文件内容后面添加逻辑数据源 名称及”=”符号，然后把连接字符串拷入。 2.5.2. 添加数据源添加数据源 配置好数据源连接后，添加 IQD

11、 文件作为多维模型的数据源：点击菜单 上的“NEW”按钮新建一个模型，输入模型名称和数据源名称后，在“Data source type”中选择“Impromptu query definition” ，即 IQD 类型。 接着输入 IQD 的文件目录和名称。 所添加的 IQD 文件，通常可以分为维表 IQD 和事实表 IQD： 维表 IQD 实际上就是对维表的查询语句，用来建立多维模型的维度， 实际上就是搭出多维模型的架子。 事实表 IQD 给出的就是多维模型中最细粒度的数据，实际上就是给多 维模型中的 Measures 提供数值。 目前已经在实践中证明最不易出问题的做法就是：在维表中进行逐级

12、分层， 在事实表中给出维表中最细一层的明细数据，以事实表自动关联维表的最底层 来生成 Cube。 此种开发，生成 Cube 的效率瓶颈主要会出现在事实表数据的生成阶段，因 为事实表要满足多维模型的话就必须给出模型中所有维度的最明细数据，这需 进行一系列数据抽取以及转换的过程。生成事实表所消耗的时间取决于数据量 的大小和进行数据抽取转换运算的复杂程度。 然后点击下一步，在弹出的框中要求输入数据库的登录用户名和密码。最 后点击完成。 添加 IQD 文件作为数据源后，双击 IQD 中的列便可以看到列的属性 2.5.3. 添加添加 Measure 度量度量 直接将事实表 IQD 中的度量拖到“Meas

13、ure”窗格。多维模型中的 Measure 就来源于事实表 IQD 中的 Numeric 型 Column。 维表和事实表在多维模型中能够自动正确关联的保证：维表的最低层字 段名和事实表的维度字段名一致，事实表IQD放在所有维表IQD之后。 2.5.4. 建立层次维建立层次维 导入数据源和建立好度量后，建立模型的层次维：将数据源窗格中维表的 字段拖到维度图窗格，以机构为例，先将一级编码拖到维度图窗格的阴影部分， 再将二级编码拖到一级编码的先面，如此类推，从高层次到低层次往下拖。最 后便生成一个层次结构的维。 对于日期维，把事实表中的日期字段直接拖入维度图窗格，Transformer 会 自动生

14、成一个层次结构的维。 拖入之后我们看到自动生成的层次维最小到月，可以右键点击自动生成的 日期维，选择其中的“Insert Level“添加日层次，在弹出的框的“source”中点 击 source 的 Data source type，在弹出的框中选择事实表的日期字段，点击确定。 然后在“Time”的日期函数中我们选择“day” 。 最后点击确定。可以看到日的层次便生成了。 2.6. 模模型型的的一一些些属属性性说说明明和和设设置置 2.6.1. Numeric 型型 Column 的设置的设置 对空值的特殊设置：如果原数据库中数据为空或者纬度组合所对应的数据 为空，通过设置 missing

15、value 可以选择显示为空或者为0： 数值输出倍数及精度设置： 之所以会有数值输出倍数及精度设置有如下原因： Cube 生成中由于整型数据的运算效率比浮点型要高，所以输入数值会被根 据其小数位数自动进行放大为整数，而作为运算结果输入到 Cube 时则会被恢复 回原来的值，也就是缩小相应的倍数，OutputScale=2，就是乘以 0.01，Precision=2 就是精确到小数点后两位。 对于 Numeric 型 Column 的聚合运算：根据度量的业务含义进行控制，如果 度量是按时间维度进行聚合的话如余额度量，就要在 time state rollup 中配置 “last priod”。如

16、果是发生额就要在 regular rollup 中选择 deflautsum： 2.6.2. Rollup 设置设置 Regular rollup：用于定义在普通维度上进行聚合的运算。 Time State rollup：用于定义在时间维度上的聚合运算，如果选择 none（regular rollup）则在时间维度上是汇总。 2.6.3. 设置数值的格式设置数值的格式 对数据的显示格式进行设置。 2.6.4. 添加添加 Cube 文件文件 右键点击 Powercube 窗格，选择“Insert PowerCube” 。 添加 Cube 文件后的主要设置：选择 cube 文件在本地保存的路径 如

17、果是在本地生成 cube，要在 processing 里面选择“locally” ；如果 cube 是 要在服务器上生成的话，就要选择“on the server” 。 增量更新 Cube 需要的额外设置：在插入 cube 后，要在 cubegroup 里面配置 dimension 及 level 进行自动关联所需要的配置Unique： 注意：我们在维属性框里可以看到（上图） ，Source表示该层次的来源， 一般选择ID号。这里还有个Label标签，我们选择该ID对应的 name，作为显示时的名字。 2.6.5. 维度内容显示配置维度内容显示配置 选择 always include 表示在生

18、成 cube 的时候，事实表和纬表里面的纬度数 据都会存在。选择 when needed 表示只有事实表里面纬度存在的数据在生成 cube 的时候才会存在。 2.7. 运运行行模模型型生生成成Cube 在 Windows 客户端上生成 Cube： 在 UNIX 系统上生成 Cube 的命令： Rsserver c m cubename.mdl Rsserver c p cubename.pyi 在 UNIX 系统上将 MDL 文件转换为 PYI 的命令： Rsserver m cubename.mdl s cubename.pyi（增量更新的 cube 需要将模型 装换成 pyi 格式，才能正

19、常进行更新。因为在 unix 增量更新的过程中系统会自 动打上时间戳，mdl 不支持，pyi 支持） 在UNIX下，建议使用PYI文件来生成Cube，因为PYI是编译过的模 型文件，打开较快，另外，生成Cube过程中，维度中的内容会被保留 到模型文件中，对于要保留历史维度信息的模型文件就需要这么做。而 mdl在unix因为只能做全量更新，所以无法保留历史数据 为了能够在 UNIX 服务器上正常运行模型文件生成 Cube，需要早用户配置 文件中添加的变量： #PPES COGNOS_HOME=/home/cognos81/cer4/bin;export COGNOS_HOME #MDC 生成路径

20、 ModelWorkDirectory=/home/cognos81/report/mdlwork;export ModelWorkDirectory DataSourceDirectory=/home/cognos81/report/iqd;export DataSourceDirectory DataWorkDirectory=/home/cognos81/report/temp;export DataWorkDirectory CubeSaveDirectory=/home/cognos81/report/mdc;export CubeSaveDirectory ModelSaveDirectory=/home/cognos81/report/mdl;export ModelSaveDirectory Log Log LogDetailLevel=4;export LogDetailLevel 2.8. Cube 的的权权限限设设置置 Cube 或者报表都需要进行权限的设置。Cube 的权限配置步骤如下： 2.8.1. 导入角色导入角色 1、 点击 powerpyay transformer 的 file 后选择 model properties。如下图： 2、