RETURN expression;

<command>RETURN</command> with an expression terminates the function and returns the value of <replaceable>expression</replaceable> to the caller. This form is used for <application>PL/pgSQL</application> functions that do not return a set. 式を持つRETURNは関数を終了し、expressionの値を呼び出し元に返します。 この形式は集合を返さないPL/pgSQL関数で使用されます。

In a function that returns a scalar type, the expression's result will automatically be cast into the function's return type as described for assignments. But to return a composite (row) value, you must write an expression delivering exactly the requested column set. This may require use of explicit casting. スカラ型を返す関数において、代入のところで説明したように、式の結果は自動的に関数の戻り値の型にキャストされます。 しかし、複合（行）値を返すためには、要求された列集合を正確に導出する式を記述しなければなりません。 これにより、明示的なキャストの使用が必要となることがあります。

If you declared the function with output parameters, write just <command>RETURN</command> with no expression. The current values of the output parameter variables will be returned. 出力パラメータを持った関数を宣言した時は、式の無いRETURNを記述してください。 その時点における出力パラメータの値が返されます。

If you declared the function to return <type>void</type>, a <command>RETURN</command> statement can be used to exit the function early; but do not write an expression following <command>RETURN</command>. voidを返すように関数を宣言した場合でも、関数を直ちに抜け出すためにRETURNを使用できますが、RETURNの後に式を記述しないでください。

The return value of a function cannot be left undefined. If control reaches the end of the top-level block of the function without hitting a <command>RETURN</command> statement, a run-time error will occur. This restriction does not apply to functions with output parameters and functions returning <type>void</type>, however. In those cases a <command>RETURN</command> statement is automatically executed if the top-level block finishes. 関数の戻り値は未定義とさせたままにすることはできません。 制御が、RETURN文が見つからない状態で関数の最上位のブロックの終わりまで達した時、実行時エラーが発生します。 しかし、この制限は出力パラメータを持った関数及びvoidを返す関数には当てはまりません。 このような場合は最上位のブロックが終わった時、RETURN文が自動的に実行されます。

Some examples: 例を示します。

-- functions returning a scalar type

-- スカラ型を返す関数
RETURN 1 + 2;
RETURN scalar_var;


-- functions returning a composite type

-- 複合型を返す関数
RETURN composite_type_var;

RETURN (1, 2, 'three'::text);  -- must cast columns to correct types

RETURN (1, 2, 'three'::text);  -- 正しい型の列にキャストしなければなりません

RETURN NEXT expression;
RETURN QUERY query;
RETURN QUERY EXECUTE command-string [ USING expression [, ... ] ];

When a <application>PL/pgSQL</application> function is declared to return <literal>SETOF <replaceable>sometype</replaceable></literal>, the procedure to follow is slightly different. In that case, the individual items to return are specified by a sequence of <command>RETURN NEXT</command> or <command>RETURN QUERY</command> commands, and then a final <command>RETURN</command> command with no argument is used to indicate that the function has finished executing. <command>RETURN NEXT</command> can be used with both scalar and composite data types; with a composite result type, an entire <quote>table</quote> of results will be returned. <command>RETURN QUERY</command> appends the results of executing a query to the function's result set. <command>RETURN NEXT</command> and <command>RETURN QUERY</command> can be freely intermixed in a single set-returning function, in which case their results will be concatenated. PL/pgSQL関数がSETOF sometypeを返すように宣言した場合、後続の処理が多少違います。 この場合、戻り値の個々の項目は、RETURN NEXTコマンドまたはRETURN QUERYコマンドで指定されます。 そして、引数のない最後のRETURNコマンドにより、関数が実行を終了したことが示されます。 RETURN NEXTは、スカラ型および複合型の両方で使用することができます。 複合型の場合、結果の「テーブル」全体が返されます。 RETURN QUERYは、問い合わせを実行した結果を関数の結果集合に追加します。 RETURN NEXTとRETURN QUERYは、単一の集合を返す関数の中で自由に混合できます。 この場合、連結されたものが結果となります。

