21 使用游标

21.1 游标

在存储过程中使用游标可以对一个结果集进行移动遍历。

游标主要用于交互式应用，其中用户需要对数据集中的任意行进行浏览和修改。

21.2 使用游标

使用游标的四个步骤：

声明游标，这个过程没有实际检索出数据，它只是定义要使用的SELECT语句；
打开游标；
取出数据；
关闭游标。

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

21.2.1 创建游标

游标用DECLARE语句创建。

例如下面的例子定义了名为ordernumbers的游标，使用了可以检索所有订单的SELECT语句。

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

DECLARE语句用来定义和命名游标，这里为ordernumbers。存储过程处理完成后，游标就消失。在定义游标之后，可以打开它。

21.2.2 打开和关闭游标

游标用OPEN CURSOR语句来打开：

OPEN ordernumbers;

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

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

CLOSE ordernumbers;

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

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

21.2.3 使用游标数据

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

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

CREATE PROCEDURE processorders()
BEGIN
    --Declare local variables
    DECLARE o INT;

    --Declare the cursor
    DECLARE ordernumbers CURSOR
    FOR
    SELECT order_num FROM orders;

    --Open the cursor
    OPEN oedernumbers;

    --Get order number
    FETCH ordernumbers INTO o;

    --Close the cursor
    CLOSE ordernumbers;

END;

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

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

CREATE PROCEDURE processorders()
BEGIN

    --Declare local variables
    DECLARE done BOOLEAN DEFAULT 0;
    DECLARE o INT;

    --Declare the cursor
    DECLARE ordernumbers CURSOR
    FOR
    SELECT order_num FROM orders;
    
    -- 定义了一个 continue handler，当 sqlstate '02000' 这个条件出现时，会执行 set done = 1
    DECLARE CONTINUE HANDLER FOR SQLSTATE '02000' SET done = 1;

    --Open the cursor
    OPEN ordernumbers;

    --Loop through all rows
    REPEAT

        --Get order number
        FETCH ordernumbers INTO o;

    --End of loop
    UNTIL done END REPEAT;

    --Close the cursor
    CLOSE ordernumbers;
END

这个例子使用FETCH检索当前order_num到声明的名为o的变量中。但与前一个例子不一样的是，这个例子中的FETCH是在REPEAT内，因此它反复执行直到done为真。为使它起作用，用一个DEFAULT 0

定义变量done。

那么， done怎样才能在结束时被设置为真呢？

DECLARE CONTINUE HANDLER FOR SQLSTATE '02000' SET done = 1;