PL/pgSQL/エラー時のメッセージ出力

エラー時のメッセージ出力・RAISE EXCEPTION†

前回の記事「ターミナルにメッセージ出力」では、levelがEXCEPTIONを除くRAISEのサンプルおよび動作を紹介しました。
今回は、EXCEPTIONのサンプルおよび動作を紹介します。
(先に結論を書きますと、EXCEPTIONの場合、ROLLBACKされます。)

エラー時のメッセージ出力・RAISE EXCEPTION
RAISEの動作確認
まとめ

↑

RAISEの動作確認†

RAISEの構文について以下に記します。
前回の記事のraise_sample.sqlを少々改造し、データをINSERTするようにします。

↑

テスト用テーブルの作成†

t1.sql

CREATE TABLE t1 (
     i  int
    ,t  text
);

↑

EXCEPTIONを除いたRAISEのサンプルおよび実行†

以下のコマンドで、上記のテーブルを作成しました。

$ psql -U sakura sakuradb -f t1.sql 
CREATE TABLE

EXCEPTIONを除いたサンプルソースは以下のようになります。

raise1.sql

CREATE OR REPLACE FUNCTION raise1()
RETURNS
    void
AS $$
DECLARE
    foo text := 'foo';
    bar int  := 123;
BEGIN
    INSERT INTO t1 VALUES(1,'foo'),(2,'bar'),(3,'hoge');
    RAISE DEBUG   'DEBUG RAISE MESSAGE';
    RAISE LOG     'LOG RAISE MESSAGE';
    RAISE INFO    'INFO RAISE MESSAGE %', foo;
    RAISE NOTICE  'NOTICE RAISE MESSAGE %,%', foo, bar;
    RAISE WARNING 'WARNING RAISE MESSAGE';
END
$$ LANGUAGE plpgsql
;

raise1()の登録および実行してみます。
本サンプルは上記に記したt1テーブルがすでに作成されていることが前提です。

データベースに接続

$ psql -U sakura sakuradb
psql (9.3.14)
Type "help" for help.

t1テーブルに何も無いことを確認しています。

sakuradb=# select count(*) from t1;
 count 
-------
     0
(1 row)

raise1.sqlを登録しています。

sakuradb=# \i raise1.sql
CREATE FUNCTION

raise1()ファンクションを実行します。

sakuradb=# select raise1();
INFO:  INFO RAISE MESSAGE foo
NOTICE:  NOTICE RAISE MESSAGE foo,123
WARNING:  WARNING RAISE MESSAGE
 raise1 
--------
 
(1 row)

t1テーブルの内容を確認します。
```
sakuradb=# select * from t1;
 i |  t   
---+------
 1 | foo
 2 | bar
 3 | hoge
(3 rows)
```
上記の実行結果の通り、3件INSERTされているのが確認できます。

↑

RAISE EXCEPTIONのサンプルおよび実行†

本題となるEXCEPTIONの動作確認を行います。
本ファンクションは、上記と同様にt1テーブルが作成されていることが前提です。

raise_exp.sql

CREATE OR REPLACE FUNCTION raise_exp()
RETURNS
    void
AS $$
DECLARE
BEGIN
    INSERT INTO t1 VALUES(1,'exp_foo'),(2,'exp_bar'),(3,'exp_hoge');
    RAISE EXCEPTION 'EXCEPTION RAISE MESSAGE';
END
$$ LANGUAGE plpgsql
;

上記の通り、RAISEのレベルにEXCEPTIONを指定しています。
以下に登録および実行結果を記します。

raise_exp.sqlを登録します。

sakuradb=# \i raise_exp.sql
CREATE FUNCTION

t1テーブルのレコードをすべて削除します。

sakuradb=# delete from t1;
DELETE 3
sakuradb=# select * from t1;
 i | t 
---+---
(0 rows)

raise_exp()を実行します。 ERROR: メッセージで表示されているのが確認できます。
```
sakuradb=# select raise_exp();
ERROR:  EXCEPTION RAISE MESSAGE
```
t1テーブルの内容を確認します。
INSERTされていないことが確認できます。
```
sakuradb=# select * from t1;
 i | t 
---+---
(0 rows)
```

以上の結果の通り、デフォルトであるオートコミット状態でRAISE EXCEPTIONが実行されるとROLLBACKされているのが確認できます。

↑

後作業†

本記事で作成した、raise1(), raise_exp(), t1 をDROPします。

sakuradb=# drop function raise1();
DROP FUNCTION
sakuradb=# drop function raise_exp();
DROP FUNCTION
sakuradb=# drop table t1;
DROP TABLE

↑

まとめ†

RAISE EXCEPTION するとROLLBACKされる
EXCEPTION以外のレベルを指定すると、COMMITされている

以上、RAISE EXCEPTION についての記事でした。

[smile] PL/pgSQL入門ページに戻る

オンライン数 : 4

↑

ご利用にあたり

↑