File Manager

Hackfut Security File Manager

Current Path: /opt/alt/postgresql11/usr/share/man/man7

opt / alt / postgresql11 / usr / share / man / man7 /

📁 ..
📄 ABORT.7(2.2 KB)
📄 ALTER_AGGREGATE.7(3.53 KB)
📄 ALTER_COLLATION.7(2.8 KB)
📄 ALTER_CONVERSION.7(2.9 KB)
📄 ALTER_DATABASE.7(5.28 KB)
📄 ALTER_DEFAULT_PRIVILEGES.7(6.39 KB)
📄 ALTER_DOMAIN.7(6.79 KB)
📄 ALTER_EXTENSION.7(6.54 KB)
📄 ALTER_FOREIGN_DATA_WRAPPER.7(4.37 KB)
📄 ALTER_FOREIGN_TABLE.7(7.6 KB)
📄 ALTER_FUNCTION.7(7.62 KB)
📄 ALTER_GROUP.7(3 KB)
📄 ALTER_INDEX.7(4.51 KB)
📄 ALTER_LANGUAGE.7(2.1 KB)
📄 ALTER_LARGE_OBJECT.7(1.97 KB)
📄 ALTER_OPERATOR.7(3.01 KB)
📄 ALTER_OPERATOR_CLASS.7(2.85 KB)
📄 ALTER_OPERATOR_FAMILY.7(9.09 KB)
📄 ALTER_ROLE.7(8.23 KB)
📄 ALTER_SCHEMA.7(2.31 KB)
📄 ALTER_SEQUENCE.7(7.52 KB)
📄 ALTER_SERVER.7(3.4 KB)
📄 ALTER_TABLE.7(30.51 KB)
📄 ALTER_TABLESPACE.7(3.27 KB)
📄 ALTER_TEXT_SEARCH_CONFIGURATION.7(4.8 KB)
📄 ALTER_TEXT_SEARCH_DICTIONARY.7(4.03 KB)
📄 ALTER_TEXT_SEARCH_PARSER.7(2.27 KB)
📄 ALTER_TEXT_SEARCH_TEMPLATE.7(2.31 KB)
📄 ALTER_TRIGGER.7(2.51 KB)
📄 ALTER_TYPE.7(6.87 KB)
📄 ALTER_USER.7(2.49 KB)
📄 ALTER_USER_MAPPING.7(3.28 KB)
📄 ALTER_VIEW.7(3.89 KB)
📄 ANALYZE.7(7.52 KB)
📄 BEGIN.7(4.08 KB)
📄 CHECKPOINT.7(2.32 KB)
📄 CLOSE.7(2.76 KB)
📄 CLUSTER.7(6.26 KB)
📄 COMMENT.7(9 KB)
📄 COMMIT.7(2.12 KB)
📄 COMMIT_PREPARED.7(2.61 KB)
📄 COPY.7(26.12 KB)
📄 CREATE_AGGREGATE.7(9.44 KB)
📄 CREATE_CAST.7(14.07 KB)
📄 CREATE_COLLATION.7(4.01 KB)
📄 CREATE_CONVERSION.7(3.82 KB)
📄 CREATE_DATABASE.7(7.86 KB)
📄 CREATE_DOMAIN.7(5.37 KB)
📄 CREATE_EXTENSION.7(5.67 KB)
📄 CREATE_FOREIGN_DATA_WRAPPER.7(5.08 KB)
📄 CREATE_FOREIGN_TABLE.7(4.7 KB)
📄 CREATE_FUNCTION.7(21.62 KB)
📄 CREATE_GROUP.7(2.17 KB)
📄 CREATE_INDEX.7(18.72 KB)
📄 CREATE_LANGUAGE.7(9.86 KB)
📄 CREATE_OPERATOR.7(6.92 KB)
📄 CREATE_OPERATOR_CLASS.7(8.54 KB)
📄 CREATE_OPERATOR_FAMILY.7(3.64 KB)
📄 CREATE_ROLE.7(12.18 KB)
📄 CREATE_RULE.7(7.91 KB)
📄 CREATE_SCHEMA.7(5.4 KB)
📄 CREATE_SEQUENCE.7(9.11 KB)
📄 CREATE_SERVER.7(3.68 KB)
📄 CREATE_TABLE.7(39.83 KB)
📄 CREATE_TABLESPACE.7(3.52 KB)
📄 CREATE_TABLE_AS.7(7.94 KB)
📄 CREATE_TEXT_SEARCH_CONFIGURATION.7(3.25 KB)
📄 CREATE_TEXT_SEARCH_DICTIONARY.7(3.39 KB)
📄 CREATE_TEXT_SEARCH_PARSER.7(3.61 KB)
📄 CREATE_TEXT_SEARCH_TEMPLATE.7(3.43 KB)
📄 CREATE_TRIGGER.7(15.11 KB)
📄 CREATE_TYPE.7(28.33 KB)
📄 CREATE_USER.7(2.48 KB)
📄 CREATE_USER_MAPPING.7(3.31 KB)
📄 CREATE_VIEW.7(7.13 KB)
📄 DEALLOCATE.7(2.05 KB)
📄 DECLARE.7(10.26 KB)
📄 DELETE.7(7.39 KB)
📄 DISCARD.7(2.53 KB)
📄 DO.7(3.13 KB)
📄 DROP_AGGREGATE.7(2.58 KB)
📄 DROP_CAST.7(2.29 KB)
📄 DROP_COLLATION.7(2.34 KB)
📄 DROP_CONVERSION.7(2.4 KB)
📄 DROP_DATABASE.7(2.41 KB)
📄 DROP_DOMAIN.7(2.25 KB)
📄 DROP_EXTENSION.7(2.64 KB)
📄 DROP_FOREIGN_DATA_WRAPPER.7(2.52 KB)
📄 DROP_FOREIGN_TABLE.7(2.5 KB)
📄 DROP_FUNCTION.7(3.27 KB)
📄 DROP_GROUP.7(1.6 KB)
📄 DROP_INDEX.7(2.99 KB)
📄 DROP_LANGUAGE.7(2.77 KB)
📄 DROP_OPERATOR.7(2.9 KB)
📄 DROP_OPERATOR_CLASS.7(3.38 KB)
📄 DROP_OPERATOR_FAMILY.7(3.16 KB)
📄 DROP_OWNED.7(3.02 KB)
📄 DROP_ROLE.7(3.08 KB)
📄 DROP_RULE.7(2.2 KB)
📄 DROP_SCHEMA.7(2.55 KB)
📄 DROP_SEQUENCE.7(2.38 KB)
📄 DROP_SERVER.7(2.3 KB)
📄 DROP_TABLE.7(2.88 KB)
📄 DROP_TABLESPACE.7(2.51 KB)
📄 DROP_TEXT_SEARCH_CONFIGURATION.7(2.76 KB)
📄 DROP_TEXT_SEARCH_DICTIONARY.7(2.67 KB)
📄 DROP_TEXT_SEARCH_PARSER.7(2.58 KB)
📄 DROP_TEXT_SEARCH_TEMPLATE.7(2.61 KB)
📄 DROP_TRIGGER.7(2.52 KB)
📄 DROP_TYPE.7(2.43 KB)
📄 DROP_USER.7(1.68 KB)
📄 DROP_USER_MAPPING.7(2.59 KB)
📄 DROP_VIEW.7(2.34 KB)
📄 END.7(2.21 KB)
📄 EXECUTE.7(2.96 KB)
📄 EXPLAIN.7(12.89 KB)
📄 FETCH.7(8.52 KB)
📄 GRANT.7(21.41 KB)
📄 INSERT.7(8.74 KB)
📄 LISTEN.7(3.53 KB)
📄 LOAD.7(2.58 KB)
📄 LOCK.7(7.92 KB)
📄 MOVE.7(2.96 KB)
📄 NOTIFY.7(7.96 KB)
📄 PREPARE.7(6.2 KB)
📄 PREPARE_TRANSACTION.7(5.77 KB)
📄 REASSIGN_OWNED.7(3.08 KB)
📄 REINDEX.7(7.85 KB)
📄 RELEASE_SAVEPOINT.7(3.06 KB)
📄 RESET.7(2.96 KB)
📄 REVOKE.7(10.46 KB)
📄 ROLLBACK.7(2.12 KB)
📄 ROLLBACK_PREPARED.7(2.64 KB)
📄 ROLLBACK_TO_SAVEPOINT.7(4.01 KB)
📄 SAVEPOINT.7(3.55 KB)
📄 SECURITY_LABEL.7(5.29 KB)
📄 SELECT.7(52.77 KB)
📄 SELECT_INTO.7(4.53 KB)
📄 SET.7(7.46 KB)
📄 SET_CONSTRAINTS.7(4.56 KB)
📄 SET_ROLE.7(4.38 KB)
📄 SET_SESSION_AUTHORIZATION.7(3.92 KB)
📄 SET_TRANSACTION.7(8.44 KB)
📄 SHOW.7(4.25 KB)
📄 START_TRANSACTION.7(2.93 KB)
📄 TABLE.7(18 B)
📄 TRUNCATE.7(6.24 KB)
📄 UNLISTEN.7(2.77 KB)
📄 UPDATE.7(10.63 KB)
📄 VACUUM.7(7.09 KB)
📄 VALUES.7(6.97 KB)
📄 WITH.7(18 B)

