Oracle 异常错误处理

　　本篇主要内容如下：
　　5.1 异常处理概念
　　5.1.1 预定义的异常处理
　　5.1.2 非预定义的异常处理
　　5.1.3 用户自定义的异常处理
　　5.1.4  用户定义的异常处理
　　5.2 异常错误传播
　　5.2.1 在执行部分引发异常错误
　　5.2.2 在声明部分引发异常错误
　　5.3 异常错误处理编程
　　5.4  在 PL/SQL 中使用 SQLCODE, SQLERRM异常处理函数
　　--------------------------------------------------------------------------------
　　即使是写得最好的PL/SQL程序也会遇到错误或未预料到的事件。一个优秀的程序都应该能够正确处理各种出错情况，并尽可能从错误中恢复。任何ORACLE错误（报告为ORA-xxxxx形式的Oracle错误号）、PL/SQL运行错误或用户定义条件（不一写是错误），都可以。当然了，PL/SQL编译错误不能通过PL/SQL异常处理来处理，因为这些错误发生在PL/SQL程序执行之前。
　　ORACLE 提供异常情况(EXCEPTION)和异常处理(EXCEPTION HANDLER)来实现错误处理。
　　5.1 异常处理概念
　　异常情况处理(EXCEPTION)是用来处理正常执行过程中未预料的事件,程序块的异常处理预定义的错误和自定义错误,由于PL/SQL程序块一旦产生异常而没有指出如何处理时,程序就会自动终止整个程序运行.
　　有三种类型的异常错误：
　　1． 预定义 ( Predefined )错误
　　ORACLE预定义的异常情况大约有24个。对这种异常情况的处理，无需在程序中定义，由ORACLE自动将其引发。
　　2． 非预定义 ( Predefined )错误
　　即其他标准的ORACLE错误。对这种异常情况的处理，需要用户在程序中定义，然后由ORACLE自动将其引发。
　　3． 用户定义(User_define) 错误
　　程序执行过程中，出现编程人员认为的非正常情况。对这种异常情况的处理，需要用户在程序中定义，然后显式地在程序中将其引发。
　　异常处理部分一般放在 PL/SQL 程序体的后半部,结构为:
　　EXCEPTION
　　WHEN first_exception THEN  <code to handle first exception >
　　WHEN second_exception THEN  <code to handle second exception >
　　WHEN OTHERS THEN  <code to handle others exception >
　　END;
　　异常处理可以按任意次序排列,但 OTHERS 必须放在最后.
　　5.1.1 预定义的异常处理
　　预定义说明的部分 ORACLE 异常错误
　　错误号
　　异常错误信息名称
　　说明
　　ORA-0001
　　Dup_val_on_index
　　违反了唯一性限制
　　ORA-0051
　　Timeout-on-resource
　　在等待资源时发生超时
　　ORA-0061
　　Transaction-backed-out
　　由于发生死锁事务被撤消
　　ORA-1001
　　Invalid-CURSOR
　　试图使用一个无效的游标
　　ORA-1012
　　Not-logged-on
　　没有连接到ORACLE
　　ORA-1017
　　Login-denied
　　无效的用户名/口令
　　ORA-1403
　　No_data_found
　　SELECT INTO没有找到数据
　　ORA-1422
　　Too_many_rows
　　SELECT INTO 返回多行
　　ORA-1476
　　Zero-divide
　　试图被零除
　　ORA-1722
　　Invalid-NUMBER
　　转换一个数字失败
　　ORA-6500
　　Storage-error
　　内存不够引发的内部错误
　　ORA-6501
　　Program-error
　　内部错误
　　ORA-6502
　　Value-error
　　转换或截断错误
　　ORA-6504
　　Rowtype-mismatch
　　宿主游标变量与 PL/SQL变量有不兼容行类型
　　ORA-6511
　　CURSOR-already-OPEN
　　试图打开一个已处于打开状态的游标
　　ORA-6530
　　Access-INTO-null
　　试图为null 对象的属性赋值
　　ORA-6531
　　Collection-is-null
　　试图将Exists 以外的集合( collection)方法应用于一个null pl/sql 表上或varray上
　　ORA-6532
　　Subscript-outside-limit
　　对嵌套或varray索引得引用超出声明范围以外
　　ORA-6533
　　Subscript-beyond-count
　　对嵌套或varray 索引得引用大于集合中元素的个数.
　　对这种异常情况的处理，只需在PL/SQL块的异常处理部分，直接引用相应的异常情况名，并对其完成相应的异常错误处理即可。
　　例1：更新指定员工工资，如工资小于1500，则加100；
　　DECLARE
　　v_empno employees.employee_id%TYPE := &empno;
　　v_sal   employees.salary%TYPE;
　　BEGIN
　　SELECT salary INTO v_sal FROM employees WHERE employee_id = v_empno;
　　IF v_sal<=1500 THEN
　　UPDATE employees SET salary = salary + 100 WHERE employee_id=v_empno;
　　DBMS_OUTPUT.PUT_LINE('编码为'||v_empno||'员工工资已更新!');
　　ELSE
　　DBMS_OUTPUT.PUT_LINE('编码为'||v_empno||'员工工资已经超过规定值!');
　　END IF;
　　EXCEPTION
　　WHEN NO_DATA_FOUND THEN
　　DBMS_OUTPUT.PUT_LINE('数据库中没有编码为'||v_empno||'的员工');
　　WHEN TOO_MANY_ROWS THEN
　　DBMS_OUTPUT.PUT_LINE('程序运行错误!请使用游标');
　　WHEN OTHERS THEN
　　DBMS_OUTPUT.PUT_LINE(SQLCODE||'---'||SQLERRM);
　　END;
　　5.1.2 非预定义的异常处理
　　对于这类异常情况的处理，首先必须对非定义的ORACLE错误进行定义。步骤如下：
　　1. 在PL/SQL 块的定义部分定义异常情况：
　　<异常情况>  EXCEPTION;
　　2. 将其定义好的异常情况，与标准的ORACLE错误联系起来，使用EXCEPTION_INIT语句：
　　PRAGMA EXCEPTION_INIT(<异常情况>, <错误代码>);
　　3. 在PL/SQL 块的异常情况处理部分对异常情况做出相应的处理。
　　例2：删除指定部门的记录信息，以确保该部门没有员工。
　　INSERT INTO departments VALUES(50, 'FINANCE', 'CHICAGO');
　　DECLARE
　　v_deptno departments.department_id%TYPE := &deptno;
　　deptno_remaining EXCEPTION;
　　PRAGMA EXCEPTION_INIT(deptno_remaining, -2292);
　　/* -2292 是违反一致性约束的错误代码 */
　　BEGIN
　　DELETE FROM departments WHERE department_id = v_deptno;
　　EXCEPTION
　　WHEN deptno_remaining THEN
　　DBMS_OUTPUT.PUT_LINE('违反数据完整性约束!');
　　WHEN OTHERS THEN
　　DBMS_OUTPUT.PUT_LINE(SQLCODE||'---'||SQLERRM);
　　END;
　　5.1.3 用户自定义的异常处理
　　当与一个异常错误相关的错误出现时，就会隐含触发该异常错误。用户定义的异常错误是通过显式使用 RAISE 语句来触发。当引发一个异常错误时，控制就转向到 EXCEPTION块异常错误部分，执行错误处理代码。
　　对于这类异常情况的处理，步骤如下：
　　1． 在PL/SQL 块的定义部分定义异常情况：
　　<异常情况>  EXCEPTION;
　　2． RAISE <异常情况>；
　　3． 在PL/SQL 块的异常情况处理部分对异常情况做出相应的处理。
　　例3：更新指定员工工资，增加100；
　　DECLARE
　　v_empno employees.employee_id%TYPE :=&empno;
　　no_result  EXCEPTION;
　　BEGIN
　　UPDATE employees SET salary = salary+100 WHERE employee_id = v_empno;
　　IF SQL%NOTFOUND THEN
　　RAISE no_result;
　　END IF;
　　EXCEPTION
　　WHEN no_result THEN
　　DBMS_OUTPUT.PUT_LINE('你的数据更新语句失败了!');
　　WHEN OTHERS THEN
　　DBMS_OUTPUT.PUT_LINE(SQLCODE||'---'||SQLERRM);
　　END;
　　5.1.4  用户定义的异常处理
　　调用DBMS_STANDARD(ORACLE提供的包)包所定义的RAISE_APPLICATION_ERROR过程，可以重新定义异常错误消息，它为应用程序提供了一种与ORACLE交互的方法。
　　RAISE_APPLICATION_ERROR 的语法如下：
　　RAISE_APPLICATION_ERROR(error_number,error_message,[keep_errors] );
　　这里的error_number 是从 –20,000 到 –20,999 之间的参数，
　　error_message 是相应的提示信息(< 2048 字节)，
　　keep_errors 为可选，如果keep_errors =TRUE ,则新错误将被添加到已经引发的错误列表中。如果keep_errors=FALSE(缺省),则新错误将替换当前的错误列表。
　　例4：创建一个函数get_salary, 该函数检索指定部门的工资总和，其中定义了-20991和-20992号错误，分别处理参数为空和非法部门代码两种错误：
　　CREATE TABLE errlog(
　　Errcode NUMBER,
　　Errtext CHAR(40));
　　CREATE OR REPLACE FUNCTION get_salary(p_deptno NUMBER)
　　RETURN NUMBER
　　AS
　　v_sal NUMBER;
　　BEGIN
　　IF p_deptno IS NULL THEN
　　RAISE_APPLICATION_ERROR(-20991, ’部门代码为空’);
　　ELSIF p_deptno<0 THEN
　　RAISE_APPLICATION_ERROR(-20992, ’无效的部门代码’);
　　ELSE
　　SELECT SUM(employees.salary) INTO v_sal FROM employees
　　WHERE employees.department_id=p_deptno;
　　RETURN v_sal;
　　END IF;
　　END;
　　DECLARE
　　V_salary NUMBER(7,2);
　　V_sqlcode NUMBER;
　　V_sqlerr VARCHAR2(512);
　　Null_deptno EXCEPTION;
　　Invalid_deptno EXCEPTION;
　　PRAGMA EXCEPTION_INIT(null_deptno,-20991);
　　PRAGMA EXCEPTION_INIT(invalid_deptno, -20992);
　　BEGIN
　　V_salary :=get_salary(10);
　　DBMS_OUTPUT.PUT_LINE('10号部门工资：' || TO_CHAR(V_salary));
　　BEGIN
　　V_salary :=get_salary(-10);
　　EXCEPTION
　　WHEN invalid_deptno THEN
　　V_sqlcode :=SQLCODE;
　　V_sqlerr  :=SQLERRM;
　　INSERT INTO errlog(errcode, errtext)
　　VALUES(v_sqlcode, v_sqlerr);
　　COMMIT;
　　END inner1;
　　V_salary :=get_salary(20);
　　DBMS_OUTPUT.PUT_LINE('部门号为20的工资为：'||TO_CHAR(V_salary));
　　BEGIN
　　V_salary :=get_salary(NULL);
　　END inner2;
　　V_salary := get_salary(30);
　　DBMS_OUTPUT.PUT_LINE('部门号为30的工资为：'||TO_CHAR(V_salary));
　　EXCEPTION
　　WHEN null_deptno THEN
　　V_sqlcode :=SQLCODE;
　　V_sqlerr  :=SQLERRM;
　　INSERT INTO errlog(errcode, errtext) VALUES(v_sqlcode, v_sqlerr);
　　COMMIT;
　　WHEN OTHERS THEN
　　DBMS_OUTPUT.PUT_LINE(SQLCODE||'---'||SQLERRM);
　　END outer;
　　例5：定义触发器，使用RAISE_APPLICATION_ERROR阻止没有员工姓名的新员式记录插入：
　　CREATE OR REPLACE TRIGGER tr_insert_emp
　　BEFORE INSERT ON employees
　　FOR EACH ROW
　　BEGIN
　　IF :new.first_name IS NULL OR :new.last_name is null THEN
　　RAISE_APPLICATION_ERROR(-20000,'Employee must have a name.');
　　END IF;
　　END;
　　5.2 异常错误传播
　　由于异常错误可以在声明部分和执行部分以及异常错误部分出现，因而在不同部分引发的异常错误也不一样。
　　5.2.1 在执行部分引发异常错误
　　当一个异常错误在执行部分引发时，有下列情况：
　　l 如果当前块对该异常错误设置了处理，则执行它并成功完成该块的执行，然后控制转给包含块。
　　l 如果没有对当前块异常错误设置定义处理器，则通过在包含块中引发它来传播异常错误。然后对该包含块执行步骤1)。
　　5.2.2 在声明部分引发异常错误
　　如果在声明部分引起异常情况，即在声明部分出现错误，那么该错误就能影响到其它的块。比如在有如下的PL/SQL程序：
　　DECLARE
　　name varchar2(12):='EricHu';
　　其它语句
　　BEGIN
　　其它语句
　　EXCEPTION
　　WHEN OTHERS THEN
　　其它语句
　　END;
　　例子中，由于Abc number(3)=’abc’; 出错，尽管在EXCEPTION中说明了WHEN OTHERS THEN语句，但WHEN OTHERS THEN也不会被执行。 但是如果在该错误语句块的外部有一个异常错误，则该错误能被抓住，如：
　　BEGIN
　　DECLARE
　　name varchar2(12):='EricHu';
　　其它语句
　　BEGIN
　　其它语句
　　EXCEPTION
　　WHEN OTHERS THEN
　　其它语句
　　END;
　　EXCEPTION
　　WHEN OTHERS THEN
　　其它语句
　　END;
　　5.3 异常错误处理编程
　　在一般的应用处理中，建议程序人员要用异常处理，因为如果程序中不声明任何异常处理，则在程序运行出错时，程序就被终止，并且也不提示任何信息。下面是使用系统提供的异常来编程的例子。
　　5.4  在 PL/SQL 中使用 SQLCODE, SQLERRM异常处理函数
　　由于ORACLE 的错信息最大长度是512字节，为了得到完整的错误提示信息，我们可用 SQLERRM和 SUBSTR 函数一起得到错误提示信息，方便进行错误，特别是如果WHEN OTHERS异常处理器时更为方便。
　　SQLCODE  返回遇到的Oracle错误号,
　　SQLERRM  返回遇到的Oracle错误信息.
　　如:  SQLCODE=-100   è SQLERRM=’no_data_found ‘
　　SQLCODE=0      è SQLERRM=’normal, successfual completion’
　　例6. 将ORACLE错误代码及其信息存入错误代码表
　　CREATE TABLE errors (errnum NUMBER(4), errmsg VARCHAR2(100));
　　DECLARE
　　err_msg  VARCHAR2(100);
　　BEGIN
　　/*  得到所有 ORACLE 错误信息  */
　　FOR err_num IN -100 .. 0 LOOP
　　err_msg := SQLERRM(err_num);
　　INSERT INTO errors VALUES(err_num, err_msg);
　　END LOOP;
　　END;
　　DROP TABLE errors;
　　例7. 查询ORACLE错误代码；
　　BEGIN
　　INSERT INTO employees(employee_id, first_name,last_name,hire_date,department_id)
　　VALUES(2222, 'Eric','Hu', SYSDATE, 20);
　　DBMS_OUTPUT.PUT_LINE('插入数据记录成功!');
　　INSERT INTO employees(employee_id, first_name,last_name,hire_date,department_id)
　　VALUES(2222, '胡','勇', SYSDATE, 20);
　　DBMS_OUTPUT.PUT_LINE('插入数据记录成功!');
　　EXCEPTION
　　WHEN OTHERS THEN
　　DBMS_OUTPUT.PUT_LINE(SQLCODE||'---'||SQLERRM);
　　END;
　　例8. 利用ORACLE错误代码，编写异常错误处理代码；
　　DECLARE
　　empno_remaining EXCEPTION;
　　PRAGMA EXCEPTION_INIT(empno_remaining, -1);
　　/* -1 是违反唯一约束条件的错误代码 */
　　BEGIN
　　INSERT INTO employees(employee_id, first_name,last_name,hire_date,department_id)
　　VALUES(3333, 'Eric','Hu', SYSDATE, 20);
　　DBMS_OUTPUT.PUT_LINE('插入数据记录成功!');
　　INSERT INTO employees(employee_id, first_name,last_name,hire_date,department_id)
　　VALUES(3333, '胡','勇',SYSDATE, 20);
　　DBMS_OUTPUT.PUT_LINE('插入数据记录成功!');
　　EXCEPTION
　　WHEN empno_remaining THEN
　　DBMS_OUTPUT.PUT_LINE('违反数据完整性约束!');
　　WHEN OTHERS THEN
　　DBMS_OUTPUT.PUT_LINE(SQLCODE||'---'||SQLERRM);
　　END;