如何在 PL/SQL 中捕获 Oracle 错误?

oraclesoftware & codingprogramming

问题:

您想在 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;

相关文章