即使是写得最好的PL/SQL程序也会遇到错误或未预料到的事件。一个优秀的程序都应该能够正确处理各种出错情况,并尽可能从错误中恢复。任何ORACLE错误(报告为ORA-xxxxx形式的Oracle错误号)、PL/SQL运行错误或用户定义条件(不一写是错误),都可以。当然了,PL/SQL编译错误不能通过PL/SQL异常处理来处理,因为这些错误发生在PL/SQL程序执行之前。
ORACLE 提供异常情况(EXCEPTION)和异常处理(EXCEPTION HANDLER)来实现错误处理。
异常情况处理(EXCEPTION)是用来处理正常执行过程中未预料的事件,程序块的异常处理预定义的错误和自定义错误,由于PL/SQL程序块一旦产生异常而没有指出如何处理时,程序就会自动终止整个程序运行.
有三种类型的异常错误:
1. 预定义 ( Predefined )错误
ORACLE预定义的异常情况大约有24个。对这种异常情况的处理,无需在程序中定义,由ORACLE自动将其引发。
2. 非预定义 ( Predefined )错误
即其他标准的ORACLE错误。对这种异常情况的处理,需要用户在程序中定义,然后由ORACLE自动将其引发。
3. 用户定义(User_define) 错误
程序执行过程中,出现编程人员认为的非正常情况。对这种异常情况的处理,需要用户在程序中定义,然后显式地在程序中将其引发。
异常处理部分一般放在 PL/SQL 程序体的后半部,结构为:
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;
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 块的定义部分定义异常情况:
2. 将其定义好的异常情况,与标准的ORACLE错误联系起来,使用EXCEPTION_INIT语句:
3. 在PL/SQL 块的异常情况处理部分对异常情况做出相应的处理。
例2:删除指定部门的记录信息,以确保该部门没有员工。
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 ;
当与一个异常错误相关的错误出现时,就会隐含触发该异常错误。用户定义的异常错误是通过显式使用 RAISE 语句来触发。当引发一个异常错误时,控制就转向到 EXCEPTION块异常错误部分,执行错误处理代码。
对于这类异常情况的处理,步骤如下:
1. 在PL/SQL 块的定义部分定义异常情况:
2. RAISE <异常情况>;
3. 在PL/SQL 块的异常情况处理部分对异常情况做出相应的处理。
例3:更新指定员工工资,增加100;
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 ;
调用DBMS_STANDARD(ORACLE提供的包)包所定义的RAISE_APPLICATION_ERROR过程,可以重新定义异常错误消息,它为应用程序提供了一种与ORACLE交互的方法。
RAISE_APPLICATION_ERROR 的语法如下:
这里的error_number 是从 –20,000 到 –20,999 之间的参数,
error_message 是相应的提示信息(< 2048 字节),
keep_errors 为可选,如果keep_errors =TRUE ,则新错误将被添加到已经引发的错误列表中。如果keep_errors=FALSE(缺省),则新错误将替换当前的错误列表。
例4:创建一个函数get_salary, 该函数检索指定部门的工资总和,其中定义了-20991和-20992号错误,分别处理参数为空和非法部门代码两种错误:
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阻止没有员工姓名的新员式记录插入:
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.1 在执行部分引发异常错误
当一个异常错误在执行部分引发时,有下列情况:
l 如果当前块对该异常错误设置了处理,则执行它并成功完成该块的执行,然后控制转给包含块。
l 如果没有对当前块异常错误设置定义处理器,则通过在包含块中引发它来传播异常错误。然后对该包含块执行步骤1)。
5.2.2 在声明部分引发异常错误
如果在声明部分引起异常情况,即在声明部分出现错误,那么该错误就能影响到其它的块。比如在有如下的PL/SQL程序:
name varchar2 ( 12 ): = ' EricHu ' ;
其它语句
BEGIN
其它语句
EXCEPTION
WHEN OTHERS THEN
其它语句
END ;
例子中,由于Abc number(3)=’abc’; 出错,尽管在EXCEPTION中说明了WHEN OTHERS THEN语句,但WHEN OTHERS THEN也不会被执行。 但是如果在该错误语句块的外部有一个异常错误,则该错误能被抓住,如:
DECLARE
name varchar2 ( 12 ): = ' EricHu ' ;
其它语句
BEGIN
其它语句
EXCEPTION
WHEN OTHERS THEN
其它语句
END ;
EXCEPTION
WHEN OTHERS THEN
其它语句
END ;
在一般的应用处理中,建议程序人员要用异常处理,因为如果程序中不声明任何异常处理,则在程序运行出错时,程序就被终止,并且也不提示任何信息。下面是使用系统提供的异常来编程的例子。
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错误代码及其信息存入错误代码表
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错误代码;
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错误代码,编写异常错误处理代码;
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 ;
作者: EricHu
出处:http://www.cnblogs.com/huyong/
Email:406590790@qq.com
QQ交流:406590790
框架官网:http://www.rdiframework.net/
框架官网博客:http://blog.rdiframework.net/
框架其他博客:http://blog.csdn.net/chinahuyong
http://www.cnblogs.com/huyong
RDIFramework.NET,基于.NET的快速信息化系统开发、整合框架,给用户和开发者最佳的.Net框架部署方案。
关于作者:高级工程师、信息系统项目管理师、DBA。专注于微软平台项目架构、管理和企业解决方案,多年项目开发与管理经验,曾多次组织并开发多个大型项目,在面向对象、面向服务以及数据库领域有一定的造诣。现主要从事基于 RDIFramework.NET 框架的技术开发、咨询工作,主要服务于金融、医疗卫生、铁路、电信、物流、物联网、制造、零售等行业。
如有问题或建议,请多多赐教!
本文版权归作者和CNBLOGS博客共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,如有问题,可以通过邮箱或QQ 联系我,非常感谢。