PolarDB:エラー処理

定義済み例外

division_by_zero などの PostgreSQL の定義済み例外と、zero_divide などの Oracle の定義済み例外を使用できます。これらの例外は、SQL ブロック内で発生させたり、キャッチしたりできます。

DECLARE
    result INT;
BEGIN
    result := 1 / 0;
END;
/* ゼロ除算エラーが発生します */

-- PostgreSQL スタイル
BEGIN
    RAISE division_by_zero;
END;
/* division_by_zero 例外が発生します */

-- Oracle スタイル
BEGIN
    RAISE zero_divide;
END;
/* zero_divide 例外が発生します */

-- PostgreSQL スタイル
DECLARE
    result INT;
BEGIN
    result := 1 / 0;
EXCEPTION
    WHEN division_by_zero THEN
        DBMS_OUTPUT.PUT_LINE('division by zero'); /* ゼロ除算例外を処理します */
END;

-- Oracle スタイル
DECLARE
    result INT;
BEGIN
    result := 1 / 0;
EXCEPTION
    WHEN zero_divide THEN
        DBMS_OUTPUT.PUT_LINE('zero divide'); /* ゼロ除算例外を処理します */
END;

DECLARE
    result INT;
BEGIN
    result := 1 / 0;
EXCEPTION
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('division by zero'); /* すべての例外を処理します */
END;

定義されていない例外

Oracle 構文には、名前付きの定義済み例外ではないエラーコードが多数含まれています。これらのエラーを名前で処理するには、例外変数を宣言し、Oracle エラーコードに関連付けます。

プロセスには、次の 3 つのステップが含まれます。

1. DECLARE セクションで、my_exception EXCEPTION; などの例外を宣言します。

2. PRAGMA EXCEPTION_INIT 文を使用して、変数を SQLCODE（PRAGMA EXCEPTION_INIT(my_exception, -1476); など）にバインドします。

   重要

   関連付けられたエラーコードは、100（no_data_found 例外の場合）または -1000000 から -1 までの負の整数である必要があります。 -65535 から -1 までの範囲のみが有効な Oracle SQLCODE にマップされます。

3. EXCEPTION セクションで、WHEN my_exception または WHEN OTHERS を使用して例外をキャッチします。

例

DECLARE
    result INT;
    my_exception EXCEPTION;
    PRAGMA EXCEPTION_INIT(my_exception, -66666); /* 例外を特定のエラーコードに関連付けます */
BEGIN
    result := 1 / 0;
EXCEPTION
    WHEN my_exception THEN
        DBMS_OUTPUT.PUT_LINE('zero divide'); /* 特定の例外を処理します */
END;

カスタム例外（RAISE_APPLICATION_ERROR）

Oracle は、-20999 から -20000 までの整数範囲を 定義済み例外 と 定義されていない例外 用に予約しています。RAISE_APPLICATION_ERROR プロシージャを使用して、この範囲内の特定のエラーコードとメッセージを持つカスタム例外を発生させることができます。

例

DECLARE
    salary NUMBER := 4000;
BEGIN
    -- ビジネスルールを検証し、条件が満たされない場合はエラーをトリガーします
    IF salary < 5000 THEN
        RAISE_APPLICATION_ERROR(-20001, 'Salary is below the allowed minimum.'); /* カスタムエラーを発生させます */
    END IF;
EXCEPTION
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('SQLCODE: ' || SQLCODE); /* エラーコードを表示します */
        DBMS_OUTPUT.PUT_LINE('Custom Error: ' || SQLERRM); /* カスタムエラーメッセージを表示します */
END;

エラーコードとエラーメッセージ

EXCEPTION ブロック内では、次のビルトイン関数を使用してエラーに関する情報を取得できます。

• SQLSTATE: ネイティブ PostgreSQL エラーコード。これは 5 文字の文字列で、最初の 2 文字はエラークラスを表します。

• SQLCODE: Oracle 互換の整数エラーコード。次の 3 つのカテゴリのいずれかに分類されます。

  • 100: no_data_found 例外を示し、クエリ文が結果を返さなかったことを示します。

  • -65535 から -1: 標準の Oracle エラーを示します。

  • -99999: PolarDB for PostgreSQL（Oracle 互換） で無効な値またはサポートされていないシナリオを示します。

• SQLERRM: 例外について詳しく説明するエラーメッセージ。

DECLARE
    result INT;
BEGIN
    result := 1 / 0;
EXCEPTION
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('SQLCODE: ' || SQLCODE); /* エラーコードを表示します */
        DBMS_OUTPUT.PUT_LINE('SQLSTATE: ' || SQLSTATE); /* エラー状態を表示します */
        DBMS_OUTPUT.PUT_LINE('SQLERRM: ' || SQLERRM); /* エラーメッセージを表示します */
END;

SQLCODE: -1476
SQLSTATE: 22012
SQLERRM: division by zero