表9-54 与连接，认证和初始化相关的函数

函数名称	描述
OCIEnvCreate	创建一个OCI环境
OCIEnvInit	初始化一个OCI环境句柄
OCIInitialize	初始化OCI环境
OCILogoff	释放一个会话
OCILogon	创建一个登录连接
OCILogon2	使用不同的方式创建一个登录会话
OCIServerAttach	建立到数据源的访问路径
OCIServerDetach	删除到数据源的访问
OCISessionBegin	创建一个用户会话
OCISessionEnd	结束一个用户会话
OCISessionGet	从会话池中获取一个会话
OCISessionRelease	释放一个会话
OCITerminate	从共享内存子系统中分离

表9-55与句柄和描述符相关的函数

函数名称	描述
OCIAttrGet	获取句柄属性
OCIAttrSet	设置句柄属性
OCIDescriptorAlloc	分配并且初始化一个描述符
OCIDescriptorFree	释放一个已分配的描述符
OCIHandleAlloc	分配并且初始化一个句柄
OCIHandleFree	释放一个已分配的句柄
OCIParamGet	获取一个参数描述符
OCIParamSet	设置一个参数描述符

表9-56 与绑定，定义和描述相关的函数

函数名称	描述
OCIBindByName	使用名称绑定
OCIBindByPos	使用位置绑定
OCIBindDynamic	绑定后设定其他的属性
OCIBindArrayOfStruct	为批量操作绑定一个数组结构
OCIDefineByPos	定义一个输出变量结合
OCIDefineDynamic	为定义设定其他属性
OCIDescribeAny	描述存在的模式对象
OCIStmtGetBindInfo	获取绑定和指示变量名称和句柄

表 9-57与语句相关函数

函数名称	描述
OCIStmtExecute	执行一个已准备的SQL语句
OCIStmtFetch	获取数据集中一行记录（已经作废）
OCIStmtFetch2	获取数据集中一条记录
OCIStmtPrepare	准备一个SQL语句
OCIStmtPrepare2	准备一个SQL语句
OCIStmtRelease	释放一个语句句柄。

表9-58与事务相关的函数

函数名称	描述
OCITransCommit	提交事务
OCITransRollback	回滚事务

表 9-59其它相关函数

函数名称	描述
OCIClientVersion	返回Client库的版本号
OCIErrorGet	返回一条错误消息
OCIPasswordChange	更改密码
OCIPing	确定连接和服务器处于活动状态
OCIServerVersion	获取包含Oracle版本的字符串

表 9-60与日期和日期时间类型的相关函数

函数名称	描述
OCIDateAddDays	增加或者减去天数
OCIDateAddMonths	增加或者减去月份数
OCIDateAssign	分配日期
OCIDateCheck	检查给定的日期是否有效
OCIDateCompare	比较两个日期
OCIDateDaysBetween	找出两个日期之间的天数
OCIDateFromText	将一个字符串转换为日期
OCIDateGetDate	获取一个日期中的日期部分
OCIDateGetTime	获取一个日期中的时间部分
OCIDateLastDay	获取每月最后一天的日期
OCIDateNextDay	获取明天的日期
OCIDateSetDate	设置一个日期中的日期部分
OCIDateSetTime	设置一个日期中的时间部分
OCIDateSysDate	获取当前系统日期和时间
OCIDateToText	将日期转换为字符串
OCIDateTimeAssign	赋予日期时间
OCIDateTimeCheck	检查日期是否有效
OCIDateTimeCompare	比较两个日期时间的值
OCIDateTimeConstruct	构建一个日期时间描述符
OCIDateTimeConvert	将日期时间类型变量转换成其它类型变量
OCIDateTimeFromArray	将大小为OCI_DT_ARRAYLEN的数组转换为OCIDateTime描述符。
OCIDateTimeFromText	根据指定的格式将字符串转换成OCIDateTime描述符中的Oracle日期时间类型。
OCIDateTimeGetDate	获取日期时间类型值中的日期部分。
OCIDateTimeGetTime	获取日期时间类型值中的时间部分。
OCIDateTimeGetTimeZoneName	获取一个日期时间类型值中时间区域名称部分
OCIDateTimeGetTimeZoneOffset	获取一个日期时间类型值中时间区域的(小时，分钟)部分
OCIDateTimeSubtract	把两个日期时间型的值作为输入参数，返回这两个值的间隔
OCIDateTimeSysTimeStamp	获取系统当前的日期和时间作为一个时间戳，并且带有一个时间区域。
OCIDateTimeToArray	将一个OCIDateTime描述符转换成一个数组
OCIDateTimeToText	根据指定的格式将一个日期类型的值转换成字符串类型的值

