如何在 PL/SQL 中捕获 Oracle 错误?
问题:
您想在 PL/SQL 中捕获 Oracle 错误。
解决方案
所有 Oracle 错误都可以在 OTHERS 异常处理程序的帮助下捕获。让我们举个例子。我们将使用学生表来演示用法。
让我们先看看表结构。
示例
DESC students;
输出
Name Null Type ------------- -------- ------------ STUDENT_ID NUMBER(6) FIRST_NAME VARCHAR2(20) LAST_NAME NOT NULL VARCHAR2(25) EMAIL NOT NULL VARCHAR2(40) PHONE_NUMBER VARCHAR2(20) JOIN_DATE NOT NULL DATE CLASS_ID NOT NULL VARCHAR2(20) FEES NUMBER(8,2) PROFESSOR_ID NUMBER(6) DEPARTMENT_ID NUMBER(4)
我们现在将编写一个 PL/SQL 块来接受 student_id 作为输入并显示学生的名字和姓氏。
示例
DECLARE v_student_id VARCHAR2(5) := '&student_id'; v_first_name VARCHAR2(15); v_last_name VARCHAR2(25); BEGIN SELECT first_name, last_name INTO v_first_name, v_last_name FROM students WHERE student_id = v_student_id; DBMS_OUTPUT.PUT_LINE (v_first_name || ', ' || v_last_name); EXCEPTION WHEN OTHERS THEN DBMS_OUTPUT.PUT_LINE (' *** An error has occurred'); END;
当将值 43210 传递给块时,输出为。
发生错误
此输出通知您在运行时发生了错误,但您不知道错误是什么以及是什么原因造成的。也许学生表中没有与运行时提供的值相对应的记录,也许 SELECT INTO 语句导致数据类型不匹配,或者 SELECT INTO 语句返回了多行。如您所见,即使这是一个简单示例,也可能会发生许多运行时错误。
我们无法始终识别程序运行时可能发生的所有可能的运行时错误。因此,在我们的脚本中包含 OTHERS 异常处理程序是一种很好的做法。为了改进错误处理,Oracle 平台提供了两个内置函数 SQLCODE 和 SQLERRM,可与 OTHERS 异常处理程序一起使用。
SQLCODE 函数返回 Oracle 错误号,SQLERRM 函数返回错误消息。 SQLERRM 函数返回的消息的最大长度为 512 字节,这是 Oracle 数据库错误消息的最大长度。
现在让我们修改该块以包含 SQLCODE 和 SQLERRM。
示例
DECLARE v_student_id VARCHAR2(5) := '&student_id'; v_first_name VARCHAR2(15); v_last_name VARCHAR2(25); v_err_code NUMBER; v_err_msg VARCHAR2(200); BEGIN SELECT first_name, last_name INTO v_first_name, v_last_name FROM students WHERE student_id = v_student_id; DBMS_OUTPUT.PUT_LINE (v_first_name || ', ' || v_last_name); EXCEPTION WHEN OTHERS THEN -- DBMS_OUTPUT.PUT_LINE ('An error has occurred'); v_err_code := SQLCODE; v_err_msg := SUBSTR(SQLERRM, 1, 200); DBMS_OUTPUT.PUT_LINE ('Error code: '||v_err_code); DBMS_OUTPUT.PUT_LINE ('Error message: '||v_err_msg); END;
错误代码:100
错误消息:ORA-01403:未找到数据
此版本的脚本包含两个新变量:v_err_code 和 v_err_msg。在块的异常处理部分,SQLCODE 函数返回的值分配给变量 v_err_code,SQLERRM 函数返回的值分配给变量 v_err_msg。接下来,错误号和错误消息通过 DBMS_OUTPUT.PUT_LINE 语句显示在屏幕上。
数据准备:问题所用的数据如下所示。
示例
DROP TABLE students; COMMIT; CREATE TABLE students ( student_id NUMBER(6) , first_name VARCHAR2(20) , last_name VARCHAR2(25) CONSTRAINT stu_last_name_nn NOT NULL , email VARCHAR2(40) CONSTRAINT stu_email_nn NOT NULL , phone_number VARCHAR2(20) , join_date DATE CONSTRAINT stu_join_date_nn NOT NULL , class_id VARCHAR2(20) CONSTRAINT stu_job_nn NOT NULL , fees NUMBER(8,2) , professor_id NUMBER(6) , department_id NUMBER(4) , CONSTRAINT stu_fees_min CHECK (fees > 0) , CONSTRAINT stu_email UNIQUE (email) ) ;
示例
CREATE UNIQUE INDEX stu_id_pk ON students (student_id) ; INSERT INTO students VALUES (100,'SMITH','JAMES','SMITH.JAMES@notreal.com','111.111.1245',TO_DATE('17-06-2003','DD-MM-YYYY'),'INS_CHAIRMAN',24000,NULL,NULL); INSERT INTO students VALUES (101,'JOHNSON','JOHN','JOHNSON.JOHN@notreal.com','111.111.1246',TO_DATE('21-09-2005','DD-MM-YYYY'),'INS_VP',17000,100,90); INSERT INTO students VALUES (102,'WILLIAMS','ROBERT','WILLIAMS.ROBERT@notreal.com','111.111.1247',TO_DATE('13-01-2001','DD-MM-YYYY'),'INS_VP',17000,100,90); INSERT INTO students VALUES (103,'BROWN','MICHAEL','BROWN.MICHAEL@notreal.com','111.111.1248',TO_DATE('03-01-2006','DD-MM-YYYY'),'INS_STAFF',9000,102,60); INSERT INTO students VALUES (104,'JONES','WILLIAM','JONES.WILLIAM@notreal.com','111.111.1249',TO_DATE('21-05-2007','DD-MM-YYYY'),'INS_STAFF',6000,103,60); INSERT INTO students VALUES (105,'MILLER','DAVID','MILLER.DAVID@notreal.com','111.111.1250',TO_DATE('25-06-2005','DD-MM-YYYY'),'INS_STAFF',4800,103,60); INSERT INTO students VALUES (106,'DAVIS','RICHARD','DAVIS.RICHARD@notreal.com','111.111.1251',TO_DATE('05-02-2006','DD-MM-YYYY'),'INS_STAFF',4800,103,60); INSERT INTO students VALUES (107,'GARCIA','CHARLES','GARCIA.CHARLES@notreal.com','111.111.1252',TO_DATE('07-02-2007','DD-MM-YYYY'),'INS_STAFF',4200,103,60); INSERT INTO students VALUES (108,'RODRIGUEZ','JOSEPH','RODRIGUEZ.JOSEPH@notreal.com','111.111.1253',TO_DATE('17-08-2002','DD-MM-YYYY'),'CL_PHY',12008,101,100); INSERT INTO students VALUES (109,'WILSON','THOMAS','WILSON.THOMAS@notreal.com','111.111.1254',TO_DATE('16-08-2002','DD-MM-YYYY'),'CL_MATH',9000,108,100); INSERT INTO students VALUES (110,'MARTINEZ','CHRISTOPHER','MARTINEZ.CHRISTOPHER@notreal.com','111.111.1255',TO_DATE('28-09-2005','DD-MM-YYYY'),'CL_MATH',8200,108,100); INSERT INTO students VALUES (111,'ANDERSON','DANIEL','ANDERSON.DANIEL@notreal.com','111.111.1256',TO_DATE('30-09-2005','DD-MM-YYYY'),'CL_MATH',7700,108,100); INSERT INTO students VALUES (112,'TAYLOR','PAUL','TAYLOR.PAUL@notreal.com','111.111.1257',TO_DATE('07-03-2006','DD-MM-YYYY'),'CL_MATH',7800,108,100); INSERT INTO students VALUES (113,'THOMAS','MARK','THOMAS.MARK@notreal.com','111.111.1258',TO_DATE('07-12-2007','DD-MM-YYYY'),'CL_MATH',6900,108,100); COMMIT;