Plsql-exceptions

提供:Dev Guides
移動先:案内検索

PL/SQL-例外

この章では、PL/SQLの例外について説明します。 例外は、プログラム実行中のエラー状態です。 PL/SQLは、プログラマがプログラム内の EXCEPTION ブロックを使用してこのような状態をキャッチすることをサポートし、エラー状態に対して適切なアクションが実行されます。 例外には2種類あります-

  • システム定義の例外
  • ユーザー定義の例外

例外処理の構文

例外処理の一般的な構文は次のとおりです。 ここでは、処理できる限り多くの例外をリストできます。 デフォルトの例外は、 _ WHENその他THEN_ を使用して処理されます-

DECLARE
   <declarations section>
BEGIN
   <executable command(s)>
EXCEPTION
   <exception handling goes here >
   WHEN exception1 THEN
      exception1-handling-statements
   WHEN exception2  THEN
      exception2-handling-statements
   WHEN exception3 THEN
      exception3-handling-statements
   ........
   WHEN others THEN
      exception3-handling-statements
END;

概念を説明するコードを書きましょう。 前の章で作成して使用したCUSTOMERSテーブルを使用します-

DECLARE
   c_id customers.id%type := 8;
   c_name customerS.Name%type;
   c_addr customers.address%type;
BEGIN
   SELECT  name, address INTO  c_name, c_addr
   FROM customers
   WHERE id = c_id;
   DBMS_OUTPUT.PUT_LINE ('Name: '||  c_name);
   DBMS_OUTPUT.PUT_LINE ('Address: ' || c_addr);

EXCEPTION
   WHEN no_data_found THEN
      dbms_output.put_line('No such customer!');
   WHEN others THEN
      dbms_output.put_line('Error!');
END;
/

上記のコードがSQLプロンプトで実行されると、次の結果が生成されます-

No such customer!

PL/SQL procedure successfully completed.

上記のプログラムは、IDが与えられている顧客の名前と住所を表示します。 データベースにID値8の顧客がいないため、プログラムは実行時例外 NO_DATA_FOUND を発生させます。これは* EXCEPTIONブロック*でキャプチャされます。

例外を発生させる

内部データベースエラーが発生すると、データベースサーバーによって例外が自動的に発生しますが、プログラマは RAISE コマンドを使用して例外を明示的に発生させることができます。 以下は、例外を発生させるための簡単な構文です-

DECLARE
   exception_name EXCEPTION;
BEGIN
   IF condition THEN
      RAISE exception_name;
   END IF;
EXCEPTION
   WHEN exception_name THEN
   statement;
END;

上記の構文を使用して、Oracle標準例外またはユーザー定義の例外を発生させることができます。 次のセクションでは、ユーザー定義の例外を発生させる例を示します。 同様の方法でOracle標準例外を発生させることができます。

ユーザー定義の例外

PL/SQLでは、プログラムのニーズに応じて独自の例外を定義できます。 RAISEステートメントまたはプロシージャ DBMS_STANDARD.RAISE_APPLICATION_ERROR を使用して、ユーザー定義の例外を宣言し、明示的に発生させる必要があります。

例外を宣言するための構文は次のとおりです-

DECLARE
   my-exception EXCEPTION;

次の例は、概念を示しています。 このプログラムは顧客IDを要求します。ユーザーが無効なIDを入力すると、例外 invalid_id が発生します。

DECLARE
   c_id customers.id%type := &cc_id;
   c_name customerS.Name%type;
   c_addr customers.address%type;
   -- user defined exception
   ex_invalid_id  EXCEPTION;
BEGIN
   IF c_id <= 0 THEN
      RAISE ex_invalid_id;
   ELSE
      SELECT  name, address INTO  c_name, c_addr
      FROM customers
      WHERE id = c_id;
      DBMS_OUTPUT.PUT_LINE ('Name: '||  c_name);
      DBMS_OUTPUT.PUT_LINE ('Address: ' || c_addr);
   END IF;

EXCEPTION
   WHEN ex_invalid_id THEN
      dbms_output.put_line('ID must be greater than zero!');
   WHEN no_data_found THEN
      dbms_output.put_line('No such customer!');
   WHEN others THEN
      dbms_output.put_line('Error!');
END;
/

上記のコードがSQLプロンプトで実行されると、次の結果が生成されます-

Enter value for cc_id: -6 (let's enter a value -6)
old  2: c_id customers.id%type := &cc_id;
new  2: c_id customers.id%type := -6;
ID must be greater than zero!

PL/SQL procedure successfully completed.

事前定義の例外

PL/SQLは多くの事前定義の例外を提供します。これらの例外は、プログラムによってデータベース規則に違反したときに実行されます。 たとえば、SELECT INTOステートメントが行を返さない場合、事前定義の例外NO_DATA_FOUNDが発生します。 次の表は、重要な事前定義の例外のいくつかを示しています-

Exception Oracle Error SQLCODE Description
ACCESS_INTO_NULL 06530 -6530 It is raised when a null object is automatically assigned a value.
CASE_NOT_FOUND 06592 -6592 It is raised when none of the choices in the WHEN clause of a CASE statement is selected, and there is no ELSE clause.
COLLECTION_IS_NULL 06531 -6531 It is raised when a program attempts to apply collection methods other than EXISTS to an uninitialized nested table or varray, or the program attempts to assign values to the elements of an uninitialized nested table or varray.
DUP_VAL_ON_INDEX 00001 -1 It is raised when duplicate values are attempted to be stored in a column with unique index.
INVALID_CURSOR 01001 -1001 It is raised when attempts are made to make a cursor operation that is not allowed, such as closing an unopened cursor.
INVALID_NUMBER 01722 -1722 It is raised when the conversion of a character string into a number fails because the string does not represent a valid number.
LOGIN_DENIED 01017 -1017 It is raised when a program attempts to log on to the database with an invalid username or password.
NO_DATA_FOUND 01403 +100 It is raised when a SELECT INTO statement returns no rows.
NOT_LOGGED_ON 01012 -1012 It is raised when a database call is issued without being connected to the database.
PROGRAM_ERROR 06501 -6501 It is raised when PL/SQL has an internal problem.
ROWTYPE_MISMATCH 06504 -6504 It is raised when a cursor fetches value in a variable having incompatible data type.
SELF_IS_NULL 30625 -30625 It is raised when a member method is invoked, but the instance of the object type was not initialized.
STORAGE_ERROR 06500 -6500 It is raised when PL/SQL ran out of memory or memory was corrupted.
TOO_MANY_ROWS 01422 -1422 It is raised when a SELECT INTO statement returns more than one row.
VALUE_ERROR 06502 -6502 It is raised when an arithmetic, conversion, truncation, or sizeconstraint error occurs.
ZERO_DIVIDE 01476 1476 It is raised when an attempt is made to divide a number by zero.