singl及相关使用方法.pdfVIP

1.singl 使用方法( 本文中所有例子均以 mainacctinfo 表为例) cd $HOME/script singl tablename subid(2 位) 例： 输入 Y 或者 y 进行库表重建 Oralce 数据库使用sqlldr 进行数据导入，故使用crtctl tablename 生成ctl 文件 crtctl 的使用见第五章 输入Y 或者 y 将生成的SQC 文件移植到相关目录下, 目录规则： $HOME/project/subid/dbapi 输入Y 或者y ，在移植目录下进行编译（新的库表结构对应的dbxxyyyy.SQC 需手工在移植目录makefile 中添加编译相关）。 2.建表脚本说明 建表脚本模版为crtdb.txt ，模版中的 N.N 代表not null（非空）字段的含义 。通过crtdb.txt 模版中定义的表名，最终产生的建表语句为tablename.sql 模版头的含义 其中表名(tablename)必须填入，dbcm0301 也就是生成SQC 的名称，全系统不能重复（必 须填入） 字段类型为char ： 字段类型为int 或long 字段类型为date 建表脚本中的date 型不同于数据库的date 型，脚本中的date 只是为了方便开 发人员对该字段类型的区分，在数据库实际建表时，将date 转换为char (10) 作为该字段实际类型和长度。 字段类型为dec 建表脚本中的dec 在实际建表语句中，转换为DECIMAL。17，2 的含义为：长度为17 位（包 含小数点），小数点后为2 位 索引的生成 生成的索引名称为tablename_IDX ，此处的tablename 会自动截取表名的前13 位，故在使用 时注意避免定义相似的表名。唯一索引使用 unique 作为前缀进行定义，索引字段按照“, ” 进行分割，索引按照顺序生成，支持多唯一索引。 3.tablename.h 说明 tablename.h 生成在$HOME/include/dbase 下面，下面以mainacctinfo.h 作为说明举例： 静态宿主变量的声明 结构的声明（TBL_MAINACCTINFO ） 相关宏定义 R_MAINACCTINFO R_的宏定义用于将全表数据查询回来后 INTO 到该宏定义中，使用该宏定义前一定要使用 cmInitTablename()宏进行初始化，例： U_MAINACCTINFO 该宏定义的使用方法为:不再使用SELECT * INTO，替换为SELECT U_MAINACCTINFO INTO ，以 便查询效率的提升。 W_MAINACCTINFO UW_MAINACCTINFO PACKALL_MAINACCTINFO cmInitMainacctinfo() cmStoVMainacctinfo(x) x 对应 TBL_MAINACCTINFO 的声明结构或结构指针，StoV 函数将 X 的字段值赋值给 tablename_flds cmVtoSMainacctinfo(x) x 对应TBL_MAINACCTINFO 的声明结构或结构指针，VtoS 函数将tablename_flds 的值赋值给 X 的字段值 4.dbxxyyyy.SQC 说明 for update 游标的声明 get_tablename_flds 原型 set_tablename_flds 原型 cmReadMainacctinfo 通过唯一索引，将表的数据读取出并赋值给结构，使用时一定注意：函数是通过唯一索引读 取数据，故唯一索引必须有值且正确。 注：如果建表脚本中该表有多个唯一索引，会按照索引的先后顺序生成 cmReadTablename_2;cmReadTablename_3 等函数，用法相同。 cmModiMainacctinfo 以唯一索引为where 条件，将结构全部字段的值更新到数据库中。 cmInstMainacctinfo 将结构字段值插入数据库表中。 cmOpenMainacctinfo cmCloseMainacctinfo cmFetchMainacctinfo 将游标fetch 出的数据拷贝到结构中。 cmReadMainacctinfoForUpd 以for update 的形式读取数据库记录并将值拷贝到结构中。 cmTracMainac