Mysql游标(cursor)基础整理

游标
游标就像您打开文件所得到的文件句柄一样，只要文件打开成功，该文件句柄就可代表该文件

注：不像多数 DBMS，MySQL 游标只用于存储过程（和函数）

使用游标原因
在操作mysql的时候，MySQL检索操作返回一组称为结果集的行。这组返回的行都是与 SQL语句相匹配的行。

使用简单的 SELECT语句，例如，没有办法得到第一行、下一行或前 10行，也不存在每次一行地处理所有行的简单方法。有时，需要在检索出来的行中前进或后退一行或多行。

游标（ cursor）是一个存储在MySQL服务器上的数据库查询，它不是一条 SELECT语句，而是被该语句检索出来的结果集。

在存储了游标之后，应用程序可以根据需要滚动或浏览其中的数据。游标主要用于交互式应用，其中用户需要滚动屏幕上的数据，并对数据进行浏览或做出更改。

游标使用场景
主要用在循环处理、存储过程、函数中使用，用来查询结果集，就比如：我们需要从表中循环判断并得到想要的结果集，这时候使用游标操作很方便速度也很快。

游标使用步骤
5个步骤，主要是：定义游标->打开游标->使用游标->关闭游标->释放游标。

使用游标
1、在能够使用游标前，必须声明（定义）它。这个过程实际上没有检索数据，它只是定义要使用的 SELECT语句。
2、一旦声明后，必须打开游标以供使用。这个过程用前面定义的SELECT语句把数据实际检索出来。
3、对于填有数据的游标，根据需要取出（检索）各行。
4、在结束游标使用时，必须关闭游标。
在声明游标后，可根据需要频繁地打开和关闭游标。在游标打开后，可根据需要频繁地执行取操作。

创建游标
游标用 DECLARE语句创建。 DECLARE命名游标，并定义相应的 SELECT语句，根据需要带WHERE和其他子句。例如，下面的语句定义了名为 ordnums的游标，使用了可以检索所有订单的 SELECT语句。

mysql> delimiter //  #分隔符设置成//
mysql> create procedure duhuo() #创建存储过程
    -> begin
    -> declare ordnums cursor #创建游标
    -> for
    -> select order_num from orders;
    -> end
    -> //

DECLARE语句用来定义和命名游标，这里为 ordnums。存储过程处理完成后，游标就消失（因为它局限于存储过程）。在我们定义了游标之后。可以打开它。

打开与关闭游标
游标使用OPEN CURSOR语句来打开。如下：
OPEN ordnums;
在处理 OPEN语句时执行查询，存储检索出的数据以供浏览和滚动。

游标处理完成后，应当使用如下语句关闭游标：
close ordnums;
CLOSE释放游标使用的所有内部内存和资源，因此在每个游标不再需要时都应该关闭。
在一个游标关闭后，如果没有重新打开，则不能使用它。但是，使用声明过的游标不需要再次声明，用 OPEN语句打开它就可以了。此外mysql具有隐含关闭功能。如果你不明确关闭游标， MySQL将会在到达END语句时自动关闭它。

如下例子：修改版本

mysql> delimiter //
mysql> create procedure duhuo1()
    -> begin
    -> declare dudu cursor
    -> for
    -> select order_num from orders;
    -> open dudu;   #打开游标
    -> close dudu;  #关闭游标
    -> end
    -> //

这个存储过程声明、打开和关闭一个游标。但对检索出的数据什么也没做。

使用游标数据
在一个游标被打开后，可以使用 FETCH语句分别访问它的每一行。FETCH指定检索什么数据，检索出来的数据存储在什么地方。它还向前移动游标中的内部行指针，使下一条FETCH语句检索下一行（不重复读取同一行）。

第一个例子从游标中检索单个行（第一行）：

mysql> delimiter //
mysql>  create procedure demo0()
    -> begin
    -> declare tx int;  #申明int类型变量tx
    -> declare du1 cursor
    -> for
    -> select order_num from orders;
    -> open du1;
    -> fetch du1 into tx; #将第一行的内容写入到tx变量中
    -> close du1;
    -> end
    -> //
