FETCH
Retrieves rows from a cursor.
Synopsis
FETCH direction [ count ] { IN | FROM } cursor direction ::= { FORWARD | BACKWARD | RELATIVE } count ::= { numrows | ALL | NEXT | PRIOR }
Parameters
directionUse the optional
directionparameter to specify the direction you want to fetch. It may be specified as any of the following keywords:FORWARDThe keyword used to retrieve rows following the current position. This is the default, if the
directionis not explicitly set.BACKWARDThe keyword used to retrieve rows preceding the current position.
RELATIVEA noise term made available for SQL92 compatibility. As of PostgreSQL 7.1.x, all cursors locate rows relative to the current cursor position, and this keyword therefore has no effect. Note that combining the
RELATIVEkeyword with acountof 0 will produce an error (see the “Results” section later in this reference entry).
countThis parameter takes the number of rows you wish to fetch. You can specify an integer constant here to have a specific number of rows fetched (
numrows), or use any of the following keywords:ALLThe keyword used to retrieve all rows.
NEXTThe keyword used to retrieve the row immediately following the current position.
PRIORThe keyword used to retrieve the row immediately preceding the current position.
cursorThe name of an open cursor you wish to use for the
FETCH.
Results
A successful FETCH command returns any query results generated by the
specified cursor. If the query fails, one of the following messages will be displayed: