FETCH命令的语法参数与使用游标检索行示例-云原生数据库 PolarDB-阿里云

本文介绍了FETCH的语法、参数以及示例等内容。

简介

FETCH从之前创建的一个游标中检索行。

游标具有一个相关联的位置，FETCH会用到该位置。游标位置可能会位于查询结果的第一行之前、结果中任一行之上或者结果的最后一行之后。在被创建时，游标被定位在第一行之前。在取出一些行后，该游标被定位在最近被取出的行上。如果 FETCH运行超过了可用行的末尾，则该游标会被定位在最后一行之后（如果向后取，则是第一行之前）。 FETCH ALL或者FETCH BACKWARD ALL将总是让游标被定位于最后一行之后或者第一行之前。

NEXT、PRIOR、FIRST、 LAST、ABSOLUTE、RELATIVE 形式会在适当移动游标后取出一行。如果没有这样一行，将返回一个空结果，并且视情况将游标定位在第一行之前或者最后一行之后。

使用FORWARD和BACKWARD的形式会在向前移动或者向后移动的方向上检索指定数量的行，然后将游标定位在最后返回的行上（如果 count超过可用的行数，则定位在所有行之后或者之前）。

RELATIVE 0、FORWARD 0以及 BACKWARD 0都会请求检索当前行但不移动游标，也就是重新取最近被取出的行。只要游标没有被定位在第一行之前或者最后一行之后，这种操作都会成功，否则不会返回任何行。

语法

    FETCH [ direction [ FROM | IN ] ] cursor_name

    其中 direction 可以为空或者以下之一：

        NEXT
        PRIOR
        FIRST
        LAST
        ABSOLUTE count
        RELATIVE count
        count
        ALL
        FORWARD
        FORWARD count
        FORWARD ALL
        BACKWARD
        BACKWARD count
        BACKWARD ALL

说明

这个页面描述在 SQL 命令层面上对游标的使用。如果想要在 PL/SQL函数中使用游标，规则会有所不同。

参数

directiondirection 定义获取方向以及要取得的行数。它可以是下列之一：
NEXT取出下一行。如果省略 direction，这将是默认值。
PRIOR取出当前位置之前的一行。
FIRST取出该查询的第一行（和ABSOLUTE 1相同）。
LAST取出该查询的最后一行（和ABSOLUTE -1相同）。
ABSOLUTE count取出该查询的第 count个行，如果 count为负则是从尾部开始取出第abs( count )个行。如果 count超出范围，将定位在第一行之前或者最后一行之后。特别地，ABSOLUTE 0 会定位在第一行之前。
RELATIVE count取出第 count个后继行，如果 count为负则是取出前面的第abs( count )个行。 RELATIVE 0重新取出当前行（如果有）。
count取出接下来的 count行（和 FORWARD count相同）。
ALL取出所有剩余的行（和FORWARD ALL相同）。
FORWARD取出下一行（和NEXT相同）。
FORWARD count取出接下来的 count行。 FORWARD 0重新取出当前行。
FORWARD ALL取出所有剩下的行。
BACKWARD取出当前行前面的一行（和PRIOR相同）。
BACKWARD count取出前面的 count行（反向扫描）。 BACKWARD 0会重新取出当前行。
BACKWARD ALL取出所有当前位置之前的行（反向扫描）。
countcount 是一个可能带有符号的整数常量，它决定要取得的位置或者行数。对于 FORWARD和BACKWARD情况，指定一个负的 count等效于改变 FORWARDhe BACKWARD的意义。
cursor_name一个已打开游标的名称。

输出

如果成功完成，FETCH命令返回一个下面形式的命令标签：

    FETCH count

count是取得的行数（可能为零）。注意在psql中，命令标签将不会实际显示，因为psql会显示被取得的行。

说明

如果想要使用FETCH的任意变体而不使用带有正计数的 FETCH NEXT或者FETCH FORWARD，应该用SCROLL声明游标。对于简单查询， PolarDB将允许从不带 SCROLL的游标中反向取得行，但最好不要依赖这种行为。如果游标被声明为带有SCROLL，则不允许反向取得。

用ABSOLUTE取行并不比用相对移动快多少：不管怎样，底层实现都必须遍历所有的中间行。用负绝对值获取的情况更糟：必须读到查询尾部来找到最后一行，并且接着从那里反向开始遍历。不过，回卷到查询的开始（正如FETCH ABSOLUTE 0）是很快的。

DECLARE被用来定义游标。使用 MOVE可改变游标位置而不检索数据。

示例

下面的例子用一个游标遍历一个表：

    BEGIN WORK;

    -- 建立一个游标：
    DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films;

    -- 在游标 liahona 中取出前 5 行：
    FETCH FORWARD 5 FROM liahona;

     code  |          title          | did | date_prod  |   kind   |  len
    -------+-------------------------+-----+------------+----------+-------
     BL101 | The Third Man           | 101 | 1949-12-23 | Drama    | 01:44
     BL102 | The African Queen       | 101 | 1951-08-11 | Romantic | 01:43
     JL201 | Une Femme est une Femme | 102 | 1961-03-12 | Romantic | 01:25
     P_301 | Vertigo                 | 103 | 1958-11-14 | Action   | 02:08
     P_302 | Becket                  | 103 | 1964-02-03 | Drama    | 02:28

    -- 取出前面一行：
    FETCH PRIOR FROM liahona;

     code  |  title  | did | date_prod  |  kind  |  len
    -------+---------+-----+------------+--------+-------
     P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08

    -- 关闭游标并且结束事务：
    CLOSE liahona;
    COMMIT WORK;