【MySQL】使 用 游 标

游标

MySQL检索操作返回一组称为结果集的行。这组返回的行都是与SQL语句相匹配的行（零行或多行）。使用简单的SELECT语句，例如，没有办法得到第一行、下一行或前10行，也不存在每次一行地处理所有行的简单方法（相对于成批地处理它们）。

有时，需要在检索出来的行中前进或后退一行或多行。这就是使用游标的原因。 游标（ cursor） 是一个存储在MySQL服务器上的数据库查询，它不是一条SELECT语句，而是被该语句检索出来的结果集。在存储了游标之后，应用程序可以根据需要滚动或浏览其中的数据。

游标主要用于交互式应用，其中用户需要滚动屏幕上的数据，并对数据进行浏览或做出更改。

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

使用游标

使用游标涉及几个明确的步骤。

• 在能够使用游标前，必须声明它，这个过程实际上没有检索数据，它只是定义要使用的SELECT语句。
• 一旦声明后，必须打开游标以供使用。这个使用过程用前面定义的SELECT语句把数据实际检索出来。
• 对于填有数据的游标，根据需要检索各行。
• 在结束游标使用时，必须关闭游标。

在声明游标后，可根据需要频繁地打开和关闭游标。在游标打开后，可根据需要频繁地执行取操作。

创建游标

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

CREATE PROCEDURE processorders () BEGIN
-- decalre the cursor 声明游标
DECLARE
	ordernumbers CURSOR FOR SELECT
	order_num 
FROM
	orders;
END;

这个存储过程并没有做很多事情， DECLARE语句用来定义和命名游标，这里为ordernumbers。 存储过程处理完成后，游标就消失（因为它局限于存储过程）。

在定义游标之后，可以打开它。

打开和关闭游标

游标用OPEN CURSOR语句来打开

OPEN ordernumbers;

在处理OPEN语句时执行查询，存储检索出的数据以供浏览和滚动。

游标处理完成后，应当使用如下语句关闭游标：

CLOSE ordernumbers;

CLOSE释放游标使用的所有内部内存和资源，因此在每个游标不再需要时都应该关闭。

在一个游标关闭后，如果没有重新打开，则不能使用它。但是，使用声明过的游标不需要再次声明，用OPEN语句打开它就可以了。

隐含关闭 如果你不明确关闭游标， MySQL将会在到达END语句时自动关闭它。

下面是前面例子的修改版本：

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

CREATE PROCEDURE processorders ( ) BEGIN
DECLARE
	ordernumbers CURSOR FOR SELECT
	order_num 
FROM
	orders;
OPEN ordernumbers;
CLOSE ordernumbers;
END;

使用游标数据

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

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

CREATE PROCEDURE processorders ( ) BEGIN
DECLARE
	ordernumbers CURSOR FOR SELECT
	order_num 
FROM
	orders;
OPEN ordernumbers;
FETCH ordernumbers INTO o;
CLOSE ordernumbers;
END;

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

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

CREATE PROCEDURE processorders () BEGIN
-- declare local variables 声明局部变量
DECLARE
	done boolean DEFAULT 0;
DECLARE
	o INT;
-- decalre the cursor 声明游标
DECLARE
	ordernumbers CURSOR FOR SELECT
	order_num 
FROM
	orders;
-- declare continue handler
DECLARE
	CONTINUE HANDLER FOR SQLSTATE '02000' 
	SET done = 1;
-- SQLSTATE '02000'是一个未找到条件，当REPEAT由于没有更多的行供循环而不能继续时，出现这个条件。
-- open the cursor 打开游标
OPEN ordernumbers;
-- loop through all rows 遍历所有行
REPEAT
-- get order number 获得订单号
	FETCH ordernumbers INTO o;
-- FETCH在REPEAT内，因此它反复执行直到done为真
-- end of loop
UNTIL done 
END REPEAT;
-- close the cursor 关闭游标
CLOSE ordernumbers;
END;

与前一个例子一样，这个例子使用FETCH检索当前order_num到声明的名为o的变量中。但与前一个例子不一样的是，这个例子中的FETCH是在REPEAT内，因此它反复执行直到done为真（由UNTILdone 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由于没有更多的行供循环而不能继续时，出现这个条件。

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

如 果 调 用 这 个 存 储 过 程 ， 它 将 定 义 几 个 变 量 和 一 个 CONTINUE HANDLER，定义并打开一个游标，重复读取所有行，然后关闭游标。如果一切正常，你可以在循环内放入任意需要的处理（在FETCH语句之后，循环结束之前）。

重复或循环？ 除这里使用的REPEAT语句外， MySQL还支持循环语句，它可用来重复执行代码，直到使用LEAVE语句手动退出为止。通常REPEAT语句的语法使它更适合于对游标进行循环。

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

CREATE PROCEDURE processorders ( ) BEGIN
-- declare local variables 声明局部变量
DECLARE
	done boolean DEFAULT 0;
DECLARE
	o INT;
DECLARE
	t DECIMAL ( 8, 2 );
-- declare the cursor 声明游标
DECLARE
	ordernumbers CURSOR FOR SELECT
	order_num 
FROM
	orders;
-- declare continue handler
DECLARE
	CONTINUE HANDLER FOR SQLSTATE '02000' 
	SET done = 1;
-- create a table to store the results 新建表以保存数据
CREATE TABLE
IF
	NOT EXISTS ordertotals ( order_num INT, total DECIMAL ( 8, 2 ) );
-- open the cursor 打开游标
OPEN ordernumbers;
-- loop through all rows 遍历所有行
REPEAT
-- get order number 获取订单号
	FETCH ordernumbers INTO o;
-- get the total for this order 计算订单金额
CALL ordertotal ( o, 1, t );
-- insert order and total into ordertotals 将订单号、金额插入表ordertotals内
INSERT INTO ordertotals ( order_num, total )
VALUES
	( o, t );
-- end of loop
UNTIL done 
END REPEAT;
-- close the cursor 关闭游标
CLOSE ordernumbers;

END;

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

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

select * from ordernumbers;

这样，我们就得到了存储过程、游标、逐行处理以及存储过程调用其他存储过程的一个完整的工作样例