OTL技术应用

本文涉及的产品
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,集群版 2核4GB 100GB
推荐场景:
搭建个人博客
云数据库 RDS MySQL,高可用版 2核4GB 50GB
简介: 什么是OTL:OTL 是 Oracle, Odbc and DB2-CLI TemplateLibrary 的缩写,是一个操控关系数据库的C++模板库,它目前几乎支持所有的当前各种主流数据库,如下表所示: 数据库访问接口支持版本OracleOCI...
  • 什么是OTL:OTL 是 Oracle, Odbc and DB2-CLI TemplateLibrary 的缩写,是一个操控关系数据库的C++模板库,它目前几乎支持所有的当前各种主流数据库,如下表所示:
 

数据库

访问接口

支持版本

Oracle

OCI

OCI7、OCI8、OCI8i、OCI9i、OCI10g

DB2

CLI

DB2 CLI

MS SQL Server

、Sybase、Informix

、MySQL、 Interbase/Firebird、PostgreSQL、SQLite、SAP/DB、TimesTen、MS ACCESS

ODBC

ODBC2.5、ODBC3.x

 

Oracle和DB2也可以由OTL间接使用ODBC的方式来进行操纵。

OTL中直接操作Oracle主要是通过Oracle提供的OCI接口进行,依赖于Oracle客户端。 

OTL使用简单, 只要头文件中包含有: #include “otlv4.h” 就可,实际上整个OTL就一个“.H”的文件,使用起来极为的方便。

 

优点

(1).跨平台

(2).运行效率高,与C语言直接调用数据库API相当

(3).开发效率高,使用方便,繁在其内,简在其外,比

    ADO.net使用起来更简单,更简洁

(4).部署容易,不需要ADO组件,不需要.net

    framework 等

缺点

(1).只能在C++中使用

 

  • OTL的主要类

主要类包括:otl_stream、otl_connect、otl_exception