表9-61与数值相关的函数

函数名称	描述
OCINumberAbs	计算绝对值
OCINumberAdd	执行数值加法操作
OCINumberArcCos	计算反余玄函数值
OCINumberArcSin	计算反正玄函数值
OCINumberArcTan	计算反正切函数值
OCINumberArcTan2	计算反正切的两个数值
OCINumberAssign	将一个数值分配给另外一个变量
OCINumberCeil	计算一个数值的ceiling值
OCINumberCmp	比较数值
OCINumberCos	计算余弦值
OCINumberDec	对数值进行减一操作
OCINumberDiv	对两个数值进行除法操作
OCINumberExp	将 e 传递给指定的数值作为幂级数
OCINumberFloor	计算一个数值的floor值
OCINumberFromInt	将一个整数转换成一个Oracle数值
OCINumberFromReal	将一个实数转换成一个Oracle数值
OCINumberFromText	将一个字符串转换成一个Oracle数值
OCINumberHypCos	计算双曲余玄值
OCINumberHypSin	计算双曲正玄值
OCINumberHypTan	计算双曲正切值
OCINumberInc	对数值进行加一操作
OCINumberIntPower	传递给定的底数做为整型的幂级数
OCINumberIsInt	测试数值是否为一个整数
OCINumberIsZero	测试数值是否为0
OCINumberLn	计算自然对数值
OCINumberLog	以任意数为底计算对数值
OCINumberMod	对数值进行取模操作
OCINumberMul	对数值进行乘法操作
OCINumberNeg	对一个数值进行求反操作
OCINumberPower	以e为底求幂级数
OCINumberPrec	将一个数值四舍五入到一个指定数值的小数点位
OCINumberRound	将一个数值四舍五入到指定的小数点位
OCINumberSetPi	将一个数值初始化为Pi
OCINumberSetZero	将一个数值初始化为0
OCINumberShift	执行乘10操作,移动指定数值的小数点位
OCINumberSign	获取数值的符号
OCINumberSin	计算正玄值
OCINumberSqrt	计算一个数值的平方根
OCINumberSub	进行减法操作
OCINumberTan	计算正切值
OCINumberToInt	将一个数值转换成一个整数
OCINumberToReal	将一个数值转换成一个实数
OCINumberToRealArray	将一个数值型数组转换成一个实数型数组
OCINumberToText	将一个数值转换成一个字符串
OCINumberTrunc	在指定的小数位截断一个数值

表9-62 字符串函数

函数名称	描述
OCIStringAllocSize	获取已分配用于存放字符串的内存字节数
OCIStringAssign	将字符串赋予一个字符串类型变量
OCIStringAssignText	将文本字符串赋予一个字符串类型变量
OCIStringPtr	获取字符串指针
OCIStringResize	重新设定用于存放字符串内存的大小
OCIStringSize	获取字符串的长度

表9-63与磁带和文件I/O相关的接口函数

函数名称	描述
OCIFileClose	关闭一个已打开的文件
OCIFileExists	测试文件是否存在
OCIFileFlush	将缓冲池的数据写到一个文件中
OCIFileGetLength	获取文件的长度
OCIFileInit	初始化OCIFile包
OCIFileOpen	打开一个文件
OCIFileRead	将文件内容读取到缓冲区中
OCIFileSeek	改变文件中指针的当前位置
OCIFileTerm	结束包OCIFile
OCIFileWrite	将长度为buflen的字节写到文件中。

表9-64 所支持的数据类型