<command>RETURN NEXT</command> and <command>RETURN QUERY</command> do not actually return from the function &mdash; they simply append zero or more rows to the function's result set. Execution then continues with the next statement in the <application>PL/pgSQL</application> function. As successive <command>RETURN NEXT</command> or <command>RETURN QUERY</command> commands are executed, the result set is built up. A final <command>RETURN</command>, which should have no argument, causes control to exit the function (or you can just let control reach the end of the function). 実際には、RETURN NEXTおよびRETURN QUERYは関数から戻りません。 単に関数の結果集合に行を追加しているだけです。 そして、その実行はPL/pgSQL関数内の次の文に継続します。 RETURN NEXTまたはRETURN QUERYコマンドが連続して実行されると、結果集合が作成されます。 最後の、引数を持ってはならないRETURNにより、関数の終了を制御します (または制御を関数の最後に移すことができます)。

<command>RETURN QUERY</command> has a variant <command>RETURN QUERY EXECUTE</command>, which specifies the query to be executed dynamically. Parameter expressions can be inserted into the computed query string via <literal>USING</literal>, in just the same way as in the <command>EXECUTE</command> command. RETURN QUERYにはRETURN QUERY EXECUTEという亜種があり、それは問い合わせが動的に実行されることを指定します。 パラメータ式を、EXECUTEコマンド内と全く同じように、USINGによって演算された問い合わせ文字列に挿入することができます。

If you declared the function with output parameters, write just <command>RETURN NEXT</command> with no expression. On each execution, the current values of the output parameter variable(s) will be saved for eventual return as a row of the result. Note that you must declare the function as returning <literal>SETOF record</literal> when there are multiple output parameters, or <literal>SETOF <replaceable>sometype</replaceable></literal> when there is just one output parameter of type <replaceable>sometype</replaceable>, in order to create a set-returning function with output parameters. 出力パラメータを持つ関数を宣言した時は、式の無いRETURN NEXTだけを記述してください。 実行の度に、その時点における出力パラメータの値が、関数からの戻り値のために結果の行として保存されます。 出力パラメータを持つ集合を返す関数を作成するためには、出力パラメータが複数の時はSETOF recordを返すように関数を宣言し、単一のsometype型の出力パラメータの時はSETOF sometypeを返すように関数を宣言しなければならないことに注意してください。

Here is an example of a function using <command>RETURN NEXT</command>: RETURN NEXTを使用する関数の例を以下に示します。

CREATE TABLE foo (fooid INT, foosubid INT, fooname TEXT);
INSERT INTO foo VALUES (1, 2, 'three');
INSERT INTO foo VALUES (4, 5, 'six');

CREATE OR REPLACE FUNCTION get_all_foo() RETURNS SETOF foo AS
$BODY$
DECLARE
    r foo%rowtype;
BEGIN
    FOR r IN
        SELECT * FROM foo WHERE fooid > 0
    LOOP

        -- can do some processing here
        RETURN NEXT r; -- return current row of SELECT

        -- ここで処理を実行できます
        RETURN NEXT r; -- SELECTの現在の行を返します
    END LOOP;
    RETURN;
END;
$BODY$
LANGUAGE plpgsql;

SELECT * FROM get_all_foo();

Here is an example of a function using <command>RETURN QUERY</command>: RETURN QUERYを使用する関数の例を以下に示します。

CREATE FUNCTION get_available_flightid(date) RETURNS SETOF integer AS
$BODY$
BEGIN
    RETURN QUERY SELECT flightid
                   FROM flight
                  WHERE flightdate >= $1
                    AND flightdate < ($1 + 1);


    &#45;- Since execution is not finished, we can check whether rows were returned
    &#45;- and raise exception if not.

-- 実行が終わっていないので、行が返されたか検査して、行がなければ例外を発生させます。
    IF NOT FOUND THEN
        RAISE EXCEPTION 'No flight at %.', $1;
    END IF;

    RETURN;
 END;
$BODY$
LANGUAGE plpgsql;


&#45;- Returns available flights or raises exception if there are no
&#45;- available flights.

-- 利用できるフライトを返し、フライトがない場合は例外を発生させます。
SELECT * FROM get_available_flightid(CURRENT_DATE);

IF boolean-expression THEN
    statements
END IF;

<literal>IF-THEN</literal> statements are the simplest form of <literal>IF</literal>. The statements between <literal>THEN</literal> and <literal>END IF</literal> will be executed if the condition is true. Otherwise, they are skipped. IF-THEN文は最も単純なIFの形式です。 THENとEND IFの間の文が条件が真の場合に実行されます。 さもなければそれらは飛ばされます。

Example: 例：

IF v_user_id <> 0 THEN
    UPDATE users SET email = v_email WHERE user_id = v_user_id;
END IF;

IF boolean-expression THEN
    statements
ELSE
    statements
