↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

MOVE

定位游标

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

6.46.57.07.17.27.37.48.08.18.28.38.49.09.19.29.39.49.59.61011121314151617181920
anchor
SQL-MOVE
file
sql-move.html
lang
en
name
MOVE
purpose
position a cursor
purpose zh
未知
sections same as
未知
slug
18
synopsis text
MOVE [ direction ] [ FROM | IN ] cursor_name where direction can be one of: NEXT PRIOR FIRST LAST ABSOLUTE count RELATIVE count count ALL FORWARD FORWARD count FORWARD ALL BACKWARD BACKWARD count BACKWARD ALL

语法

MOVE [ direction ] [ FROM | IN ] cursor_name
where direction can be one of:

NEXT
PRIOR
FIRST
LAST
ABSOLUTE count
RELATIVE count
count
ALL
FORWARD
FORWARD count
FORWARD ALL
BACKWARD
BACKWARD count
BACKWARD ALL
语法图

从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。

MOVE 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

版本定义 PG 18

MOVE [ 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

描述

MOVE在不检索任何数据的情况下重新定位游标。MOVE与FETCH命令的工作方式完全相同，只是它只定位游标而不返回行。

MOVE命令的参数与FETCH命令完全相同；有关语法和用法的细节，请参阅FETCH。

输出

成功完成时，MOVE命令会返回如下形式的命令标签：

MOVE count

其中count是用相同参数执行 FETCH命令时本应返回的行数（可能为零）。

示例

BEGIN WORK;
DECLARE liahona CURSOR FOR SELECT * FROM films;

-- 跳过前 5 行：
MOVE FORWARD 5 IN liahona;
MOVE 5

-- 从游标 liahona 中提取第 6 行：
FETCH 1 FROM liahona;
 code  | title  | did | date_prod  |  kind  |  len
-------+--------+-----+------------+--------+-------
 P_303 | 48 Hrs | 103 | 1982-10-22 | Action | 01:37
(1 row)

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

兼容性

SQL 标准中没有MOVE语句。

另见

CLOSE, DECLARE, FETCH

比较版本

完整来源事实

synopsis html

MOVE [ <em class="replaceable"><code>direction</code></em> ] [ FROM | IN ] <em class="replaceable"><code>cursor_name</code></em>

<span class="phrase">where <em class="replaceable"><code>direction</code></em> can be one of:</span>

    NEXT
    PRIOR
    FIRST
    LAST
    ABSOLUTE <em class="replaceable"><code>count</code></em>
    RELATIVE <em class="replaceable"><code>count</code></em>
    <em class="replaceable"><code>count</code></em>
    ALL
    FORWARD
    FORWARD <em class="replaceable"><code>count</code></em>
    FORWARD ALL
    BACKWARD
    BACKWARD <em class="replaceable"><code>count</code></em>
    BACKWARD ALL

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c