Query OK, 0 rows affected (0.02 sec)

其中 FETCH用来检索当前行的order_num列（将自动从第一行开始）到一个名为 tx的局部声明的变量中。对检索出的数据不做任何处理。

在下一个例子中，循环检索数据，从第一行到最后一行：

mysql> create procedure demo0()  #创建存储过程
    -> begin
    -> delcare done boolean default 0; #申明bool型变量done，默认为0
    -> declare du int;
    -> declare ordernu cursor
    -> for
    -> select order_num from orders;
    -> declare continue handler for sqlstate '02000' set done = 1; #SQLSTATE '02000'是一个未找到条件，当没有更多的行供循环时，出现这个条件。
    -> open ordernu;
    -> repeat #循环执行
    -> fetch ordernu into du;
    -> until done end repeat; #如果done为1结束循环
    -> close ordernu;
    -> end//

与前一个例子一样，这个例子使用 FETCH检索当前order_num到声明的名为 du的变量中。但与前一个例子不一样的是，这个例子中的 FETCH是在REPEAT 内，因此它反复执行直到 done为真（由UNTIL done END REPEAT;规定）。为使它起作用，用一个 DEFAULT 0（默认为假，不结束）定义变量 done。那么，done 怎样才能在结束时被设置为真呢？答案是用以下语句：

declare continue handler for sqlstate '02000' set done = 1;

这条语句定义了一个 CONTINUE HANDLER，它是在条件出现时被执行的代码。这里，它指出当 SQLSTATE '02000'出现时，SET done=1 。SQLSTATE '02000'是一个未找到条件，当REPEAT由于没有更多的行供循环而不能继续时，出现这个条件。

关于MySQL 5使用的 MySQL错误代码列表，请参阅 [http://dev.mysql.com/doc/mysql/en/error-handling.html](http://dev.mysql.com/doc/mysql/en/error-handling.html) 。

注意：DECLARE语句存在特定的次序。用DECLARE语句定义的局部变量必须在定义任意游标或句柄之前定义，而句柄必须在游标之后定义。不遵守此顺序将产生错误消息。

为了把这些内容组织起来，下面给出我们的游标存储过程样例的更进一步修改的版本，这次对取出的数据进行某种实际的处理：

mysql> delimiter //
mysql> create procedure liwei()
    -> begin
    -> declare done boolean default 0;
    -> declare t int;
    -> declare li int;
    -> declare wei decimal(8,2);
    -> declare numb cursor
    -> for
    -> select order_num from orders;
    -> declare continue handler for sqlstate '02000' set done=1;
    -> create table if not exists ordertotals #创建表
    -> (order_num int,total decimal(8,2)); # 列
    -> open numb;
    -> repeat
    -> fetch ordernumbers into li;
    -> call ordertotal(tx,1,t);#用CALL 执行另一个存储过程（我们在前一章中创建）来计算每个订单的带税的合计（结果存储到 t）
    -> insert into ordertotals(order_num, total)
    -> values(li,wei);
    -> until done end repeat;
    -> close numd;
    -> end
    -> //

在这个例子中，我们增加了另一个名为 t的变量（存储每个订单的合计）。此存储过程还在运行中创建了一个新表（如果它不存在的话），名为 ordertotals。这个表将保存存储过程生成的结果。 FETCH像以前一样取每个 order_num，然后用CALL 执行另一个存储过程（我们在前一章中创建）来计算每个订单的带税的合计（结果存储到 t）。最后，用INSERT保存每个订单的订单号和合计。

调用存储过程：

call liwei();

此存储过程不返回数据，但它能够创建和填充另一个表，可以用一条简单的 SELECT语句查看该表：

select *from ordertotals;
输出：

+----------------+--------------+| order_num | total |+----------------+--------------+| 20005 | 158.56 || 20006 | 25.78 || 20007 | 1068.00 | +----------------+--------------+
这样，我们就得到了存储过程、游标、逐行处理以及存储过程调用其他存储过程的一个完整的工作样例。