数据仓库编程规范.doc

数据仓库编程规范文档 版本号：V1.0 文档名称：数据仓库编程规范文档 (1.0).doc 文档编号： 文档修订号： 文档建立日期： 2009-2-28 电子版文件名： 未经允许，不可全部或部分发表、复制、使用于任何目的 文档修订摘要 日期 修订号 描述 著者 审阅者 批准人/日期 引言 编写目的 编写《数据仓库开发规范（dbsql系统）（1.0）》的目的是： dbsql封装了访问db2,oracle,greenplum,Sybase 和Teradata数据库的方法，形成了一套访问db2,oracle,greenplum,sybase和Teradata数据库的统一接口。dbsql不仅提供了对db2,oracle,greenplum,sybase和Teradata访问方法的统一，而且提供了一些方法屏蔽5个数据库之间sql语言的差别。这样对于应用程序，只需要编写一套代码，就可以操纵db2,oraclee,greenplum,sybase和Teradata数据库,对开发工程师而言，只用熟悉sql92的标准sql和此文档sql函数就 本文档供以下相关人员阅览： 参于数据仓库设计评审的专家人员； 参与数据仓库软件开发的软件部人员； 参与数据分析系统测试人员。 背景介绍 开发的软件系统的名称：数据仓库编程规范 开发单位：数据分析部 系统使用单位： 该软件系统是数据仓库底层开发跨平台异构数据仓库的基础平台 术语定义 参考资料 参考资料共包括： 《Tcl/Tk 编程权威指南》 《Expert One on One: Oracle》 《Oracle 数据库DBA专题技术精粹 环境变量 主要环境变量设置包括： $DBSQL：程序安装点，开发时设置为个人目录。 $AGENTLOGDIR：Scehdule Server日志采集目录，通常设置为$DBSQL/log $AGENTTRACEDIR：日志及TRACE文件目录。（Schedule Server不采集，可用于存放调试信息） $TOOLS：存放tcl运行环境包及异构数据库编译的动态包安装目录。 用户可以在用户目录下创建.profile文件，例如： export HOME=/home/dw/dw export DBSQL=$HOME export AGENTLOGDIR=$DBSQL/log export AGENTTRACEDIR=$DBSQL/trace 开发与安装 开发时需要作如下设置： 将dss及_common.tcl复制到$DBSQL/bin下； 将_common.cfg复制到$DBSQL/etc下； 参照dwd_trade_base_ds.tcl开发各处理程序，有关dwd_trade_base_ds.tcl的详细说明参见具体例子； 如需要专用配置文件则在$DBSQL/etc下创建rootname.cfg文件，专用配置文件中允许覆盖公共配置项，但需要慎用。 执行方法（以dwd_trade_base_ds.tcl为例）： . /home/dw/.profile dss –s dwd_trade_base_ds.tcl –t–u 100 –v 200 -o 注意： $DBSQL在安装时被定义为安装点路径，因此，每个用户需要在开发时把该变量定义到自己的开发目录下。 dss、_common.tcl为公用程序，common.cfg为公共配置，均不得进行修改。 DBsql编程规范 注释 在每一个tcl源文件头部都要加上关于本文件的注释，列出：文件名、功能描述、作者、生成日期、修改日志、版权说明等。建议采用如下格式： #******************************************************************* # ** 文件名称： # ** 功能描述： # ** 创建者： # ** 创建日期： # ** 修改日志： # ** 修改日期 修改人 修改内容 # ** --------------------------------------------------------------- # ** # ** Copyright(c) 2009 .com Co.,Ltd ( # ** All Rights Reserved. #******************************************************************** 元数据注释信息 ###METADATA_BEGIN*******************************************