END IF;

<literal>IF-THEN-ELSE</literal> statements add to <literal>IF-THEN</literal> by letting you specify an alternative set of statements that should be executed if the condition is not true. (Note this includes the case where the condition evaluates to NULL.) IF-THEN-ELSE文はIF-THENに加え、条件評価が偽の場合に実行すべき代替となる文の集合を指定することができます。 （これには条件がNULLと評価した場合も含まれることに注意してください。）

Examples: 例：

IF parentid IS NULL OR parentid = ''
THEN
    RETURN fullname;
ELSE
    RETURN hp_true_filename(parentid) || '/' || fullname;
END IF;

IF v_count > 0 THEN
    INSERT INTO users_count (count) VALUES (v_count);
    RETURN 't';
ELSE
    RETURN 'f';
END IF;

IF boolean-expression THEN
    statements
[ ELSIF boolean-expression THEN
    statements
[ ELSIF boolean-expression THEN
    statements
    ...
]
]
[ ELSE
    statements ]
END IF;

Sometimes there are more than just two alternatives. <literal>IF-THEN-ELSIF</literal> provides a convenient method of checking several alternatives in turn. The <literal>IF</literal> conditions are tested successively until the first one that is true is found. Then the associated statement(s) are executed, after which control passes to the next statement after <literal>END IF</literal>. (Any subsequent <literal>IF</literal> conditions are <emphasis>not</emphasis> tested.) If none of the <literal>IF</literal> conditions is true, then the <literal>ELSE</literal> block (if any) is executed. 選択肢が２つだけではなくより多くになる場合があります。 IF-THEN-ELSIFは、順番に複数の代替手段を検査する、より便利な方法を提供します。 IF条件は最初の真である結果が見つかるまで連続して検査されます。 そして関連した文が実行され、その後END IF以降の次の文に制御が渡されます。 （以降にあるIF条件の検査はすべて実行されません。） 全てのIF条件が真でない場合、ELSEブロックが（もし存在すれば）実行されます。

Here is an example: 以下に例を示します。

IF number = 0 THEN
    result := 'zero';
ELSIF number > 0 THEN
    result := 'positive';
ELSIF number < 0 THEN
    result := 'negative';
ELSE

    &#45;- hmm, the only other possibility is that number is null

    -- ふうむ、残る唯一の可能性はその値がNULLであることだ
    result := 'NULL';
END IF;

The key word <literal>ELSIF</literal> can also be spelled <literal>ELSEIF</literal>. ELSIFキーワードはELSEIFのように書くことができます。

An alternative way of accomplishing the same task is to nest <literal>IF-THEN-ELSE</literal> statements, as in the following example: 同じ作業を遂行する別の方法は、以下の例のようにIF-THEN-ELSE文を入れ子にすることです。

IF demo_row.sex = 'm' THEN
    pretty_sex := 'man';
ELSE
    IF demo_row.sex = 'f' THEN
        pretty_sex := 'woman';
    END IF;
END IF;

However, this method requires writing a matching <literal>END IF</literal> for each <literal>IF</literal>, so it is much more cumbersome than using <literal>ELSIF</literal> when there are many alternatives. しかし、この方法はそれぞれのIFに対応するEND IFの記述が必要です。 従って、多くの選択肢がある場合ELSIFを使用するよりも厄介です。

CASE search-expression
    WHEN expression [, expression [ ... ]] THEN
      statements
  [ WHEN expression [, expression [ ... ]] THEN
      statements
    ... ]
  [ ELSE
      statements ]
END CASE;

The simple form of <command>CASE</command> provides conditional execution based on equality of operands. The <replaceable>search-expression</replaceable> is evaluated (once) and successively compared to each <replaceable>expression</replaceable> in the <literal>WHEN</literal> clauses. If a match is found, then the corresponding <replaceable>statements</replaceable> are executed, and then control passes to the next statement after <literal>END CASE</literal>. (Subsequent <literal>WHEN</literal> expressions are not evaluated.) If no match is found, the <literal>ELSE</literal> <replaceable>statements</replaceable> are executed; but if <literal>ELSE</literal> is not present, then a <literal>CASE_NOT_FOUND</literal> exception is raised. CASEの単純な形式はオペランドの等価性にもとづく条件的実行を提供します。 search-expressionは（一度だけ）評価され、その後WHEN句内のそれぞれのexpressionと比較されます。 一致するものが見つかると、関連したstatementsが実行され、END CASEの次の文に制御が渡されます。 （以降のWHEN式は評価されません。） 一致するものが見つからない場合、ELSE statementsが実行されますが、ELSEが無いときはCASE_NOT_FOUND例外を引き起こします。

Here is a simple example: 以下は簡単な例です。

CASE x
    WHEN 1, 2 THEN
        msg := 'one or two';
    ELSE
        msg := 'other value than one or two';
END CASE;

CASE
    WHEN boolean-expression THEN
      statements
  [ WHEN boolean-expression THEN
      statements
    ... ]
  [ ELSE
      statements ]
END CASE;

The searched form of <command>CASE</command> provides conditional execution based on truth of Boolean expressions. Each <literal>WHEN</literal> clause's <replaceable>boolean-expression</replaceable> is evaluated in turn, until one is found that yields <literal>true</literal>. Then the corresponding <replaceable>statements</replaceable> are executed, and then control passes to the next statement after <literal>END CASE</literal>. (Subsequent <literal>WHEN</literal> expressions are not evaluated.) If no true result is found, the <literal>ELSE</literal> <replaceable>statements</replaceable> are executed; but if <literal>ELSE</literal> is not present, then a <literal>CASE_NOT_FOUND</literal> exception is raised. CASEの検索された形式は論理値式の真の結果に基づく条件付き実行を提供します。 それぞれのWHEN句のboolean-expressionはtrueとなる１つが見つかるまで順番に評価されます。 その後、関連するstatementsが実行され、その結果END CASEの次の文に制御が渡されます。 （以降のWHEN式は評価されません。） 真となる結果が見つからない場合、ELSE statementsが実行されますが、ELSEが存在しないときはCASE_NOT_FOUND例外を引き起こします。

Here is an example: 以下は簡単な例です。

CASE
    WHEN x BETWEEN 0 AND 10 THEN
        msg := 'value is between zero and ten';
    WHEN x BETWEEN 11 AND 20 THEN
        msg := 'value is between eleven and twenty';
END CASE;

This form of <command>CASE</command> is entirely equivalent to <literal>IF-THEN-ELSIF</literal>, except for the rule that reaching an omitted <literal>ELSE</literal> clause results in an error rather than doing nothing. この形式のCASEは、判定基準が省略されたELSE句に達した場合に何もしないのではなくエラーなる点を除き、IF-THEN-ELSIFと全く同一です。

[ <<label>> ]
LOOP
    statements
END LOOP [ label ];

<literal>LOOP</literal> defines an unconditional loop that is repeated indefinitely until terminated by an <literal>EXIT</literal> or <command>RETURN</command> statement. The optional <replaceable>label</replaceable> can be used by <literal>EXIT</literal> and <literal>CONTINUE</literal> statements within nested loops to specify which loop those statements refer to. LOOPは、EXIT文またはRETURN文によって終了されるまで無限に繰り返される、条件なしのループを定義します。 省略可能なlabelは、ネステッドループにおいてEXITおよびCONTINUE文がどのレベルの入れ子を参照するかを指定するために使用されます。

EXIT [ label ] [ WHEN boolean-expression ];

If no <replaceable>label</replaceable> is given, the innermost loop is terminated and the statement following <literal>END LOOP</literal> is executed next. If <replaceable>label</replaceable> is given, it must be the label of the current or some outer level of nested loop or block. Then the named loop or block is terminated and control continues with the statement after the loop's/block's corresponding <literal>END</literal>. labelが指定されない場合、最も内側のループを終わらせ、END LOOPの次の文がその後に実行されます。 labelが指定された場合、それは現在またはその上位のネステッドループやブロックのラベルである必要があります。 その後、指名されたループまたはブロックを終わらせ、そのループまたはブロックの対応するENDの次の文に制御を移します。

If <literal>WHEN</literal> is specified, the loop exit occurs only if <replaceable>boolean-expression</replaceable> is true. Otherwise, control passes to the statement after <literal>EXIT</literal>. WHENが指定された場合、boolean-expressionが真の場合のみループの終了が起こります。 さもなければ、EXITの後の行に制御が移ります。

<literal>EXIT</literal> can be used with all types of loops; it is not limited to use with unconditional loops. EXITは、すべての種類のループと共に使用できます。 条件なしのループでの使用に限定されません。

