バージョンごとのドキュメント一覧

SPI_scroll_cursor_fetch

SPI_scroll_cursor_fetch <refpurpose>fetch some rows from a cursor</refpurpose> — カーソルから一部の行を取り出す

概要

void SPI_scroll_cursor_fetch(Portal portal, FetchDirection direction,
                             long count)

説明

<title>Description</title>

<function>SPI_scroll_cursor_fetch</function> fetches some rows from a cursor. This is equivalent to the SQL command <command>FETCH</command>. SPI_scroll_cursor_fetchはカーソルから行の一部を取り出します。 これはSQLコマンドFETCHと等価です。

引数

<title>Arguments</title>
Portal portal

portal containing the cursor カーソルを含むポータル

FetchDirection direction

one of <symbol>FETCH_FORWARD</symbol>, <symbol>FETCH_BACKWARD</symbol>, <symbol>FETCH_ABSOLUTE</symbol> or <symbol>FETCH_RELATIVE</symbol> FETCH_FORWARDFETCH_BACKWARDFETCH_ABSOLUTEFETCH_RELATIVEのいずれか

long count

number of rows to fetch for <symbol>FETCH_FORWARD</symbol> or <symbol>FETCH_BACKWARD</symbol>; absolute row number to fetch for <symbol>FETCH_ABSOLUTE</symbol>; or relative row number to fetch for <symbol>FETCH_RELATIVE</symbol> FETCH_FORWARDまたはFETCH_BACKWARDでは取り出す行数。 FETCH_ABSOLUTEでは取り出す行の絶対番号。 FETCH_RELATIVEでは取り出す行の相対的番号。

戻り値

<title>Return Value</title>

<varname>SPI_processed</varname> and <varname>SPI_tuptable</varname> are set as in <function>SPI_execute</function> if successful. 成功時、SPI_execute同様にSPI_processedSPI_tuptableが設定されます。

注釈

<title>Notes</title>

See the SQL <xref linkend="sql-fetch"/> command for details of the interpretation of the <parameter>direction</parameter> and <parameter>count</parameter> parameters. directionパラメータおよびcountパラメータの解釈の詳細についてはSQL FETCHコマンドを参照してください。

Direction values other than <symbol>FETCH_FORWARD</symbol> may fail if the cursor's plan was not created with the <symbol>CURSOR_OPT_SCROLL</symbol> option. カーソルの計画がCURSOR_OPT_SCROLLオプション付きで作成されていない場合、FETCH_FORWARD以外の方向値は失敗する可能性があります。