银行Cognos Transformer模型开发手册

1、银银银银行行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开模型开 发发发发手册手册手册手册 第 1 页 共 30 页 修改修改记录记录 编号 日期描述 版本作者 审核发布日期 1 2007 -07- 01 初稿v1.0 rtao team 2 中国银行中国银行中国银行 cognoscognoscognos transformertransformertransformer 模型开发手册模型开发手册模型开发手册 第 2 页 共 30 页 目目录录 1.前言.3 1.1.编写目的3 1.2.参考文档3 1.3.预期

2、读者3 1.4.术语定义3 2.powerplay transformer 模型开发手册.4 2.1.powerplay transformer 功能简介 4 2.2.transformer 界面简介4 2.3.建立模型设计的方法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文

3、件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. 模型打包发布25 中国银行中国银行中国银行 cognoscognoscognos transformertransformertransformer 模型开发手册模型开发手册模型开发手册 第 3 页 共 30 页 1. 前言前言 1.1. 编编写写目目的的 中国银行 cognos transformer 模型开发手册是 cognos transformer 模 型设计的操作手册，包括

4、了 transformer 模型设计的基本方法和一些使用技巧， 为建行 cognos transformer 模型开发和设计人员提供参考和指导。 1.2. 参参考考文文档档 中国银行 cognos 报表开发交付规范 cognos 的帮助文档 1.3. 预预期期读读者者 transformer 模型设计人员 transformer 模型开发人员 1.4. 术术语语定定义义 中国银行中国银行中国银行 cognoscognoscognos transformertransformertransformer 模型开发手册模型开发手册模型开发手册 第 4 页 共 30 页 2. powerplay tr

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

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

7、据用于建立维度图，并创建 powercube。 在数据源窗格中可以有一个或多个数据源，每个数据源来自于一个数据源文 件 (例如.iqd 等) ，每个数据源都有自己的数据源名。每个数据源由构成它的若 干列(columns)组成。这是做模型的原始基本素材。 数据源窗格中列的数据类型： 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 5 页 共 30 页 打开列的属性(双击列名)-general标签页-data class 如果数据源不是来源于.iqd，则它的列的数据类型开始

8、为unspecified(未指定)。 维度图（dimension map）窗格 维度图窗格是一个用于建立多维立方体结构的工作区。根据数据源中的文本 数据，各个维度以及每个维度下层的设定在此组织 (维度和层)。最底层要对应数 据源窗格中的一个列。 度量（measures）窗格 度量窗格用于建立和显示模型所需要的度量。度量值是在 powerplay 报表单 元中可视的数据。根据模型设计文档，定义应用中需要的度量。模型中至少要有 一个度量，度量与维度的最底一层关联。每个标准度量要在数据源中对应有一个 列 (计算度量除外)。 powercube 窗格 powercube 窗格显示用模型创建的 powe

9、rcube。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 6 页 共 30 页 2.3. 建建立立模模型型设设计计的的方方法法 建立模型设计时，应首先选择度量，然后选择能够支持度量的维度和层。 作模型设计时，选好要说明的业务领域： 1)选定能够说明业务领域关键成功因素的度量指标； 2)确定能够准确地反映数据等级结构的层。为了使应用导航比较快速和易 于操作，尽量保持每个维度中的层数不超过 5 层。 3)选择的维度与度量要匹配。推荐维度数尽量保持在 57 个，因为较少的

10、 维度可以使得应用几乎更直观和易于使用。 在生成 powercube 前，在 transfomer 模型中必须完成： 1)集成数据源数据 2)建立维度图 3)定义需求的度量 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 7 页 共 30 页 建立模型的一般流程： 制作 iqd 文件 建立多维模型 运行模型生成 cube 模型打包发布 2.4. 制制作作 iqd 文文件件 iqd 文件用于在多维模型中组织数据源，实际的作用就是将所需要的维表 和事实表从数据库中读出来，成

11、为生成 cube 的数据来源。 根据以往的经验，虽然 iqd 文件中可以手写较为复杂的 sql 语句，但如果 是事实表 iqd 不建议这样做，iqd 文件中最好只有简单的 select 语句，这样 不至于影响效率。 可以通过一个 iqd 的模版手工编写 idq 文件： 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 8 页 共 30 页 a)第 1、2 行是固定语句 b)第 3 行指明了到数据库的逻辑连接名 c)第 4 行实际是表名 d)从第 5 行到第 8 行是 iq