When used with a <literal>BEGIN</literal> block, <literal>EXIT</literal> passes control to the next statement after the end of the block. Note that a label must be used for this purpose; an unlabeled <literal>EXIT</literal> is never considered to match a <literal>BEGIN</literal> block. (This is a change from pre-8.4 releases of <productname>PostgreSQL</productname>, which would allow an unlabeled <literal>EXIT</literal> to match a <literal>BEGIN</literal> block.) BEGINブロックと共に使用した時、EXITによりブロックの次の文に制御が移ります。 この目的のためにラベルが使用されなければならないことに注意してください。 ラベル無しのEXITはBEGINブロックに対応するとは決して考えられません。 （これは、ラベル無しのEXITがBEGINブロックに対応することを許容するPostgreSQLの8.4より前のリリースからの変更です。）

Examples: 例：

LOOP

    -- some computations

    -- 何らかの演算
    IF count > 0 THEN

        EXIT;  -- exit loop

        EXIT;  -- ループを抜け出す
    END IF;
END LOOP;

LOOP

    -- some computations
    EXIT WHEN count > 0;  -- same result as previous example

-- 何らかの演算
    EXIT WHEN count > 0;  -- 上例と同じ結果
END LOOP;

<<ablock>>
BEGIN

    &#45;- some computations

    -- 何らかの演算
    IF stocks > 100000 THEN

        EXIT ablock;  &#45;- causes exit from the BEGIN block

        EXIT ablock;  -- これによりBEGINブロックを抜け出す
    END IF;

    &#45;- computations here will be skipped when stocks &gt; 100000

    -- stocks > 100000 であればここでの演算は省略
END;

CONTINUE [ label ] [ WHEN boolean-expression ];

If no <replaceable>label</replaceable> is given, the next iteration of the innermost loop is begun. That is, all statements remaining in the loop body are skipped, and control returns to the loop control expression (if any) to determine whether another loop iteration is needed. If <replaceable>label</replaceable> is present, it specifies the label of the loop whose execution will be continued. labelが無い場合、すぐ外側のループの次の繰り返しが開始されます。 すなわち、ループ本体の残りの文は飛ばされて、他のループの繰り返しが必要かどうかを決めるため、制御がループ制御式(もし存在すれば)に戻ります。 labelが存在する場合、実行を継続するループのラベルを指定します。

If <literal>WHEN</literal> is specified, the next iteration of the loop is begun only if <replaceable>boolean-expression</replaceable> is true. Otherwise, control passes to the statement after <literal>CONTINUE</literal>. WHENが指定された場合、boolean-expressionが真の場合のみループにおける次の繰り返しが始まります。 さもなければ、CONTINUEの後の行に制御が移ります。

<literal>CONTINUE</literal> can be used with all types of loops; it is not limited to use with unconditional loops. CONTINUEは全ての種類のループで使用可能です。 条件なしのループに限定されません。

Examples: 例

LOOP

    -- some computations

    -- 何らかの演算
    EXIT WHEN count > 100;
    CONTINUE WHEN count < 50;

    &#45;- some computations for count IN [50 .. 100]

    -- 50から100を数える、何らかの演算
END LOOP;

[ <<label>> ]
WHILE boolean-expression LOOP
    statements
END LOOP [ label ];

The <literal>WHILE</literal> statement repeats a sequence of statements so long as the <replaceable>boolean-expression</replaceable> evaluates to true. The expression is checked just before each entry to the loop body. WHILE文はboolean-expressionの評価が真である間、一連の文を繰り返します。 条件式は、ループ本体に入る前にのみ検査されます。

For example: 以下に例を示します。

WHILE amount_owed > 0 AND gift_certificate_balance > 0 LOOP

    -- some computations here

    -- ここで演算をいくつか行います。
END LOOP;

WHILE NOT done LOOP

    -- some computations here

    -- ここで演算をいくつか行います。
END LOOP;

[ <<label>> ]
FOR name IN [ REVERSE ] expression .. expression [ BY expression ] LOOP
    statements
END LOOP [ label ];

