他のバージョンの文書10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

FETCH

名前

FETCH -- カーソルを使用したテーブルからの行の抽出

概要

FETCH [ direction { FROM | IN } ] cursorname

ここで、directionは空か以下のいずれかです。
    NEXT
    PRIOR
    FIRST
    LAST
    ABSOLUTE count
    RELATIVE count
    count
    ALL
    FORWARD
    FORWARD count
    FORWARD ALL
    BACKWARD
    BACKWARD count
    BACKWARD ALL

説明

FETCHは事前に作成されたカーソルを使用して行を取り出します。

カーソルは関連する位置情報を持ち、FETCHはこれを使用します。 カーソル位置は問い合わせの結果の先頭行の前、結果内の任意の特定の行、結果の最終行の後を取ることができます。 生成時、カーソルの位置は先頭行の前を指しています。 行を取り出した後、カーソルの位置は最近に取り出した行を指します。 FETCHが利用可能な行の終わりまで達した時、カーソルの位置は最終行の後を、もし、後方抽出の場合は先頭行の前を指し続けます。 FETCH ALLもしくはFETCH BACKWARD ALLでは、カーソルの位置は常に最終行の後、もしくは、先頭行の前を指しています。

NEXTPRIORFIRSTLASTABSOLUTERELATIVE形式では、カーソルを適切に移動した後、1つの行を取り出します。 行が存在しない場合、空の結果が返され、カーソルはそのまま先頭行の前か最終行の後を指し続けます。

FORWARDおよびBACKWARDを使用した形式では、指定数の行を前方もしくは後方方向に取り出し、カーソルの位置は最後に取り出した行を指します。 (countが利用可能な行数を越えていた場合は、全行の後/前を指します。)

RELATIVE 0FORWARD 0、およびBACKWARD 0は全て、カーソルを移動すること無く現在の行を取り出します。 つまり、最も最近取り出した行を再度取り出します。 カーソルが先頭行の前や最終行の後になければ、これは成功します。 カーソルが先頭行の前や最終行の後にあれば、行は返されません。

パラメータ

direction

directionは、取り出す方向と取り出す行数を定義します。 以下のいずれかを取ることができます。

NEXT

次の行を取り出します。 これは、directionが省略された時のデフォルトです。

PRIOR

前の行を取り出します。

FIRST

問い合わせの先頭行を取り出します。 (ABSOLUTE 1 と同一です。)

LAST

問い合わせの最終行を取り出します。 (ABSOLUTE -1と同一です。)

ABSOLUTE count

問い合わせのcount番目の行を取り出します。 もし、countが負ならば、終わりからabs(count)番目の行を取り出します。 countが範囲外の場合、位置は先頭行の前か最終行の後になります。 特に、ABSOLUTE 0では先頭行の前を指すようになります。

RELATIVE count

現在位置からcount番目の行を取り出します。 countが負の場合、現在位置よりabs(count)行前の行を取り出します。 RELATIVE 0は、もし現在の行があれば、その行を再度取り出します。

count

次のcount行を取り出します。 (FORWARD countと同一です。)

ALL

残る行を全て取り出します。 (FORWARD ALLと同一です。)

FORWARD

次の行を取り出します。 (NEXTと同一です。)

FORWARD count

次のcount行を取り出します。 FORWARD 0は現在の行を再度取り出します。

FORWARD ALL

残る行を全て取り出します。

BACKWARD

前の行を取り出します。 (PRIORと同一です。)

BACKWARD count

前のcount行を(後方向に走査して)取り出します。 BACKWARD 0は現在の行を再度取り出します。

BACKWARD ALL

全ての前の行を(後方向に走査して)取り出します。

count

取り出す位置や行数を決定するcountは、整数定数で、符号を付けることができます。 FORWARDBACKWARDの場合、負のcountは、FORWARDBACKWARDの意味を変更することと同じです。

cursorname

開いているカーソルの名前です。

出力

正常に終了すると、FETCHコマンドは以下の形式のコマンドタグを返します。

FETCH count

countは(0を含む)取り出した行数です。 psqlは取り出した行数を別途表示しますので、psqlでは、このコマンドタグは実際には表示されないことに注意してください。

注釈

FETCH NEXTもしくはFETCH FORWARD以外の種類のFETCHを使用しようとする場合、そのカーソルをSCROLLオプション付きで宣言しなければなりません。 単純な問い合わせでは、PostgreSQLにより、カーソルがSCROLL付きで宣言されていなくても後方向の取り出しを行うことができますが、この動作に依存すべきではありません。 カーソルがNO SCROLL付きで宣言された場合は、後方向の取り出しを行うことができません。

相対的な指定による指定行への移動に比べ、ABSOLUTEによる取り出しは高速ではありません。 内部の実装では、必ず中間の行を移動するからです。 負の絶対指定による取り出しでは、もっと悪化します。 最終行を見付けるために必ず最後まで問い合わせを読み取らなければならず、そして、その後に最終行から後方に移動しますためです。 ただし、(FETCH ABSOLUTE 0を使用して)問い合わせの先頭へ戻る時には高速です。

現在、PostgreSQLでは、カーソルを使用したデータの更新をサポートしていません。

DECLAREを使用してカーソルを定義します。 データを取り出さずにカーソル位置を変更する場合はMOVEを使用してください。

以下の例では、カーソルを使用してテーブル内を行き来します。

BEGIN WORK;

-- カーソルを設定します。
DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films;

-- liahonaカーソルから最初の5行を取り出します。

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 PRIOR FROM liahona;

 code  |  title  | did | date_prod  |  kind  |  len
-------+---------+-----+------------+--------+-------
 P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08

-- カーソルを閉じ、トランザクションを終了します。
CLOSE liahona;
COMMIT WORK;

互換性

標準SQLでは、埋め込みSQLでの使用のみでFETCHを定義しています。 ここで説明した各種のFETCHは、ホスト変数に代入されるのではなく、SELECTの結果であるかのようにデータを返します。 この点を除き、FETCHは完全に標準SQLと上位互換性があります。

FORWARDBACKWARDを持つFETCHの形式や、暗黙的なFORWARDを持つFETCH countFETCH ALLPostgreSQLの拡張です。

標準SQLではカーソル名の前にFROMのみを付けることができます。 INを使用するオプションは拡張です。

関連項目

CLOSE, DECLARE, MOVE