12、d 中的查询语句主体 e)从第 9 行到结束是对查询出来的每个字段的申明 以上皆为固定格式 也可通过 framework 生成 iqd 文件，避免手写的劳动。由软件自动完成，可 以避免出错的可能性： 1、首先把查询对象的属性修改成 iqd 2、然后发布模型时把下面的选项的勾打上，并且设置好存放 iqd 脚本的路径如 下图： 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 9 页 共 30 页 2.5. 建建立立多多维维模模型型 2.5.1. 定定义义数据源数据源连连接接

13、 使用 iqd 作为多维模型的数据源首先要在 cognos 安装路径下的 cognos.ini 文件中正确定义到数据库的连接，连接字符串可以从 cognos 的 portal 上获得。 打开 cognos.ini（cognos cs7g.ini）文件，在文件内容后面添加逻辑数据源名称 及”=”符号，然后把连接字符串拷入。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 10 页 共 30 页 2.5.2. 添加数据源添加数据源 配置好数据源连接后，添加 iqd 文件作为

14、多维模型的数据源：点击菜单上 的“new”按钮新建一个模型，输入模型名称和数据源名称后，在“data source type”中选择“impromptu query definition”，即 iqd 类型。 接着输入 iqd 的文件目录和名称。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 11 页 共 30 页 所添加的 iqd 文件，通常可以分为维表 iqd 和事实表 iqd： 维表 iqd 实际上就是对维表的查询语句，用来建立多维模型的维度，实 际上就是搭出多

15、维模型的架子。 事实表 iqd 给出的就是多维模型中最细粒度的数据，实际上就是给多维 模型中的 measures 提供数值。 目前已经在实践中证明最不易出问题的做法就是：在维表中进行逐级分层， 在事实表中给出维表中最细一层的明细数据，以事实表自动关联维表的最底层 来生成 cube。 此种开发，生成 cube 的效率瓶颈主要会出现在事实表数据的生成阶段，因 为事实表要满足多维模型的话就必须给出模型中所有维度的最明细数据，这需 进行一系列数据抽取以及转换的过程。生成事实表所消耗的时间取决于数据量 的大小和进行数据抽取转换运算的复杂程度。 然后点击下一步，在弹出的框中要求输入数据库的登录用户名和密码

16、。最后 点击完成。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 12 页 共 30 页 添加 iqd 文件作为数据源后，双击 iqd 中的列便可以看到列的属性 2.5.3. 添加添加 measure 度量度量 直接将事实表 iqd 中的度量拖到“measure”窗格。多维模型中的 measure 就 来源于事实表 iqd 中的 numeric 型 column。 中国中国中国银银银行行行 cognoscognoscognos transformertransform

17、ertransformer 模型开模型开模型开发发发手册手册手册 第 13 页 共 30 页 维表和事实表在多维模型中能够自动正确关联的保证：维表的最低层字 段名和事实表的维度字段名一致，事实表iqd放在所有维表iqd之后。 2.5.4. 建立建立层层次次维维 导入数据源和建立好度量后，建立模型的层次维：将数据源窗格中维表的字 段拖到维度图窗格，以机构为例，先将一级编码拖到维度图窗格的阴影部分，再 将二级编码拖到一级编码的先面，如此类推，从高层次到低层次往下拖。最后便 生成一个层次结构的维。 中国中国中国银银银行行行 cognoscognoscognos transformertransfor

18、mertransformer 模型开模型开模型开发发发手册手册手册 第 14 页 共 30 页 对于日期维，把事实表中的日期字段直接拖入维度图窗格，transformer 会自 动生成一个层次结构的维。 拖入之后我们看到自动生成的层次维最小到月，可以右键点击自动生成的日 期维，选择其中的“insert level“添加日层次，在弹出的框的“source”中点击 source 的 data source type，在弹出的框中选择事实表的日期字段，点击确定。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开

19、模型开模型开发发发手册手册手册 第 15 页 共 30 页 然后在“time”的日期函数中我们选择“day”。 最后点击确定。可以看到日的层次便生成了。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 16 页 共 30 页 2.6. 模模型型的的一一些些属属性性说说明明和和设设置置 2.6.1. numeric 型型 column 的的设设置置 对空值的特殊设置：如果原数据库中数据为空或者纬度组合所对应的数据为 空，通过设置 missing value 可以选择显示为