This form of <literal>FOR</literal> creates a loop that iterates over a range of integer values. The variable <replaceable>name</replaceable> is automatically defined as type <type>integer</type> and exists only inside the loop (any existing definition of the variable name is ignored within the loop). The two expressions giving the lower and upper bound of the range are evaluated once when entering the loop. If the <literal>BY</literal> clause isn't specified the iteration step is 1, otherwise it's the value specified in the <literal>BY</literal> clause, which again is evaluated once on loop entry. If <literal>REVERSE</literal> is specified then the step value is subtracted, rather than added, after each iteration. この形式のFORは整数値の範囲内で繰り返すループを生成します。 name変数はinteger型として自動的に定義され、ループ内部のみで存在します （ループ外部で定義しても、ループ内部では全て無視されます）。 範囲の下限、上限として与えられる2つの式はループに入った時に一度だけ評価されます。 BY句を指定しない時の繰り返し刻みは1ですが、BY句を用いて指定でき、ループに入った時に一度だけ評価されます。 REVERSEが指定された場合、繰り返し刻みの値は加算されるのではなく、繰り返しごとに減算されます。

Some examples of integer <literal>FOR</literal> loops: 整数FORループの例を以下に示します。

FOR i IN 1..10 LOOP

    -- i will take on the values 1,2,3,4,5,6,7,8,9,10 within the loop

    -- i はループ内で 1、2、3、4、5、6、7、8、9、10 の値を取ります。
END LOOP;

FOR i IN REVERSE 10..1 LOOP

    -- i will take on the values 10,9,8,7,6,5,4,3,2,1 within the loop

    -- i はループ内で 10、9、8、7、6、5、4、3、2、1 の値を取ります。
END LOOP;

FOR i IN REVERSE 10..1 BY 2 LOOP

    -- i will take on the values 10,8,6,4,2 within the loop

    -- i はループ内で 10、8、6、4、2 の値を取ります。
END LOOP;

If the lower bound is greater than the upper bound (or less than, in the <literal>REVERSE</literal> case), the loop body is not executed at all. No error is raised. 下限が上限よりも大きい（REVERSEの場合はより小さい）場合、ループ本体はまったく実行されません。 エラーは発生しません。

If a <replaceable>label</replaceable> is attached to the <literal>FOR</literal> loop then the integer loop variable can be referenced with a qualified name, using that <replaceable>label</replaceable>. labelをFORループに付加することにより、labelを用いて修飾した名前の整数ループ変数を参照できます。

Exception handlers frequently need to identify the specific error that occurred. There are two ways to get information about the current exception in <application>PL/pgSQL</application>: special variables and the <command>GET STACKED DIAGNOSTICS</command> command. 例外ハンドラはしばしば、起こった特定のエラーを識別する必要があります。 PL/pgSQLで現在の例外に関する情報を取得する方法は2つあります。 特殊な変数とGET STACKED DIAGNOSTICSコマンドです。

Within an exception handler, the special variable <varname>SQLSTATE</varname> contains the error code that corresponds to the exception that was raised (refer to <xref linkend="errcodes-table"/> for a list of possible error codes). The special variable <varname>SQLERRM</varname> contains the error message associated with the exception. These variables are undefined outside exception handlers. 例外ハンドラの内部では、特殊な変数SQLSTATE変数が起こった例外に対応したエラーコード（表 A.1のエラーコード表を参照してください）を保有します。 特殊な変数SQLERRMは例外に関連したエラーメッセージを保有します。 これらの変数は、例外ハンドラの外部では定義されていません。

Within an exception handler, one may also retrieve information about the current exception by using the <command>GET STACKED DIAGNOSTICS</command> command, which has the form: 例外ハンドラの内部では、GET STACKED DIAGNOSTICSコマンドを使用して、現在の例外に関する情報を取り出すこともできます。 次のようなやり方となります。

GET STACKED DIAGNOSTICS variable { = | := } item [ , ... ];

Each <replaceable>item</replaceable> is a key word identifying a status value to be assigned to the specified <replaceable>variable</replaceable> (which should be of the right data type to receive it). The currently available status items are shown in <xref linkend="plpgsql-exception-diagnostics-values"/>. 各itemは、指定されたvariable（これは受け取るために正しいデータ型でなければなりません）に代入される状態値を識別するキーワードです。 現在使用可能なステータス項目は表 43.2に表示されています。

If the exception did not set a value for an item, an empty string will be returned. 例外が項目の値を設定しない場合、空文字列が返されます。

Here is an example: 以下に例を示します。

DECLARE
  text_var1 text;
  text_var2 text;
  text_var3 text;
BEGIN

  -- some processing which might cause an exception

  -- 例外を引き起こす処理
  ...
EXCEPTION WHEN OTHERS THEN
  GET STACKED DIAGNOSTICS text_var1 = MESSAGE_TEXT,
                          text_var2 = PG_EXCEPTION_DETAIL,
                          text_var3 = PG_EXCEPTION_HINT;
END;