139 lines
3.3 KiB
Plaintext
139 lines
3.3 KiB
Plaintext
<refentry id="SQL-MOVE">
|
|
<refmeta>
|
|
<refentrytitle>
|
|
MOVE
|
|
</refentrytitle>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>
|
|
MOVE
|
|
</refname>
|
|
<refpurpose>
|
|
Moves cursor position
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<refsynopsisdivinfo>
|
|
<date>1998-09-24</date>
|
|
</refsynopsisdivinfo>
|
|
<synopsis>
|
|
MOVE [ <replaceable class="PARAMETER">selector</replaceable> ] [ <replaceable class="PARAMETER">count</replaceable> ]
|
|
{ IN | FROM } <replaceable class="PARAMETER">cursor</replaceable>
|
|
FETCH [ RELATIVE ] [ { [ <replaceable class="PARAMETER">#</replaceable> | ALL | NEXT | PRIOR ] } ] FROM ] <replaceable class="PARAMETER">cursor</replaceable>
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1 id="R1-SQL-MOVE-1">
|
|
<refsect1info>
|
|
<date>1998-09-24</date>
|
|
</refsect1info>
|
|
<title>
|
|
Description
|
|
</title>
|
|
<para>
|
|
<command>MOVE</command> allows a user to move cursor position a specified
|
|
number of rows.
|
|
<command>MOVE</command> works like the <command>FETCH</command> command,
|
|
but only positions the cursor and does
|
|
not return rows.
|
|
</para>
|
|
<para>
|
|
Refer to the <command>FETCH</command> command for details on syntax and usage.
|
|
</para>
|
|
|
|
<refsect2 id="R2-SQL-MOVE-3">
|
|
<refsect2info>
|
|
<date>1998-09-24</date>
|
|
</refsect2info>
|
|
<title>
|
|
Notes
|
|
</title>
|
|
<para>
|
|
<command>MOVE</command> is a <productname>Postgres</productname>
|
|
language extension.
|
|
</para>
|
|
<para>
|
|
Refer to <command>FETCH</command> for a description
|
|
of valid arguments.
|
|
Refer to <command>DECLARE</command> to declare a cursor.
|
|
Refer to <command>BEGIN WORK</command>, <command>COMMIT WORK</command>,
|
|
<command>ROLLBACK WORK</command> statements
|
|
for further information about transactions.
|
|
</para>
|
|
</refsect2>
|
|
</refsect1>
|
|
|
|
<refsect1 id="R1-SQL-MOVE-2">
|
|
<title>
|
|
Usage
|
|
</title>
|
|
<para>
|
|
Set up and use a cursor:
|
|
|
|
<programlisting>
|
|
BEGIN WORK;
|
|
DECLARE liahona CURSOR FOR SELECT * FROM films;
|
|
--Skip first 5 rows:
|
|
MOVE FORWARD 5 IN liahona;
|
|
<computeroutput>
|
|
MOVE
|
|
</computeroutput>
|
|
--Fetch 6th row in the cursor liahona:
|
|
FETCH 1 IN liahona;
|
|
<computeroutput>
|
|
FETCH
|
|
|
|
code |title |did| date_prod|kind |len
|
|
-----+------+---+----------+----------+------
|
|
P_303|48 Hrs|103|1982-10-22|Action | 01:37
|
|
(1 row)
|
|
</computeroutput>
|
|
-- close the cursor liahona and commit work:
|
|
CLOSE liahona;
|
|
COMMIT WORK;
|
|
</programlisting>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 id="R1-SQL-MOVE-3">
|
|
<title>
|
|
Compatibility
|
|
</title>
|
|
<para>
|
|
</para>
|
|
|
|
<refsect2 id="R2-SQL-MOVE-4">
|
|
<refsect2info>
|
|
<date>1998-09-01</date>
|
|
</refsect2info>
|
|
<title>
|
|
SQL92
|
|
</title>
|
|
<para>
|
|
There is no SQL92 <command>MOVE</command> statement.
|
|
Instead, <acronym>SQL92</acronym> allows
|
|
one to <command>FETCH</command> rows from an absolute cursor position,
|
|
implicitly moving the cursor to the correct place.
|
|
</para>
|
|
</refsect2>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:nil
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../reference.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:"/usr/lib/sgml/catalog"
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
-->
|