20、空或者为0： 数值输出倍数及精度设置： 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 17 页 共 30 页 之所以会有数值输出倍数及精度设置有如下原因： cube 生成中由于整型数据的运算效率比浮点型要高，所以输入数值会被根 据其小数位数自动进行放大为整数，而作为运算结果输入到 cube 时则会被恢复 回原来的值，也就是缩小相应的倍数，outputscale=2，就是乘以 0.01，precision=2 就是精确到小数点后两位。 对于 numeric 型 colu

21、mn 的聚合运算：根据度量的业务含义进行控制，如果 度量是按时间维度进行聚合的话如余额度量，就要在 time state rollup 中配置 “last priod”。如果是发生额就要在 regular rollup 中选择 deflautsum： 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 18 页 共 30 页 2.6.2. rollup 设设置置 regular rollup：用于定义在普通维度上进行聚合的运算。 time state rollup：用于定义

22、在时间维度上的聚合运算，如果选择 none（regular rollup）则在时间维度上是汇总。 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 19 页 共 30 页 2.6.3. 设设置数置数值值的格式的格式 对数据的显示格式进行设置。 2.6.4. 添加添加 cube 文件文件 右键点击 powercube 窗格，选择“insert powercube”。 添加 cube 文件后的主要设置：选择 cube 文件在本地保存的路径 中国中国中国银银银行行行 cogno

23、scognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 20 页 共 30 页 如果是在本地生成 cube，要在 processing 里面选择“locally”；如果 cube 是要 在服务器上生成的话，就要选择“on the server”。 增量更新 cube 需要的额外设置：在插入 cube 后，要在 cubegroup 里面配置 dimension 及 level 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模

24、型开模型开发发发手册手册手册 第 21 页 共 30 页 进行自动关联所需要的配置unique： 注意：我们在维属性框里可以看到（上图），source表示该层次的来源，一 般选择id号。这里还有个label标签，我们选择该id对应的name，作 为显示时的名字。 2.6.5. 维维度内容度内容显显示配置示配置 选择 always include 表示在生成 cube 的时候，事实表和纬表里面的纬度数 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 22 页 共 30 页

25、 据都会存在。选择 when needed 表示只有事实表里面纬度存在的数据在生成 cube 的时候才会存在。 2.7. 运运行行模模型型生生成成 cube 在 windows 客户端上生成 cube： 在 unix 系统上生成 cube 的命令： rsserver c m cubename.mdl 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 23 页 共 30 页 rsserver c p cubename.pyi 在 unix 系统上将 mdl 文件转换为 py

26、i 的命令： rsserver m cubename.mdl s cubename.pyi（增量更新的 cube 需要将模型 装换成 pyi 格式，才能正常进行更新。因为在 unix 增量更新的过程中系统会自动 打上时间戳，mdl 不支持，pyi 支持） 在unix下，建议使用pyi文件来生成cube，因为pyi是编译过的模型 文件，打开较快，另外，生成cube过程中，维度中的内容会被保留到模 型文件中，对于要保留历史维度信息的模型文件就需要这么做。而mdl 在unix因为只能做全量更新，所以无法保留历史数据 为了能够在 unix 服务器上正常运行模型文件生成 cube，需要早用户配置 文件中

27、添加的变量： #ppes cognos_home=/home/cognos81/cer4/bin;export cognos_home #mdc 生成路径 modelworkdirectory=/home/cognos81/report/mdlwork;export modelworkdirectory datasourcedirectory=/home/cognos81/report/iqd;export datasourcedirectory dataworkdirectory=/home/cognos81/report/temp;export dataworkdirectory cube

28、savedirectory=/home/cognos81/report/mdc;export cubesavedirectory modelsavedirectory=/home/cognos81/report/mdl;export modelsavedirectory logfiledirectory=/home/cognos81/report/log;export logfiledirectory logdetaillevel=4;export logdetaillevel 中国中国中国银银银行行行 cognoscognoscognos transformertransformertran

29、sformer 模型开模型开模型开发发发手册手册手册 第 24 页 共 30 页 2.8. cube 的的权权限限设设置置 cube 或者报表都需要进行权限的设置。cube 的权限配置步骤如下： 2.8.1. 导导入角色入角色 1、 点击 powerpyay transformer 的 file 后选择 model properties。如下图： 2、 选择 authentication 后，选择认证的名称空间并且把下面的第一项打上钩。 如下图： 中国中国中国银银银行行行 cognoscognoscognos transformertransformertransformer 模型开模型开模型开发发发手册手册手册 第 25 页 共 30 页 3、 把角色从 user classes 对话框把角色拖到 cube 对话框。如下图： 2.8.2. 权权限限设计设计 我一般只需要对机