PL/SQL（五）异常处理

1 异常处理

异常情况处理(EXCEPTION)是用来处理正常执行过程中未预料的事件，由于 PL/SQL 程序块一旦产生异常而没有指出如何处理时,程序就会自动终止整个程序运行。

三种类型的异常：

• 预定义 ( Predefined )错误
  ORACLE 预定义的异常情况大约有 24 个。对这种异常情况的处理，无需在程序中定义，由 ORACLE 自动将其引发。
• 非预定义 ( Predefined )错误
  即其他标准的 ORACLE 错误。对这种异常情况的处理，需要用户在程序中定义，然后由 ORACLE 自动将其引发。
• 用户定义(User_define) 错误
  程序执行过程中，出现编程人员认为的非正常情况。对这种异常情况的处理，需要用户在程序中定义，然后显式地在程序中将其引发。

异常处理部分一般放在 PL/SQL 程序体的后半部,结构为:

EXCEPTION
  WHEN exception1 THEN <handle exception1 >
  WHEN exception2 THEN <handle exception2 >
  WHEN OTHERS THEN <chandle others exception >
END;

注意：异常处理可以按任意次序排列,但 OTHERS 必须放在最后。

1.1 预定义的异常处理

错误号	异常错误信息名称	说明
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 块的异常处理部分，直接引用相应的异常情况名，并对其完成相应的异常错误处理即可。

示例：更新指定员工工资，如工资小于 5000，则加 1000；对 NO_DATA_FOUND 异常, TOO_MANY_ROWS 进行处理。

declare
  v_empno employees.employee_id%type := &v_empno;
  v_sal employees.salary%type;
  v_money number(5) := 1000;
begin
  select salary into v_sal from employees
  where employee_id = v_empno for update;
  if v_sal <= 5000 then
    update employees set salary = salary + 1000
    where ernployee_id = v_empno;
    dbms_output.put_line('工号为：' || v_empno  || '已涨薪' || v_money || '元');
  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('其他错误');
end;

1.2 非预定义的异常处理

对于这类异常情况的处理，首先必须对非定义的 ORACLE 错误进行定义。
步骤：

1. 在 PL/SQL 块的定义部分定义异常情况： <异常情况> EXCEPTION;
2. 将其定义好的异常情况，与标准的 ORACLE 错误联系起来，使用 PRAGMA EXCEPTION_INIT 语句：
   PRAGMA EXCEPTION_INIT(<异常情况>, <错误代码>);
3. 在 PL/SQL 块的异常情况处理部分对异常情况做出相应的处理。
   示例：删除指定部门的记录信息，保证该部门没有员工。

declare
  v_depno dept.deptno%type := &v_depno;
  deptno_remaining exception;
  -- 违反唯一约束错误代码：-2292
  pragma exception_init(deptno_remaining, -2292);
begin
  delete from dept where deptno = v_depno;
exception
  when deptno_remaining then
    dbms_output.put_line('违反唯一约束');
  when others then
    dbms_output.put_line(sqlcode || '，' || sqlerrm);
end;

1.3 用户自定义的异常处理

当与一个异常错误相关的错误出现时，就会隐含触发该异常错误。用户定义的异常错误是通过显式使用 RAISE 语句来触发。当引发一个异常错误时，控制就转向到 EXCEPTION 块异常错误部分，执行错误处理代码。
对于这类异常情况的处理，步骤如下：

1. 在 PL/SQL 块的定义部分定义异常情况： <异常情况> EXCEPTION;
2. RAISE <异常情况>；
3. 在 PL/SQL 块的异常情况处理部分对异常情况做出相应的处理。

示例：更新指定员工工资，增加 0.5元；若该员工不存在则抛出用户自定义异常: no_result

declare
  v_empid employees.employee_id%type := &v_empid
  no_result exception;
begin
  delete from dept where deptno = v_depno;
exception
  when deptno_remaining then
    dbms_output.put_line('违反唯一约束');
  when others then
    dbms_output.put_line(sqlcode || '，' || sqlerrm);
end;

2 在 PL/SQL 中使用 SQLCODE, SQLERRM

• SQLCODE 返回错误代码数字
• SQLERRM 返回错误信息

eg:
SQLCODE=-100 ➡️ SQLERRM=‘no_data_found’
SQLCODE=0 ➡️ SQLERRM=‘normal, successfual completion’

可以将 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;

可以直接在异常EXCEPTION块中直接使用SQLCODE和SQLERRM

EXCEPTION
  WHEN OTHERS THEN
  DBMS_OUTPUT.PUT_LINE(SQLCODE || '---' || SQLERRM);