游标一般用来迭代结果集中的行
为了在一个过程中处理一个游标的结果,需要做以下事情:
在存储过程块的开头部分 DECLARE 游标。
打开该游标。
将游标的结果取出到之前已声明的本地变量中(隐式游标处理除外,在下面的 FOR 语句中将对此加以解释)。
关闭该游标。(注意:如果现在不关闭游标,当过程终止时将隐式地关闭游标)。
注:游标的申明如果放在中间段,要用”begin。。。end;”.段分割标志分割开;
游标使用的步骤如下:(游标用循环体实现向下取数)
1、说明游标。说明游标的时候并不执行select语句。
declare cursor for ;
2、打开游标。打开游标实际上是执行相应的select语句,把查询结果读取到缓冲区中。这时候游标处于活动状态,指针指向查询结果集的第一条纪录。
open ;
3、推进游标指针并读取当前纪录。用fetch语句把游标指针向前推进一条纪录,同时将缓冲区中的当前纪录读取出来送到变量中。fetch语句通常用在一个循环结构体中,通过循环执行fetch语句逐条取出结果集中的行进行处理。现在好多数据库中,还允许任意方向任意步长易懂游标指针,而不仅仅是把游标指针向前推进一行了。
fetch into ,...
4、关闭游标。用close语句关闭游标,释放结果集占用的缓冲区及其他资源。游标关闭后,就不再和原来的查询结果集相联系。但游标可以再次打开,与新的查询结果相联系。
close ;
基本结构:
定义游标:
DECLARE 游标名 CURSOR FOR
Select 语句;
打开游标:
OPEN 游标名;
取值:
FETCH 游标名 INTO 变量列表
游标例子:
--先插入测试数据
create table test(id int,city char(20))
insert into test values(1,'wuhan'),(2,'hangzhou'),(3,'chengdu')
create procedure Test(
out v_message varchar(500)
)
LANGUAGE SQL
BEGIN
DECLARE v_city char(20);
DECLARE v_count int;
SET v_message = '';
select count(*) into v_count from test;
BEGIN
DECLARE v_CUR CURSOR FOR SELECT city FROM test FOR READ ONLY;
OPEN v_CUR;
WHILE v_count > 0 DO
FETCH v_CUR INTO v_city;
set v_message = v_message ||v_city||' ';
set v_count = v_count -1;
end while;
END;
END@
运行结果为:
call Test(?)
completed successfully.
输出参数的值
--------------------------
参数名: V_MESSAGE
参数值: wuhan hangzhou chengdu
返回状态 = 0
Statement processed successfully in 4.39 secs.
除了这种结构外,还有一种使用for的游标的结构,例子如下:
create procedure Test(
out v_message varchar(500)
)
LANGUAGE SQL
BEGIN
DECLARE v_city char(20);
DECLARE v_count int;
SET v_message = '';
FOR V1 AS CURSOR1 CURSOR FOR select city as v_city from test
DO
set v_message = v_message||v_city||' ';
END FOR;
END@
运行结果:
call Test(?)
completed successfully.
输出参数的值
--------------------------
参数名: V_MESSAGE
参数值: wuhan hangzhou chengdu
返回状态 = 0
Statement processed successfully in 0.18 secs.
可以看到第二种游标使用起来非常简单。但是它不能使用 with hold 选项,这个with hold有什么用呢?默认情况下,,在Commit和Rollback时,游标将被关闭。所以如果游标循环体内有Commit或Rollback时,不能使用for形式的游标。但是第一种游标可以使用,可以在第一种游标定义时加上with hold 选项,那么在游标循环体内Commit和Rollback时,游标也不会关闭。
使用Commit和Rollback也不会关闭的游标,如下:
DECLARE v_CUR CURSOR with hold for SELECT city FROM test FOR READ ONLY;
如果要修改游标当前记录,需要定义可修改的游标,如下:
DECLARE v_CUR CURSOR for SELECT city FROM test FOR update;;
注意:for update 不能和 GROUP BY、 DISTINCT、 ORDER BY、 FOR READ ONLY及UNION, EXCEPT但 UNION ALL除外)一起使用。
在 DB2存储 过程中,除了迭代结果集中的行以外,游标还可以做更多的事情。游标还可用于将结果集返回给调用程序或其他过程。
WITHOUT RETURN/WITH return 选项指定游标的结果表是否用于作为从一个过程中返回的结果集。
WITH RETURN TO CALLER 选项指定将来自游标的结果集返回给调用者,后者可以是另一个过程或一个客户机应用程序。这是默认选项。
WITH RETURN TO CLIENT 选项指定将来自游标的结果集返回给客户机应用程序,绕过任何中间的嵌套过程。
若要从一个过程中返回结果集,需要:
创建一个过程,创建时指定 DYNAMIC RESULT SETS 子句。
声明游标,声明时指定 WITH RETURN 子句。
打开该游标,并使之保持 open 状态。
如果关闭该游标,则结果集将不能返回给调用者应用程序。
下例 演示了一个游标的声明,该游标从一个过程中返回一个结果集:
create procedure Test(
out v_message varchar(500)
)
DYNAMIC RESULT SETS 1
LANGUAGE SQL
BEGIN
--异常处理
DECLARE SQLCODE INT;
DECLARE v_errCode INT DEFAULT 0;
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION
BEGIN
SET v_errCode = SQLCODE;
END;
--使用游标返回结果集
BEGIN
DECLARE v_cur CURSOR WITH HOLD WITH RETURN TO CALLER FOR
SELECT * FROM test;
OPEN v_cur;
END;
RETURN v_errCode;
END@
运行结果:
call Test(?)
completed successfully.
输出参数的值
--------------------------
参数名: V_MESSAGE
参数值: -
结果集 1
--------------
ID CITY
----------- --------------------
1 wuhan
2 hangzhou
3 chengdu
3 条记录已选择。
返回状态 = 0
游标的使用注意点:
注意 commit和rollback
使用游标时要特别注意如果没有加with hold 选项,在Commit和Rollback时,该游标将被关闭。Commit 和Rollback有很多东西要注意。特别小心
游标的两种定义方式
一种为
declare continue handler for not found
begin
set v_notfound = 1;
end;
declare cursor1 cursor with hold for select market_code from tb_market_code for update;
open cursor1;
set v_notfound=0;
fetch cursor1 into v_market_code;
while v_notfound=0 Do
--work
set v_notfound=0;
fetch cursor1 into v_market_code;
end while;
close cursor1;
这种方式使用起来比较复杂,但也比较灵活。特别是可以使用 with hold 选项。如果循环内有commit或rollback 而要保持该cursor不被关闭,只能使用这种方式。
另一种为
pcursor1: for loopcs1 as cousor1 cursor as
select market_code as market_code
from tb_market_code
for update
do
end for;
这种方式的优点是比较简单,不用(也不允许)使用 open,fetch,close。
但不能使用with hold 选项。如果在游标循环内要使用commit,rollback则不能使用这种方式。如果没有commit或rollback的要求,推荐使用这种方式(看来For这种方式有问题)。
修改游标的当前记录的方法
update tb_market_code set market_code='0' where current of cursor1;
不过要注意将cursor1定义为可修改的游标
declare cursor1 cursor for select market_code from tb_market_code
for update;
for update 不能和 GROUP BY、 DISTINCT、 ORDER BY、 FOR READ ONLY及UNION, EXCEPT, or INTERSECT 但 UNION ALL除外)一起使用。
自己平时写的实例:
create procedure db2inst1.test_overdue()
language sql
begin
declare v_count int;
declare v_id varchar(10);
declare v_shuld_repay varchar(8);
declare v_natural_mon varchar(8);
declare v_over_mon varchar(10);
declare v_day_num varchar(10);
begin
declare v_cur cursor for select id from OVERDUE_HIS for read only;
open v_cur;
set v_count=3;
--select MONTH(to_date(ACTUAL_REPAY,'YYYYMMDD'))-MONTH(to_date(shuld_repay,'YYYYMMDD'))+1 into v_count from db2inst1.overdue_his
--fetch v_cur into v_id;
while v_count>0
do
insert into OVERDUE_HIS_TAB(id,shuld_repay,natural_mon,over_mon,day_num)
select a.id,a.shuld_repay,
a.natural_mon,
0,
days(to_date(a.natural_mon,'yyyymmdd'))-days(to_date(a.shuld_repay,'yyyymmdd')) as day_num
from(select id,
shuld_repay,
to_char(TO_DATE(YEAR(to_date(shuld_repay,'YYYYMMDD')+v_count month)||'-'||MONTH(to_date(shuld_repay,'YYYYMMDD')+v_count month)||'-'||'01','YYYYMMDD')-1 day,'YYYYMMDD') as natural_mon
from OVERDUE_HIS) a;
set v_count=v_count-1;
end while;
close v_cur;
end;
end;