OCI操作oracle数据库word文档良心出品Word格式.docx
《OCI操作oracle数据库word文档良心出品Word格式.docx》由会员分享,可在线阅读,更多相关《OCI操作oracle数据库word文档良心出品Word格式.docx(30页珍藏版)》请在冰豆网上搜索。
![OCI操作oracle数据库word文档良心出品Word格式.docx](https://file1.bdocx.com/fileroot1/2023-2/1/8a6d97d9-edf0-4de5-83b1-e59c8dc49079/8a6d97d9-edf0-4de5-83b1-e59c8dc490791.gif)
标准的SQL语言按照它的功能不同,可以分为查询、操纵、定义以及控制四种类型。
每一种都有若干关键字,具体如表1所示。
一个SQL语句在OCI应用程序中的执行步骤一般如下:
1)准备SQL语句。
调用函数OCIStmtPrepare();
2)在SQL语句中绑定需要输入到SQL语句中的变量。
对于DML语句来说,由于它带有输入变量,我们可以通过调用一个或者多个函数OCIBindByPos()、OCIBindByName()等把输入变量的地址绑定在DML语句中的占位符中;
3)执行SQL语句。
调用OCIStmtExecute()函数。
对于DDL语句到这一步就完成了一个语句的执行;
4)描述SQL中的输出的数据。
如果有必要的话,我们可以调用函数OCIParamGet()与OCIAttrGet()来获取我们所读取的记录的字段个数、字段的数据类型以及字段数据定义的最大长度。
5)定义输出变量。
对于DQL(DataQueryLanguage)语句,即SELECT的查询语句,需要定义一定数量的变量用来接受所选择列的数据。
我们可以调用OCIDeflneByPos()、OCIDefineObject()函数等来完成这个任务。
也就建立SQL语句所返回的数据与应用程序中变量的关系。
6)获取数据。
我们可以调用函数OCIStmtFetch()来把用SELECT选中的记录的数据赋予应用程序中的变量。
过程以及过程中调用到的函数如图3所示:
虽然Oracle对标准的SQL语言有所扩展,但它也是建立在标准的SQL语言的基础之上。
上图是一个一般SQL执行的流程图,对于不同的SQL语句,所需要的步骤也有所不同。
对于DCL与DDL语句,由于没有数据的输入与输出,仅仅涉及到一些权
限与定义或者删除数据库中的对象的问题,因此只需要上图的第一步与第三步便可以了。
而对于DQL与DML语句,由于有数据的输入与输出,因此需要的步骤就多一些。
其实,DML也可以只用两步来完成。
这是因为DML语句中仅仅涉及数据的输入(即,数据从应用程序到数据库端),因此我们可以把所要输入的数据以字符串的形式放在SQL语句中。
而DQL不仅可能有数据输入,而且也有数据输出(从数据库端到应用程序),因此,一个DQL语句需要如上图的六个步骤。
OCI环境配置
Oracle
oci工具包安装:
$ORACLE_HOME\BIN:
执行文件和help文件
$ORACLE_HOME\OCI\INCLUDE:
头文件
$ORACLE_HOME\OCI\LIB\BC:
for
Borlanf
C++的OCI库
$ORACLE_HOME\OCI\LIB\MSVC:
MS
Visual
如果是unix下,对于ORACLE8i,则OCI库在$ORACLE_HOME/lib下,如果是9i,则在$ORACLE_HOME/lib32下,库文件名一般为libclntsh.so
以上所有过程,只需安装一个oracle客户端,oci的所有头文件和库文件全部包含在内,VC开发时只需包含指定的头文件,引用相关库即可。
OCI实现操作oracle数据库
1.创建OCI环境
即创建和初始化OCI工作环境,其他的OCI函数需要OCI环境才能执行。
2.需要申请的句柄类型
OCI环境句柄:
OCI_HTYPE_ENV—它定义所有OCI函数的环境调用环境,是其他句柄的父句柄。
(由OCIEnvInit或OCIEnvCreate生成)
错误句柄:
OCI_HTYPE_ERROR—作为一些OCI函数的参数,用来记录这些OCI函数操作过程中所产生的错误,当有错误发生时,可用COIErrorGet()来读取错误句柄
中记录的错误信息。
服务器环境句柄:
OCI_HTYPE_SVCCTX—定义OCI调用的服务器操作环境,它包含服务器、用户会话和事务三种句柄。
服务器句柄:
OCI_HTYPE_SERVER—标识数据源,它转换为与服务器的物理连接。
用户会话句柄:
OCI_HTYPE_SESSION—定义用户角色和权限及OCI调用的执行环境。
事务句柄:
OCI_HTYPE_TRANS—定义执行SQL操作的事务环境,事务环境中包含用户的会话状态信息。
语句句柄:
OCI_HTYPE_STMT—是一个标识SQL语句或PL/SQL块,以及其相关属性的环境。
Bind/Define句柄:
属于语句句柄的子句柄,由OCI库隐式自动生成。
用户不需要自己再申请,OCI输入变量存储在bind
句柄中,输出变量存储在定义句柄中
3.句柄属性包括
服务器环境句柄属性:
(OCI_HTYPE_SVCCTX)
OCI_ATTR_SERVER—设置/读取服务环境的服务器环境属性
OCI_ATTR_SESSION—设置/读取服务环境的会话认证环境属性
OCI_ATTR_TRANS—设置/读取服务环境的事务环境属性
用户会话句柄属性:
(OCI_HTYPE_SESSION)
OCI_ATTR_USERNAME—设置会话认证所使用的用户名
OCI_ATTR_PASSWORD—设置会话认证所使用的用户口令
(OCI_HTYPE_SEVER)
OCI_ATTR_NOBLOCKING_MODE—设置/读取服务器连接:
=TRUE时服务器连接设置为非阻塞方式
(OCI_HTYPE_STMT)
OCI_ATTR_ROW_COUNT—只读,为当前已处理的行数,其default=1
OCI_ATTR_STMT_TYPE—读取当前SQL语句的类型:
Eg
:
OCI_STMT_BEGIN
OCI_STMT_SELECT
OCI_STMT_INSERT
OCI_STMT_UPDATE
OCI_STMT_DELETE
OCI_ATTR_PARAM_COUNT—返回语句选择列表中的列数
4.关于输出变量定义
如果在语句执行前就知道select语句的选择列表结构,则定义输出操作可在调用
OCISTMTExecute前进行,如果查询语句的参数为用户动态输入的,则必须在执行后定义。
5.OCI函数返回值
OCI_SUCCESS
–函数执行成功
(=0)
OCI_SUCCESS_WITH_INFO
–执行成功,但有诊断消息返回,可能是警告信息
OCI_NO_DATA—函数执行完成,但没有其他数据
OCI_ERROR—函数执行错误
OCI_INVALID_HANDLE—传递给函数的参数为无效句柄,或传回的句柄无效
OCI_NEED_DATA—需要应用程序提供运行时刻的数据
OCI_CONTINUE—回调函数返回代码,说明回调函数需要OCI库恢复其正常的处理操作
OCI_STILL_EXECUTING—服务环境建立在非阻塞模式,OCI函数调用正在执行中。
6.OCI连接有二种方式
Blocking(阻塞方式)和non_Blocking(非阻塞方式),阻塞方式就是当调用
OCI操作时,必须等到此OCI操作完成后服务器才返回客户端相应的信息,不管是成功还是失败。
非阻塞方式是当客户端提交OCI操作给服务器后,服务器立即返回OCI_STILL_EXECUTING信息,而并不等待服务端的操作完成。
对于non-blocking方式,应用程序若收到一个OCI函数的返回值为
OCI_STILL_EXECUTING时必须再次对每一个OCI函数的返回值进行判断,判断其成功与否。
可通过设置服务器属性为OCI_ATTR_NONBLOCKING_MODE来实现。
系统默认方式为阻塞模式.
7.OCI函数设置的模式
OCI_DEFUALT:
使用OCI默认的环境
OCI_THREADED:
线程环境下使用OCI
OCI_OBJECT:
对象模式
OCI_SHARED:
共享模式
OCI_EVENTS
OCI_NO_UCB
OCI_ENV_NO_MUTEX:
非互斥访问模式
其中模式可以用逻辑运算符进行迭加,将函数设置成多多种模式:
如mode=OCI_SHREADED|
OCI_OBJECT
8.事务
当应用进程与服务器断开连接时,程序没有使用OCITransCommit()进行事务的提交,则所有活动的事务会自动回滚。
9.OCI重定义数据类型
typedef
unsigned
char
ub1;
signed
sb1;
short
ub2;
sb2;
int
ub4;
sb4;
ub4
duword;
sb4
dsword;
dsword
dword;
10.属性操作
在SQL语句准备后,可以用OCIAttrSet(0设置该语句的类型属性OCI_ATTR_STMT_TYPE,以后可读取语句属性,根据属性分别进行处理。
11.批量绑定输入和定义输出参数
将数据存入一个静态数据组中。
一次执行可以提交或读取多行记录值。
12.占位符和指示器变量
占位符:
在程序中,一些SQL语句需要在程序运行时才能确定它的语句数据,在设计时可用一个占位符来代替,当程序运行时,在它准备好语句后,必须为每个占位符指定一个变量,即将占位符与程序变量地址结合,执行时,Oracle就从这些变量中读取数据,并将它们与SQL语句一起传递给Oracle服务器执行。
OCI结合占位符时,它将占位符与程序变量关联起来,并同时要指出程序变量的数据类型和数据长度。
如:
select
*
from
test
where
name=:
p1
and
age>
p2
:
p1和:
p2为占位符
指示器变量:
由于在Oracle中,列值可以为NULL,但在C语言中没有NULL值,为了能使OCI程序表达NULL列值,OCI函数允许程序为所执行语句中的结合变量同时关联一个指示符变量或指示符变量数组,以说明所结合的占位符是否为NULL或所读取的列值是否为NULL,以及所读取的列值是否被截取。
除SQLT_NTY(SQL
Named
DataType)外,指示符变量或指示符变量数组的数据类型为sb2,其值说明:
作为输入变量时:
(如insert
update语句中)
=-1:
OCI程序将NULL赋给Oracle表的列,忽略占位符结合的程序变量值
>
=0:
应用程序将程序变量值赋给指定列
作为输出变量时:
(如select语句中)
=-2:
所读取的列数据长度大于程序变量的长度,则被截取。
所读取的值为NULL,输出变量的值不会被改变。
数据被完整读入到指定的程序变量中
0:
所读取的列数据长度大于程序变量的长度,则被截取,指示符变量值为所读取数据被截取前的实际长度
OCI函数说明
示例以下面结构作为说明
sword
swResult;
OCIBind*
hBind;
OCIDefine*
hDefine;
OCIStmt
*stmtp
OCIError
*errhp;
OCISvcCtx
svchp
OCIEnv
envhpp;
OCISession
usrhp;
sb2sb2aInd[30];
//指示器变量,用于取可能存在空值的字段
Typedef
strcut
{
tname[40];
age;
}
t_std;
struct
sb2
sb2_tname[100];
sb2_age[100];
stdInd_T;
//指示器数组
ub2
ub2_tname[100];
ub2_age[100];
stdLen_T;
//字段长度
t_std
tstd[100];
//数组变量,用于批量操作
stdInd_T
tstdInd;
stdLen_T
tstdLen;
tstdRet;
std;
各函数数明
OCIEnvCreate(
**envhpp,
//OCI环境句柄指针
mode,
//初始化模式:
OCI_DEFAULT/OCI_THREADED
等
CONST
dvoid
*ctxp,
*(*malicfp)(dvoid
*ctxp,size_t
size),
*(ralocfp)(dvoid
*ctxp,dvoid
*memptr,size_t
newsize),
void
*(*mfreefp)(dvoid
*memptr),
Size_t
xstramemsz,
Dvoid
**usrmempp
)
eg
swResult
=
OCIEnvCreate(&
envhpp,
OCI_DEFAULT,
NULL,
0,
NULL);
if(swResult
!
&
OCI_SUCCESS_WITH_INFO)
return
FALSE;
OCIInitialize
(
ub4
mode,
*ctxp,
CONST
*(*malocfp)
(/*
size_t
size
_*/),
*(*ralocfp)
(/*_
*memptr,
newsize
(*mfreefp)
*memptr
_*/)
);
OCIEnvInit
(
**envhpp,
xtramemsz,
注:
在8i以后,可用OCIEnvCreate一个函数就可以初始化环境了,相当于OCIInitialize+
OCIEnvInit
2.申请/释放句柄
OCIHandleAlloc(
*parenth,
//新申请句柄的父句柄,一般为OCI环境句柄
**hndlpp,
//申请的新句柄
Ub4
type,
//句柄类型
xtramem_sz,
//申请的内存数
**usrmempp
//申请到的内存块指针
一般需要申请的句柄有:
服务器句柄OCIServer,
句柄类型OCI_HTYPE_SERVER
错误句柄OCIError,用于捕获OCI错误信息,
句柄类型OCI_HTYPE_ERROR
事务句柄OCISession,
句柄类型OCI_HTYPE_SESSION
上下文句柄OCISvcCtx,
句柄类型OCI_HTYPE_SVCCTX
SQL语句句柄OCIStmt,
句柄类型OCI_HTYPE_STMT
eg:
申请一个错误句柄OCIError
OCIHandleAlloc(envhpp,
(dvoid
*)&
errhp,
OCI_HTYPE_ERROR,
OCI_SUCCESS_WITH_INFO)
}
释放句柄
OCIHandleFree(
*hndlp,
//要释放的句柄
type
OCIHandleFree(stmtp,
OCI_HTYPE_STMT)
3.读取/设置句柄属性
OCIAttrSet(
*trgthndlp,
//需设置的句柄名
trghndltyp,//句柄类型
*attributep,
//设置的属性名
size,//属性值长度
attrtype,
//属性类型
*errhp
//错误句柄
一般要设置的属性有:
服务器实例:
句柄类型OCI_HTYPE_SVCCTX,属性类型OCI_ATTR_SERVER
连接数据的用户名:
句柄类型OCI_HTYPE_SESSION,属性类型OCI_ATTR_USERNAME
用户密码
句柄类型OCI_HTYPE_SESSION,属性类型OCI_ATTR_PASSWORD
事务:
句柄类型OCI_HTYPE_SVCCTX,属性类型OCI_ATTR_SESSION
设置用户名和密码
username[20],passwd[20];
strcpy(username,”tiger”)
strcpy(passwd,”cotton”)
OCIAttrSet(usrhp,
OCI_HTYPE_SESSION,
(text*)
username,
strlen(username),
OCI_ATTR_USERNAME,
errhp);
passwd,
strlen(passwd),
OCI_ATTR_PASSWORD,
OCIAttrGet(
//需读取的句柄名
//读取的属性名
*sizep,//属性值长度
)
4.连接/断开服务器
多用户方式连