otl使用指南.doc

OTL使用指南 广州从兴电子开发有限公司 文档修改历史 日期 版本 作者 修改内容 评审号 变更控制号 发布日期 2007-9-14 0.1 佘彪 初稿 2007-9-18 0.2 佘彪 根据9月17日上午周例会上陈彰的要求，增加编程实践相关的内容，主要通过总结OCS租费开发中OTL的使用经验，整理出13章最佳实践。 2007-11-8 0.3 佘彪 增加13.3小节与开源项目ORAPP的性能对比 目 录 1 OTL简介 5 2 编译OTL 5 3 基本使用 5 4 OTL流的概念 14 5 主要类及方法说明 15 4.1 otl_stream的主要方法 16 4.2 otl_connect的主要方法 19 6 SQL的变量绑定和常量SQL 22 6.1 SQL的变量绑定 22 6.2 常量SQL 25 7迭代器 25 7.1 OTL流的读迭代器 25 7.2 STL兼容的迭代器 29 8 资源池 33 8.1 连接缓冲池 33 8.2 OTL流缓冲池 37 9 操作大型对象 44 9.1大型对象的存储 44 9.1.1 otl_long_string 44 9.1.2 otl_long_unicode_string 45 9.2 大型对象的读写 45 10国际化 50 10.1 使用UNICODE字符串 50 10.2 使用UTF8字符串 54 11 Reference Cursor流 58 12 杂项 62 12.1 使用otl_nocommit_stream避免SQL执行成功后立刻提交事务 62 12.2 SELECT中的数据类型映射覆写 65 12.3 使用OTL tracing跟踪OTL的方法调用 69 12.4 获取已处理行数(Rows Processed Count) 76 12.5 使用otl_connect的重载运算符, =, 78 12.6 手工刷新otl_stream缓冲区 82 12.7 忽略INSERT操作时的重复键异常 87 12.8 使用模板otl_valueT创建数据容器 91 12.9 使用OTL流的读迭代器遍历流返回的Reference Cursor 94 12.10使用Reference Cursor流从存储过程中返回多个Referece Cursor 98 13 最佳实践 103 13.1流缓冲区大小的设置 103 13.2批量操作注意的问题 106 13.3与开源项目ORAPP的性能对比 107 1 OTL简介 OTL 是 Oracle, Odbc and DB2-CLI Template Library 的缩写，是一个C++编译中操控关系数据库的模板库，它目前几乎支持当前所有的各种主流数据库，例如Oracle, MS SQL Server, Sybase, Informix, MySQL, DB2, Interbase / Firebird, PostgreSQL, SQLite, SAP/DB, TimesTen, MS ACCESS等等。 OTL中直接操作Oracle主要是通过Oracle提供的OCI接口进行，操作DB2数据库则是通过CLI接口进行，至于MS的数据库和其它一些数据库，OTL只提供了ODBC的操作方式。当然Oracle和DB2也可以由OTL间接使用ODBC的方式进行操纵。 在MS Windows and Unix 平台下，OTL目前支持的数据库版本主要有：Oracle 7 (直接使用 OCI7), Oracle 8 (直接使用 OCI8), Oracle 8i (直接使用OCI8i), Oracle 9i (直接使用OCI9i), Oracle 10g (直接使用OCI10g), DB2 (直接使用DB2 CLI), ODBC 3.x ,ODBC 2.5。目前OTL的最新版本为4.0，参见/，下载地址/otlv4_h.zip。 2 编译OTL OTL是一个集成库，它包含了一个模板流框架(template stream framework)以及适配OCI7, OCI8, OCI8i, OCI9i, OCI10g, ODBC 2.5, ODBC 3.x, DB2 CLI和Informix CLI的适配器(OTL-adapters)。编译时需要使用相应的宏定义向编译器指明底层数据库API的类型。例如，如果底层使用ORACLE10g的