Oracle 存储过程中的错误码返回信息

在本文中，我们将介绍在 Oracle 存储过程中如何返回错误码及错误信息，并提供详细的示例说明。

阅读更多：Oracle 教程

存储过程中的错误处理

在 Oracle 数据库中，存储过程是用来执行一系列逻辑操作的程序单元。当存储过程执行过程中遇到错误时，可以使用错误码和错误信息来进行错误处理和调试。

错误码（Error code）

错误码是用来表示某个特定错误的数值，在 Oracle 中，错误码是一个 5 位的整数值，范围为 -20000 到 -20999。每个错误码对应一个特定的错误类型，可以根据错误码快速定位问题。

以下是一些常见的 Oracle 错误码及其含义：

ORA-00001：违反唯一约束条件
ORA-00904：不存在的列名
ORA-01403：无数据找到
ORA-06512：发生异常
ORA-06502：转换错误
ORA-04063：找不到存储过程
ORA-29280：无效的 ID

错误信息（Error message）

错误信息用于说明错误的具体原因，在 Oracle 存储过程中，可以通过抛出异常来返回错误信息。常用的异常类型包括 RAISE_APPLICATION_ERROR 和 EXCEPTION_INIT。

RAISE_APPLICATION_ERROR 是一个内置的过程，可以通过传入一个自定义的错误信息和错误码来主动抛出异常。示例代码如下：

CREATE OR REPLACE PROCEDURE my_proc AS
  l_error_code      NUMBER := -20001;
  l_error_message   VARCHAR2(200) := '自定义错误信息';
BEGIN
  -- 执行某些操作

  -- 如果发生错误
  IF some_error_condition THEN
    RAISE_APPLICATION_ERROR(l_error_code, l_error_message);
  END IF;
END;

在上述代码中，RAISE_APPLICATION_ERROR 抛出了一个错误码为 -20001 的异常，并且指定了一个自定义的错误信息。

另一种方式是使用 EXCEPTION_INIT，它允许在存储过程中为特定的错误码定义错误信息。示例代码如下：

CREATE OR REPLACE PROCEDURE my_proc AS
  l_error_code      NUMBER := -20002;
BEGIN
  -- 执行某些操作

  -- 如果发生错误
  IF some_other_error_condition THEN
    DECLARE
      l_error_message   VARCHAR2(200);
    BEGIN
      l_error_message := SQLERRM(l_error_code);
      RAISE_APPLICATION_ERROR(l_error_code, l_error_message);
    EXCEPTION
      WHEN OTHERS THEN
        NULL;
    END;
  END IF;
END;

在上述代码中，我们使用 SQLERRM 函数来获取错误码对应的默认错误信息，并将其作为自定义错误信息抛出异常。

错误信息的获取

当存储过程中触发了异常并抛出错误码和错误信息后，我们可以通过以下方式捕获并获取它们：

使用 SQLCODE 函数获取当前的错误码。
使用 SQLERRM 函数根据错误码获取具体的错误信息。

示例代码如下：

DECLARE
  l_error_code      NUMBER := 0;
  l_error_message   VARCHAR2(200);
BEGIN
  my_proc; -- 调用存储过程

  -- 如果发生错误
  IF SQLCODE != 0 THEN
    l_error_code := SQLCODE;
    l_error_message := SQLERRM(l_error_code);
    DBMS_OUTPUT.PUT_LINE('错误码：' || l_error_code);
    DBMS_OUTPUT.PUT_LINE('错误信息：' || l_error_message);
  ELSE
    -- 执行成功的逻辑
    DBMS_OUTPUT.PUT_LINE('执行成功!');
  END IF;
END;

在上述代码中，我们通过 SQLCODE 获取当前的错误码，并通过 SQLERRM 根据错误码获取具体的错误信息。如果 SQLCODE 的值为 0，则表示存储过程执行成功。

示例

假设我们有一个存储过程用于创建一个新的员工记录，当插入员工信息时遇到唯一键约束冲突时，我们需要捕获并处理该错误。示例代码如下：

CREATE OR REPLACE PROCEDURE create_employee (
  p_employee_id    NUMBER,
  p_first_name     VARCHAR2,
  p_last_name      VARCHAR2
) AS
  l_error_code      NUMBER := -20001;
  l_error_message   VARCHAR2(200) := '插入员工记录失败，员工ID已存在';
BEGIN
  -- 执行插入操作
  INSERT INTO employees (employee_id, first_name, last_name)
  VALUES (p_employee_id, p_first_name, p_last_name);

  -- 捕获唯一键冲突错误
  EXCEPTION
    WHEN DUP_VAL_ON_INDEX THEN
      RAISE_APPLICATION_ERROR(l_error_code, l_error_message);
END;

在上述示例中，我们在插入操作中使用了一个唯一键冲突的场景作为示例。当数据库中已存在相同的员工ID时，会触发唯一键冲突异常。我们通过 EXCEPTION 块来捕获该异常，并通过 RAISE_APPLICATION_ERROR 抛出自定义的错误信息。