数据类型名称	描述
ANSI_DATE	ANSI 日期类型
SQLT_AFC	ANSI 固定字符
SQLT_AVC	ANSI 可变字符串
SQLT_BDOUBLE	二进制双精度类型
SQLT_BIN	二进制数据类型
SQLT_BFLOAT	二进制浮点型
SQLT_CHR	字符串类型
SQLT_DAT	Oracle 日期类型
SQLT_DATE	ANSI 日期类型
SQLT_FLT	浮点型
SQLT_INT	整型
SQLT_LBI	长二进制
SQLT_LNG	长整型
SQLT_LVB	超长的长型二进制
SQLT_LVC	超长的长整型数值（或字符串）
SQLT_NUM	Oracle数值
SQLT_ODT	OCI数据类型
SQLT_STR	以0结束的字符串
SQLT_TIMESTAMP	时间戳
SQLT_TIMESTAMP_TZ	带有区域的时间戳
SQLT_TIMESTAMP_LTZ	带有本地时间区域的时间戳
SQLT_UIN	无符号整数
SQLT_VBI	VCS格式的二进制数据
SQLT_VCS	变长字符串
SQLT_VNU	变长数值
SQLT_VST	OCI 字符串类型

--打开游标方式1，最标准的操作方式
declare
  rec scott.emp%ROWTYPE;
  --游标可以有参数，参数也允许有默认值
  cursor c1(low number default 0, high number default 10000) return scott.emp%ROWTYPE is
  select * from scott.emp where sal between low and high;
begin
  open c1(1000,3000); --open游标的时候提供参数
  loop
   fetch c1 into rec;
   exit when c1%NOTFOUND;
   dbms_output.put_line(rec.empno || ' ' || rec.sal);
  end loop;
  close c1;
end;

--for循环打开游标，无需open和close，也不用处理exit
declare
  cursor c1(low number default 0, high number default 10000) return scott.emp%ROWTYPE is
  select * from scott.emp where sal between low and high;
begin
  for rec in c1(1000,3000)
  loop  
   dbms_output.put_line(rec.empno || ' ' || rec.sal);
  end loop;
end;

--最简单的方式，无需声明游标，将select语句直接作为游标
declare
  low integer;
  high integer;
begin
  low :=1000;
  high := 3000;
  for rec in (select * from scott.emp where sal between low and high)
  loop  
   dbms_output.put_line(rec.empno || ' ' || rec.sal);
  end loop;
end;

declare
     cursor cur1 is select * from test for update; --表明游标用来更新
     rec test%ROWTYPE;
begin
     open cur1;
     for i in 1..100 loop
         fetch cur1 into rec;
         update test set object_name='haha' where current of cur1; --游标可以用来更新，where current of 游标名
     end loop;
     commit;
     close cur1;
end;

游标变量的用法：

--游标变量
 CREATE OR REPLACE PACKAGE emp_data AS
   TYPE empcurtyp IS REF CURSOR --包中可以声明游标变量类型，但是无法声明游标变量
     RETURN employees%ROWTYPE;
 
   PROCEDURE open_emp_cv (emp_cv IN OUT empcurtyp); --游标变量经常用作存储过程的输出参数
 END emp_data;

 CREATE OR REPLACE PACKAGE BODY emp_data AS
   PROCEDURE open_emp_cv (emp_cv IN OUT empcurtyp) IS   --存储过程返回游标变量
   BEGIN
     OPEN emp_cv FOR
       SELECT *
         FROM employees;
   END open_emp_cv;
 END emp_data;

 declare
   cur emp_data.empcurtyp;
   type rectable is table of employees%ROWTYPE;
   rec rectable;
   i number;
 begin
   emp_data.open_emp_cv(cur);
   fetch cur bulk collect into rec;    --批量取游标变量的值
    i := rec.first;
    while i <= rec.last loop
          dbms_output.put_line(rec(i).first_name || ' ' || rec(i).last_name);
          i := rec.next(i);
    end loop;
   close cur; 
 end;
 
 declare
   cur emp_data.empcurtyp;
   rec employees%ROWTYPE; 
   i number;
 begin
   emp_data.open_emp_cv(cur);
   fetch cur into rec;       --单条取游标变量的值
   loop
     exit when cur%NOTFOUND;
       dbms_output.put_line(rec(i).first_name || ' ' || rec(i).last_name);      
    end loop;
   close cur; 
 end;
 
 EXCEPTION
  WHEN ROWTYPE_MISMATCH THEN
  
  WHEN INVALID_CURSOR THEN
  
  
 如果两个游标变量都是强类型，且类型不同，哪怕return的值一样，也不能相互赋值。
 如下面的赋值是错误的
 declare
   type emp_cur_type1 is ref cursor return employees%ROWTYPE;
   cur1 emp_cur_type1;
   type emp_cur_type2 is ref cursor return employees%ROWTYPE;
   cur2 emp_cur_type2;
 begin
   open cur1 for select * from employees;
   cur1 := cur2;   -- causes 'wrong type' error
  ...
 end;