•otl_stream类

    otl_stream类是OTL“流”的概念的具体表现形式,任何通过输入/输出参数使用SQL语句、PL/SQL 块或者是存储过程调用,在C++的编程中都能通过otl_stream类来实现。

        其构造函数为:

   (1)for Oracle 7/8/9/10:

   otl_stream(const int arr_size, // 流的缓存大小

                      const char* sqlstm, // SQL语句或PL/SQL块或存储过程                     

                      otl_connect& db, // OTL数据库连接对象

                       const char* ref_cur_placeholder=0, // 游标引用占位符名称   

                       const char* sqlstm_label=0 // SQL 语句标签);

 

(2)forODBC/DB2-CLI:

  otl_stream(const int arr_size,// 流的缓存大小

           constchar* sqlstm,// SQL语句或PL/SQL块或存储过程                    

           otl_connect& db,// OTL数据库连接对象

            const int implicit_select=otl_explicit_select ,

            const char* sqlstm_label=0//SQL 语句标签);

  OTL流构造函数,负责创建otl_stream对象并调用open()(解析sql语句)方法。

  otl_stream的性能主要被缓冲区大小arr_size一个参数控制。缓冲区大小定义了插入表的逻辑行以及与数据库一次往反交互(one round-trip to the database)过程中从表或视图中查询的逻辑行。

(3)void set_commit(int auto_commit=0);

  设置流的auto_commit标志。默认情况下,该标志被置1,即当输出缓冲区刷新时,当前的事务被自动提交。

  注意流的auto_commit标志和数据库的自动提交模型没有任何关系。

(4)void set_flush(const bool auto_flush=true);

  设置auto_flush标志。默认情况下auto_flush的值为true, 即如果缓冲区出现脏数据则在流的析构函数中刷新缓冲区。如果自动刷新标志被关闭,则需要使用close()方法或者flush()方法对流进行刷新。

  注意该函数仅仅能够设置流的析构函数中是否自动刷新,并不是通常意义上的缓冲区刷新。

(5)voidflush(void);

  刷新流的输出缓冲区。当输出缓冲区被填满时,缓冲区将被自动刷新。如果流的auto_commit标志被置上,则在刷新完毕后当前事务被提交。

•otl_connect类

otl_connect类封装了一系列有关数据库连接的功能:建立连接、断开连接、事务提交、事务回滚等等。换言之,otl_connect是在C++编程中创建和使用数据库连接以及进行数据库事务管理的类,主要方法有:

(1)static int otl_initialize(const int threaded_mode=0);

该静态方法的主要功能是初始化OTL数据库环境,程序中第一次建立与数据库的连接之前,必须调用该方法一次,其后再建立与数据库的连接,就不需要调用该方法了。如果程序是在多线程环境下访问数据库,参数threaded_mode需置为1。另外在多线程环境下访问数据库,不要多个线程操作同一个otl_connect对象,除非该ot_connect对象有互斥锁机制。

 

 (2) otl_connect(const char* connect_str,const int auto_commit=0);

  连接数据库。参数同rlogon(),见(3)rlogon()

(3) void rlogon(const char* connect_str,const int auto_commit=0);

     该方法的主要功能是建立与数据库的连接。

     参数connect_str是数据库连接配置字符串,有两种表达形式

     o OTL4.0/OCIx

       ■”USER/PASSWORD”(本地数据库)

       ■”USER/PASSWORD@TNS_ALIAS”(远程数据库)

     o OTL4.0/ODBC和OTL4.0/DB2_CLI

       ■”USER/PASSWORD@DSN”

       ■”DSN=value;UID=value;PWD=value”

     参数auto_commit设置数据库事务的提交模式,auto_commit设置为1,表示数

 据库事务自动提交;auto_commit设置为0,表示数据库事务非自动提交,auto_commit

 缺省为0。

(4) void logoff(void);

  该方法的主要功能是断开与数据库的连接。

(5) void commit(void);

  该方法的主要功能是提交数据库事务。

(6) void rollback(void);

  该方法的主要功能是回滚数据库事务。

(7) void auto_commit_off(void); void auto_commit_on(void);

  设置otl_connect对象的auto_commit标志  

(8) long direct_exec(constchar *sqlstm,

  int ignore_error = otl_exception::enabled );

  直接执行静态(无绑定变量)的SQL语句 ,该函数返回处理的行数。-1:处理异常;>=0:在执行INSERT、DELETE或UPDATE语句时,实际返回的是已处理行数

•otl_exception类

       otl_exception类用于描述OTL操作数据时抛出的异常,有3个主要的成员变量:

       (1)unsignedchar msg[1000];

       该成员变量用于保存存异常的具体错误信息。

       (2)char stm_text[2048];

       该成员变量用于保存导致发生异常错误的SQL语句。

       (3)char var_info[256];

       该成员变量用于保存导致发生异常错误的输入/输出变量。

OTL使用起来也很简单,使用不同的数据库连接,主要是根据需要在程

序开始的宏定义来指定的。OTL是首先根据这个宏定义来初始化数据库

连接环境。OTL中用来区分连接方式的宏定义主要有下面这些:

OTL_ORA7,OTL_ORA8, OTL_ODBC, OTL_DB2_CLI, OTL_ODBC_MYSQL...

   不同的宏对应的数据库API,具体说明如下:

宏定义名

说明

OTL_ORA7

for OCI7

OTL_ORA8

for OCI8

OTL_ORA8I

for OCI8i

OTL_ORA9I

for OCI9i. All code that compiles and works under #define OTL_ORA7, OTL_ORA8, and OTL_ORA8I, should work when OTL_ORA9I is used

OTL_ORA10G

for OCI10g. All code that compiles and works  under #define OTL_ORA7, OTL_ORA8, OTL_ORA8I, OTL_ORA9I, should work with OTL_ORA10G.

OTL_ORA10G_R2

for OCI10g, Release 2 (Oracle 10.2). All code that compiles and works  under #define OTL_ORA7, OTL_ORA8, OTL_ORA8I, OTL_ORA9I, and OTL_ORA10G should work with OTL_ORA10G_R2

OTL_DB2_CLI

for DB2 Call Level Interface (CLI)

OTL_INFORMIX_CLI

for Informix Call Level Interface for Unix (when  OTL_ODBC_UNIX is enabled).

OTL_IODBC_BSD

for ODBC on BSD Unix, when iODBC package is used

OTL_ODBC

for ODBC

OTL_ODBC_MYSQL

for MyODBC/MySQL. The difference between OTL_ODBC_MYSQL and OTL_ODBC is that transactional ODBC function calls are turned off for OTL_ODBC_MYSQL, since MySQL does not have transactions

OTL_ODBC_

POSTGRESQL

for the PostgreSQL ODBC driver 3.5 (and higher) that are connected to PostgerSQL 7.4 / 8.0  (and higher)  servers.

OTL_ODBC_UNIX

for ODBC bridges in Unix

OTL_ODBC_zOS

for ODBC on IBM zOS.

OTL_ODBC_XTG_IBASE6

for Interbase 6.x via XTG Systems'  ODBC driver. The reason for introducing this #define is that the ODBC driver is the only Open Source ODBC driver for Interbase. Other drivers, like Easysoft's ODBC for Interbase, are commercial products, and it beats the purpose of using Interbase, as an Open Source.database server.

 

 

绑定变量

•示例:

  INSERT INTO my_table (employee_id, supervisor_name)VALUES(

  :employee_id<int>,

  :supervisor_name<char[33]>)

•placeholder(比如employee_id)可以用没有意义的f1代替,但是在一个SQL语句中不能使用相同名字的placeholder
•在执行INSERT语句的时候,如果数据库中char字段的大小是n,则这个INSERT语句的绑定变量的大小要为n+1;否则当邦定变量的大小为n时,执行INSERT会出错。
•对数据库中定义的数字字段,可以根据字段的大小使用16位、32 位的整数和double类型;当然,如果对所有OCI的数字字段使用double,也不会出错。
 
•OTL的一般使用步骤包括:

(1)  使用宏指明底层数据库API类型和控制编译器对OTL的编译。例如:#define OTL_ORA9I      // Compile OTL 4.0/OCI9i

(2)  创建otl_connect对象,该对象一般为全局共享的。

(3)  调用otl_connect的静态方法otl_initialize()初始化OTL环境。

(4)  调用otl_connect的rlogon()方法连接数据库。

(5)  创建otl_stream()对象,该对象一般为局部的。

(6)  使用otl_stream的<<操作符绑定SQL中的变量。

(7)  使用otl_stream的>>操作符读取返回结果。

(8)  调用otl_connect的logoff()方法从数据库断开。

 

 

代码

 

•SQL使用举例(常量SQL使用):

   常量SQL就是不带任何绑定变量的SQL,OTL通过一个静态方法来操作:

   long otl_cursor::direct_exec(otl_connect&db,//OTL数据库对象

                                const char* sqltm,//SQL语句

                            otl_exception_disable=0,//OTL异常忽略标志

                           );

   返回值:

   ●-1,如果otl_exception_disable被设置成1,并且OTL的底层API发生错误

   ●>=0,SQL执行成功,返回实际处理成功的记录数.

   o Examples(Oracle)

 

代码

 

 

输出:

A=2,B=Test Stri ng1

A=3,B=Test String2

A=4,B=Test String3 

 

常量PL/SQL块的使用与常量SQL的使用类似,在此不再赘述。

 

相关实践学习
如何在云端创建MySQL数据库
开始实验后,系统会自动创建一台自建MySQL的 源数据库 ECS 实例和一台 目标数据库 RDS。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
目录
相关文章
|
1月前
|
SQL 关系型数据库 MySQL
怎么通过第三方库实现标准库`database/sql`的驱动注入?
在Go语言中,数据库驱动通过注入`database/sql`标准库实现,允许统一接口操作不同数据库。本文聚焦于`github.com/go-sql-driver/mysql`如何实现MySQL驱动。`database/sql`提供通用接口和驱动注册机制,全局变量管理驱动注册,`Register`函数负责添加驱动,而MySQL驱动在`init`函数中注册自身。通过这个机制,开发者能以一致的方式处理多种数据库。
|
Java 数据库连接 网络安全
13-TDengine使用JDBC-JNI连接报错:JNI connection is NULL
13-TDengine使用JDBC-JNI连接报错:JNI connection is NULL
895 0
13-TDengine使用JDBC-JNI连接报错:JNI connection is NULL
|
Java 关系型数据库 数据库
java.sql.SQLException: No suitable driver 问题解决
最近在学习java,用到c3p0数据库连接池,遇到一个很奇怪的现象,用main方法测试是可以正常连接数据库的,但是使用jsp调用代码,就会报如下图的错误!   最下面的java.sql.SQLException: No suitable driver才是重点 解决办法是将mysql的驱动jar包,放到D:\Program Files\Java\jdk1.
3631 0
|
SQL 分布式计算 Oracle
spark中连接oracle报异常java.sql.SQLException: No suitable driver
本地环境运行正常,spark任务放到spark集群上运行出错
612 0
|
SQL 缓存 Oracle
OTL实战小结
前言: 以下内容是项目中使用OTL的部分小结,适合OTL初学者。大牛请绕行。
291 0
|
SQL 关系型数据库 数据库连接
|
SQL Oracle 关系型数据库
OTL之Oracle开发总结《转》
OTL之Oracle开发总结---转   关 于OTL,网上介绍的也不少,但看来看去也只是官方的那些文档。OTL很好用,结合官方提供的一些例子,多多尝试才能领悟。经过一个月左右的项目开发,对 OTL也有些了解,在这里总结一下,希望对刚接触OTL的新手有所帮助。
956 0
|
存储 Oracle 关系型数据库
OTL调用Oracle存储过程
OTL很早前用过,今天写东西要调存储过程,程序写完了,调试死活通不过,折腾了一早晨。 最后才发现错误,这里总结一下: 1、代码写的不规范。 有个参数后边少写了个“,”以至于总是抱错。而单独写的测试例子就没问题,后来一步一步跟踪了后才发现。
928 0