Editing: FETCH.7

'\" t
.\"     Title: FETCH
.\"    Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 2017-11-06
.\"    Manual: PostgreSQL 9.2.24 Documentation
.\"    Source: PostgreSQL 9.2.24
.\"  Language: English
.\"
.TH "FETCH" "7" "2017-11-06" "PostgreSQL 9.2.24" "PostgreSQL 9.2.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
FETCH \- retrieve rows from a query using a cursor
.\" FETCH
.\" cursor: FETCH
.SH "SYNOPSIS"
.sp
.nf
FETCH [ \fIdirection\fR [ FROM | IN ] ] \fIcursor_name\fR

where \fIdirection\fR can be empty or one of:

NEXT
    PRIOR
    FIRST
    LAST
    ABSOLUTE \fIcount\fR
    RELATIVE \fIcount\fR
    \fIcount\fR
    ALL
    FORWARD
    FORWARD \fIcount\fR
    FORWARD ALL
    BACKWARD
    BACKWARD \fIcount\fR
    BACKWARD ALL
.fi
.SH "DESCRIPTION"
.PP
\fBFETCH\fR
retrieves rows using a previously\-created cursor\&.
.PP
A cursor has an associated position, which is used by
\fBFETCH\fR\&. The cursor position can be before the first row of the query result, on any particular row of the result, or after the last row of the result\&. When created, a cursor is positioned before the first row\&. After fetching some rows, the cursor is positioned on the row most recently retrieved\&. If
\fBFETCH\fR
runs off the end of the available rows then the cursor is left positioned after the last row, or before the first row if fetching backward\&.
\fBFETCH ALL\fR
or
\fBFETCH BACKWARD ALL\fR
will always leave the cursor positioned after the last row or before the first row\&.
.PP
The forms
NEXT,
PRIOR,
FIRST,
LAST,
ABSOLUTE,
RELATIVE
fetch a single row after moving the cursor appropriately\&. If there is no such row, an empty result is returned, and the cursor is left positioned before the first row or after the last row as appropriate\&.
.PP
The forms using
FORWARD
and
BACKWARD
retrieve the indicated number of rows moving in the forward or backward direction, leaving the cursor positioned on the last\-returned row (or after/before all rows, if the
\fIcount\fR
exceeds the number of rows available)\&.
.PP
RELATIVE 0,
FORWARD 0, and
BACKWARD 0
all request fetching the current row without moving the cursor, that is, re\-fetching the most recently fetched row\&. This will succeed unless the cursor is positioned before the first row or after the last row; in which case, no row is returned\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
This page describes usage of cursors at the SQL command level\&. If you are trying to use cursors inside a
PL/pgSQL
function, the rules are different \(em see
Section 39.7, \(lqCursors\(rq, in the documentation\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
\fIdirection\fR
.RS 4
\fIdirection\fR
defines the fetch direction and number of rows to fetch\&. It can be one of the following:
.PP
NEXT
.RS 4
Fetch the next row\&. This is the default if
\fIdirection\fR
is omitted\&.
.RE
.PP
PRIOR
.RS 4
Fetch the prior row\&.
.RE
.PP
FIRST
.RS 4
Fetch the first row of the query (same as
ABSOLUTE 1)\&.
.RE
.PP
LAST
.RS 4
Fetch the last row of the query (same as
ABSOLUTE \-1)\&.
.RE
.PP
ABSOLUTE \fIcount\fR
.RS 4
Fetch the
\fIcount\fR\*(Aqth row of the query, or the
abs(\fIcount\fR)\*(Aqth row from the end if
\fIcount\fR
is negative\&. Position before first row or after last row if
\fIcount\fR
is out of range; in particular,
ABSOLUTE 0
positions before the first row\&.
.RE
.PP
RELATIVE \fIcount\fR
.RS 4
Fetch the
\fIcount\fR\*(Aqth succeeding row, or the
abs(\fIcount\fR)\*(Aqth prior row if
\fIcount\fR
is negative\&.
RELATIVE 0
re\-fetches the current row, if any\&.
.RE
.PP
\fIcount\fR
.RS 4
Fetch the next
\fIcount\fR
rows (same as
FORWARD \fIcount\fR)\&.
.RE
.PP
ALL
.RS 4
Fetch all remaining rows (same as
FORWARD ALL)\&.
.RE
.PP
FORWARD
.RS 4
Fetch the next row (same as
NEXT)\&.
.RE
.PP
FORWARD \fIcount\fR
.RS 4
Fetch the next
\fIcount\fR
rows\&.
FORWARD 0
re\-fetches the current row\&.
.RE
.PP
FORWARD ALL
.RS 4
Fetch all remaining rows\&.
.RE
.PP
BACKWARD
.RS 4
Fetch the prior row (same as
PRIOR)\&.
.RE
.PP
BACKWARD \fIcount\fR
.RS 4
Fetch the prior
\fIcount\fR
rows (scanning backwards)\&.
BACKWARD 0
re\-fetches the current row\&.
.RE
.PP
BACKWARD ALL
.RS 4
Fetch all prior rows (scanning backwards)\&.
.RE
.RE
.PP
\fIcount\fR
.RS 4
\fIcount\fR
is a possibly\-signed integer constant, determining the location or number of rows to fetch\&. For
FORWARD
and
BACKWARD
cases, specifying a negative
\fIcount\fR
is equivalent to changing the sense of
FORWARD
and
BACKWARD\&.
.RE
.PP
\fIcursor_name\fR
.RS 4
An open cursor\*(Aqs name\&.
.RE
.SH "OUTPUTS"
.PP
On successful completion, a
\fBFETCH\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
FETCH \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows fetched (possibly zero)\&. Note that in
psql, the command tag will not actually be displayed, since
psql
displays the fetched rows instead\&.
.SH "NOTES"
.PP
The cursor should be declared with the
SCROLL
option if one intends to use any variants of
\fBFETCH\fR
other than
\fBFETCH NEXT\fR
or
\fBFETCH FORWARD\fR
with a positive count\&. For simple queries
PostgreSQL
will allow backwards fetch from cursors not declared with
SCROLL, but this behavior is best not relied on\&. If the cursor is declared with
NO SCROLL, no backward fetches are allowed\&.
.PP
ABSOLUTE
fetches are not any faster than navigating to the desired row with a relative move: the underlying implementation must traverse all the intermediate rows anyway\&. Negative absolute fetches are even worse: the query must be read to the end to find the last row, and then traversed backward from there\&. However, rewinding to the start of the query (as with
FETCH ABSOLUTE 0) is fast\&.
.PP
\fBDECLARE\fR(7)
is used to define a cursor\&. Use
\fBMOVE\fR(7)
to change cursor position without retrieving data\&.
.SH "EXAMPLES"
.PP
The following example traverses a table using a cursor:
.sp
.if n \{\
.RS 4
.\}
.nf
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;

\-\- Close the cursor and end the transaction:
CLOSE liahona;
COMMIT WORK;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard defines
\fBFETCH\fR
for use in embedded SQL only\&. The variant of
\fBFETCH\fR
described here returns the data as if it were a
\fBSELECT\fR
result rather than placing it in host variables\&. Other than this point,
\fBFETCH\fR
is fully upward\-compatible with the SQL standard\&.
.PP
The
\fBFETCH\fR
forms involving
FORWARD
and
BACKWARD, as well as the forms
FETCH \fIcount\fR
and
FETCH ALL, in which
FORWARD
is implicit, are
PostgreSQL
extensions\&.
.PP
The SQL standard allows only
FROM
preceding the cursor name; the option to use
IN, or to leave them out altogether, is an extension\&.
.SH "SEE ALSO"
\fBCLOSE\fR(7), \fBDECLARE\fR(7), \fBMOVE\fR(7)

Hackfut Security File Manager

Editing: FETCH.7

Upload File

Create Folder