两个游标变量相互赋值后，操作其一相当于操作两者。
declare
  type emp_cur_type is ref cursor return employees%ROWTYPE;
  cur1 emp_cur_type;
  cur2 emp_cur_type;
  rec1 employees%ROWTYPE;
  rec2 employees%ROWTYPE;
begin
  open cur1 for select * from employees;
  cur2 := cur1;
 
  loop
       fetch cur1 into rec1;
        exit when cur1%NOTFOUND;
        dbms_output.put_line(rec1.first_name || ' ' || rec1.last_name);
  end loop;
 
  dbms_output.put_line('-----------------------------------------------------');
  --此后将打印不出来内容，因为前面的cur1数据已经取完，指针移到了最后
  --cur2和cur1指向的是同一个区域，所以操作cur1相当于操作cur2
  loop
       fetch cur2 into rec2;
        exit when cur2%NOTFOUND;
        dbms_output.put_line(rec2.first_name || ' ' || rec2.last_name);
  end loop;

  close cur1;
 -- close cur2;   --不能再次关闭，因为cur1和cur2指向的是同一个区域，close cur1后cur2也随之关闭了
end;

游标属性：
 %FOUND, %NOTFOUND, %ROWCOUNT, %ISOPEN
 
隐式游标
 SQL%FOUND, SQL%NOTFOUND, SQL%ROWCOUNT, SQL%ISOPEN
 这些属性与最近一次执行的语句相关，如果要用到，最好在待考察语句结束后，马上用变量保存起来。
 

自治事务：
 PRAGMA AUTONOMOUS_TRANSACTION; --在声明的任何部分加入这句话都可以，一般在第一句。

SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;  --将事务隔离级别设置为serializable

create package debugging as
       function log_msg(msg varchar2) return varchar2;
       pragma restrict_references(log_msg,WNDS,RNDS);  --限制函数log_msg写数据表或者读数据表
end debugging;

create package body debugging as
  function log_msg(msg varcahr2)
           return varchar2
  is
           pragma autonomous_transaction;   --自治事务可以免收上面的限制
  begin
           insert into debug_output
                  values(msg);
           commit;
           return msg;
  end;
end debugging;

环境区域是用来处理SQL语句的一个oracle存储区域。游标是指向它的指针或句柄。通过游标，PL/SQL程序可以控制这个环境区域中被处理的语句。

Oracle中的游标有两种：显式游标、隐式游标。

显示游标是用cursor...is命令定义的游标，它可以对查询语句(select)返回的多条记录进行处理，而隐式游标是在执行插入(insert)、删除(delete)、修改(update)和返回单条记录的查询(select)语句时由PL/SQL自动定义的。

1、显式游标操作

显式游标在块定义部分、包或子程序中声明。当声明了显式游标后，可以通过以下三条命令控制显式游标的操作：打开游标、推进游标、关闭游标。

(1)声明显式游标

--例1

declare   
v_auths auths%rowtype;   
v_code auths.author_code%type;   
cursor c_auths is    
    select * from auths where author_code=v_code;

上例是将PL/SQL变量绑定在WHERE子句中，下面将游标参数绑定在游标的WHERE子句中：

--例2

delcare   
cursor c_auths(p_code auths.author_code%type) is   
    select * from auths where author_code=p_code;  

(2)打开显式游标

游标操作的第一步是打开游标。

例1，下面的语句是打开上节例1中声明的显式游标c_auths;

begin   
--在打开游标前为绑定变量赋值。   
v_code:='A00001';   
--打开游标。   
open c_auths;  

例2，如果对于一个带参数的游标

begin   
--打开游标时将参数传入。   
open c_auths('A00001');  

打开一个已打开的游标也是合法的。当第二次打开游标时，PL/SQL先自动关闭游标，然后再打开。一次打开多个游标也是PL/SQL所允许的。

(3)推进显式游标

