FETCH
FETCH — 用游标获取行
用法
FETCH [ selector ] [ count ] { IN | FROM } cursor
FETCH [ RELATIVE ] [ { [ # | ALL | NEXT | PRIOR ] } ] FROM ] cursor
输入
-
selector
-
selector 定义抓取的方向.它可以是下述之一:
-
FORWARD
-
抓取后面的行.selector 省略时这是缺省值.
-
BACKWARD
-
抓取前面行.
-
RELATIVE
-
为 SQL92 兼容设置的多余键字.
-
count
-
count 决定抓取几行.可以是下列之一:
-
#
-
一个表明抓取几行的整数.注意负整数等效于改变 FORWARD 和 BACKWARD 属性.
-
ALL
-
检索所有剩余的行.
-
NEXT
-
等效于声明 count 为 1.
-
PRIOR
-
等效于声明 count 为 -1.
-
cursor
一个打开的游标的名称.
输出
FETCH 返回由声明的游标定义的查询的结果.如果查询失败,将返回下面的信息:
-
NOTICE: PerformPortalFetch: portal "cursor" not found
-
如果 cursor 没有定义,返回此信息.游标必须在一个事务块中定义.
-
NOTICE: FETCH/ABSOLUTE not supported, using RELATIVE
-
Postgres 不支持游标的绝对定位.
-
ERROR: FETCH/RELATIVE at current position is not supported
-
SQL92 允许我们用下面语句在"当前位置"不停地检索游标
FETCH RELATIVE 0 FROM cursor
Postgres 目前不支持这种用法;实际上,零被保留用于检索所有行,等效于声明
ALL 关键字.如果使用 RELATIVE 关键字, Postgres
假设用户试图使用 SQL92 的特性,因而返回此错误.
描述
FETCH 允许用户使用游标检索行.所要检索的行数用 # 声明.如果游标中剩下的行小于
#,那么只有那些可用的抓过来.用关键字 ALL 代替数字将导致游标中所有剩余行被抓过来.记录可以
FORWARD (向前)抓,也可以 BACKWARD (向后)抓.缺省的方向是 FORWARD (向前).
小技巧: 可以用负数作为行记数,符号等效于颠倒抓取方向关键字(FORWARD
和 BACKWARD).例如, FORWARD -1 等效于 BACKWARD 1.
注意
注意 FORWARD 和 BACKWARD 关键字是
Postgres扩展.
SQL92
语法也支持,在此命令的第二种形式中声明.详细的兼容性信息见下面.
在游标中更新数据还不被 Postgres
支持,因为将游标更新影射回基本表是不太可能的,这一点对 VIEW 更新也一样.因而用户必须显式的使用
UPDATE 命令来更新数据.
游标只能用于事务内部,因为它们存储的数据跨越了多个用户的查询.
使用 MOVE 语句改变游标位置.使用
DECLARE 语句定义一个游标.使用
BEGIN,COMMIT,和
ROLLBACK 语句获取更多关于事务的信息.
用法
下面的例子用一个游标跨过一个表。
-- 建立一个游标:
BEGIN WORK;
DECLARE liahona CURSOR FOR SELECT * FROM films;
-- 抓取头 5 行到游标 liahona 里:
FETCH FORWARD 5 IN 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 BACKWARD 1 IN liahona;
code | title | did | date_prod | kind | len
-------+---------+-----+------------+--------+-------
P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08
-- 关闭游标并提交工作:
CLOSE liahona;
COMMIT WORK;
兼容性
SQL92
注意:非嵌入式游标的使用是 Postgres
扩展.游标的语法和用途与定义与 SQL92里定义的嵌入式用法相似。
SQL92 允许游标在 FETCH 中的绝对定位,并且允许将结果放在显式的变量里.
FETCH ABSOLUTE #
FROM cursor
INTO :variable [, ...]
-
ABSOLUTE
-
游标将放置在写明的绝对的行数的位置上.在 Postgres
中所有的行数都是相对数量,所以这一功能不支持.
-
:variable