描述

FETCH 使用先前创建的游标检索行。

游标有一个关联的位置，该位置由 FETCH 使用。游标位置可以在查询结果的第一行之前，在结果的任何特定行上，或在结果的最后一行之后。创建时，游标位于第一行之前。获取某些行后，游标将定位在最近检索到的行上。如果 FETCH 超出可用行的范围，则游标将保留在最后一行之后的位置，或者如果向后获取则保留在第一行之前的位置。FETCH ALL 或 FETCH BACKWARD ALL 将始终使游标定位在最后一行之后或第一行之前。

形式 NEXT、PRIOR、FIRST、LAST、ABSOLUTE、RELATIVE 在适当移动游标后获取一行。如果没有这样的行，则返回空结果，并且游标将保留在第一行之前或最后一行之后的位置，具体取决于情况。

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

RELATIVE 0、FORWARD 0 和 BACKWARD 0 都请求获取当前行而不移动游标，即重新获取最近获取的行。这将成功，除非游标位于第一行之前或最后一行之后；在这种情况下，不返回任何行。

参数

输出

成功完成时，FETCH 命令将返回以下形式的命令标签：

FETCH count

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

注释

如果打算使用 FETCH 的任何变体（而不是 FETCH NEXT 或 FETCH FORWARD 以及正数计数），则应使用 SCROLL 选项声明游标。对于简单的查询，PostgreSQL 将允许从未用 SCROLL 声明的游标中进行向后获取，但最好不要依赖此行为。如果游标用 NO SCROLL 声明，则不允许向后获取。

ABSOLUTE 获取并不比使用相对移动导航到所需行快：底层实现无论如何都必须遍历所有中间行。负绝对获取更糟糕：查询必须读取到末尾才能找到最后一行，然后从那里向后遍历。但是，倒回查询的开头（如使用 FETCH ABSOLUTE 0）速度很快。

DECLARE 用于定义游标。使用 MOVE 更改游标位置而不检索数据。

示例

以下示例使用游标遍历表

BEGIN WORK;

-- Set up a cursor:
DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films;

-- Fetch the first 5 rows in the cursor liahona:
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 the previous row:
FETCH PRIOR FROM liahona;

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

-- Close the cursor and end the transaction:
CLOSE liahona;
COMMIT WORK;

兼容性

SQL 标准仅定义了在嵌入式 SQL 中使用 FETCH。此处描述的 FETCH 的变体将数据返回，就像它是 SELECT 结果一样，而不是将其放入主机变量中。除了这一点之外，FETCH 与 SQL 标准完全向上兼容。

涉及 FORWARD 和 BACKWARD 的 FETCH 形式，以及 FETCH count 和 FETCH ALL 形式（其中 FORWARD 是隐式的）是 PostgreSQL 扩展。

SQL 标准仅允许 FROM 在游标名称之前；使用 IN 或完全省略它们的选项是扩展。

另请参阅