当打开显式游标后，就可以使用FETCH语句来推进游标，返回查询结果集中的一行。每执行完一条FETCH语句后，显式游标会自动指向查询结果集的下一行。

(4)关闭显式游标

当整个结果集都检索完以后，应当关闭游标。关闭游标用来通知PL/SQL游标操作已经结束，并且释放游标所占用的资源(结果集所使用的资源空间)。

2、游标的属性

游标有四个属性：%found、%notfound、%isopen和%rowcount。要注意这些属性只能使用在过程性语句中，而不能使用在SQL语句中。

表tableattribute，表中有两列column1(number类型)和column2(varchar2类型)，现在向表中插入两条记录：

insert into tableattribute values(10,'first');

insert into tableattribute values(20,'second');

...

3、显式游标的推进循环

delcare   
--声明一个变量，这个变量用来接收游标返回的结果集。   
v_salary auths.salary%type;   
v_code auths.author_code%type;   
/*声明游标，该游标的查询结果集是作家代码为"A00001"到"A00006"的工资值。*/  
cursor c_salary is select salary,author_code from auths where author_code<='A00006';   
begin   
--打开游标，并初始化结果集   
open c_salary;   
loop   
    --推进游标，将游标的查询结果集中的一行存到变量v_salary中。   
    fetch c_salary into v_salary,v_code;   
    --当结果集中没有行时退出循环。   
    exit when c_salary%notfound;   
    --如果查询到的作家工资小于或等于200，则增加该作家的工资值。   
    if v_salary<=200 then   
      update auths set salary=salary+50 where author_code=v_code;   
    end if;   
end loop;   
--关闭游标，释放游标占用资源。   
close c_salary;   
--提交所做的修改。   
commit;   
end;  

PL/SQL还提供了一种简单类型的循环，可以自动控制游标的打开、推进和关闭，叫做游标的FOR循环。

delcare   
cursor c_salary is   
    select salary form auths where author_code<='A00006';   
begin   
--开始游标FOR循环，隐含地打开c_salary游标。   
for v_salary in c_salary loop   
    --一个隐含的fetch语句在这里被执行。   
　　if v_salary.salary<=200 then   
      update auths set salary=salary+50 where salary=v_salary.salary;   
    end if;   
    --在循环继续前，一个隐含的c_auths%notfound被检测。   
　end loop;   
--现在循环已经结束，c_auths游标的一个隐含的close操作被执行。   
commit;   
end;  

使用current of cursor子句作为条件

delcare   
--声明游标时在select语句中必须加for update of子句。   
cursor c_salary is   
    select salary form auths where author_code<'A00006' for update of salary;   
begin   
for v_salary in c_salary loop   
    if v_salary.salary<=200 then   
      --下面的update语句中的current of子句用来表明结果集的当前行。
    update auths set salary=salary+50 where current of c_salary;  
    end if;   
end loop;   
commit;   
end;  

如果在游标的FOR循环中使用子查询，则不用在块定义部分声明显式游标，在FOR循环中子查询隐含声明了一个显式游标。

begin   
--在下面的FOR循环中隐含地声明了一个游标c_salary。   
　for c_salary in   
(select salary form auths where author_code<='A00006') loop   
    if c_salary.salary<=200 then   
      update auths set salary=salary+50 where salary=c_salary.salary;   
    end if;   
end loop;   
commit;   
end;  

4、隐式游标处理

PL/SQL隐式地打开SQL游标，并在它内部处理SQL语句，然后关闭它。SQL游标用来处理insert、update、delete以及返回一行的select...into语句。

一个SQL游标不管是打开还是关闭，open、fetch和close命令都不能操作它。SQL游标与显式游标类似，也有四个一样的属性。当打开SQL游标之前，SQL游标的属性都为NULL。

begin   
update auths set entry_date_time=sysdate where author_code='A00017';   
--如果update语句中修改的行不存在(SQL%notfound返回值为true),则向auths表中插入一行。   
if sql%nofound then   
    insert into auths(author_code,name,sex,birthdate,salary,entry_date_time)   
      values('A000017','qiuys',1,'30-apr-40',88.5,sysdate);   
end if;   
end;  

--如果update语句中修改的行不存在(sql%rowcount=0)

declare   
v_birthdate date;   
begin   
select birthdate into v_birthdate from auths where name='qiuys';   
--如果查询到一条记录，则删除该记录。   
if sql%found then   
    delete from auths where name='qiuys';   
end if;   
exception   
when no_data_found then   
    dbms_output.put_line('该记录不存在');   
when too_many_rows then   
    dbms_output_line('存在同名的作家');   
end;  

5、游标变量

到目前为止前面所有显式游标的例子都是静态游标－即游标与一个SQL语句关联，并且该SQL语句在编译时已经确定。

而游标变量是一个引用类型(REF)的变量。

(1)游标变量的声明

declare   
--使用%rowtype定义一个游标变量类型。   
type t_authsref is ref cursor return auths%rowtype;   
--定义一个记录类型。   
type t_coderecord is record(   
    author_code article.author_code%type,   
    article_code article.article_code%type);   
--声明一个记录类型的变量。   
v_code t_coderecord;   
--使用t_coderecord作为一个游标变量类型的结果集类型。   
type t_coderef is ref cursor return t_codeRecord;   
--使用v_code作为一个游标变量类型的结果集类型。   
type t_coderef2 is ref cursor return v_code%type;   
--使用上面的类型声明的两个游标变量。   
v_authcv t_authsref;   
v_codecv t_coderef;  

PL/SQL2.8以上版本中，可以使用一个没有指定结果集类型的游标变量(没有RETURN)来指定多个不同类型的查询。

type t_authsref if ref cursor;

v_cursorvar t_authsref;--声明一个该类型的变量。

(2)打开游标变量

为了将一个游标变更与一个具体的select语句联系起来，open的语法中增加了一个select语句。

open cursor_variable for select_statement;   
declare   
type t_authorsref is ref cursor return auths%rowtype;   
v_authscv t_authorsref;   
--然后打开   
open v_authscv for select * from auths;  

3)推进游标变更

(4)关闭游标变更

该操作用来释放查询所占用的资源。但没有释放游标变量占用的存储空间。当变量超出作用域时，它所占用的空间才被释放掉。

下面的块中定义了一个没有指定结果集的游标变量，这样我们就可以使用这个游标变量指向不同的查询，并能够返回不同的记录类型：

set serveroutput on size 100000 --设置存储缓冲区大小。   
declare   
/*定义游标变更类型t_curref，该游标变量类型没有指定结果集类型，所以该游标变量类型的变量可以返回不同的PL/SQL记录类型。*/  
type t_curref is ref cursor;   
--声明一个游标变量类型的变量   
c_cursorref t_curref;   
--定义PL/SQL记录类型t_authorrec，该类型的变量用来接收游标变量的返回值。   
type t_authorrec is record(   
    authorcode auths.author_code%type,   
    name auths.name%type);   
--定义PL/SQL记录类型t_articlerec,该类型的变量也用来接收游标变量的返回值。   
type t_articlerec is record(   
    authorcode article.author_code%type,   
    title artitle.title%type);   
--声明两个记录类型变量。   
v_author t_authorrec;   
v_article t_articlerec;   
begin   
--打开游标变量c_cursorref，返回t_authorrec类型的记录。   
open c_cursorref for    
    select author_code,name from auths where author_code in('A00001','A00002','A00003','A00004','A00005');   
--推进游标变量   
fetch c_cursorref into v_author;   
--游标变量的推进循环。   
while c_cursorref%found loop   
    --将作家代码和相应的作家名字输出到屏幕上。   
    dbms_output.put(v_author.authorcode||':'||v_author.name||' ');   
    fetch c_cursorref into v_author;   
end loop;   
dbms_output.new_line;--向屏幕上输出一个回车行。   
--关闭游标变量，仅仅将游标变量指定的资源释放掉，游标变量本身的存储空间没有释放掉。   
close c_cursorref;   
--再次打开游标变量，返回t_articlerec类型的记录。   
open c_cursorref for    
    select author_code,title from article   
    where author_code in('A00001','A00002','A00003','A00004','A00005');   
fetch c_cursorref into v_article;   
while c_cursorref%found loop   
    ...   
end loop;   
close c_cursorref;   
end;  

注意，在上例中，第一次关闭游标变量是可省略的，因为在第二次打开游标变量时，就将第一次的查询丢失掉了。而且游标变量也有游标属性，通常在推进游标变量时使用这些游标属性，例如上例使用了%found属性。