Table 64-2 CREATE_ERROR_LOG Procedure Parameters

Parameter	Description
dml_table_name	The name of the DML table to base the error logging table on. The name can be fully qualified (for example, emp, scott.emp, "EMP", "SCOTT"."EMP"). If a name component is enclosed in double quotes, it will not be upper cased.
err_log_table_name	The name of the error logging table you will create. The default is the first 25 characters in the name of the DML table prefixed with 'ERR$_'. Examples are the following: dml_table_name: 'EMP', err_log_table_name: 'ERR$_EMP' dml_table_name: '"Emp2"', err_log_table_name: 'ERR$_Emp2'
err_log_table_owner	The name of the owner of the error logging table. You can specify the owner indml_table_name. Otherwise, the schema of the current connected user is used.
err_log_table_space	The tablespace the error logging table will be created in. If not specified, the default tablespace for the user owning the DML error logging table will be used.
skip_unsupported	When set to TRUE, column types that are not supported by error logging will be skipped over and not added to the error logging table. When set to FALSE, an unsupported column type will cause the procedure to terminate. The default is FALSE.

Examples

---

---

DBMS_ERRLOG记录DML错误日志（一）

    当一个DML运行的时候，如果遇到了错误，则这条语句会整个回滚，就好像没有执行过。不过对于一个大的DML而言，如果个别数据错误而导致整个语句的回滚，会浪费很多的资源和运行时间，从10g开始Oracle支持记录DML语句的错误，而允许语句自动继续执行。下面介绍一下DML记录语句的用法。

   看一个插入语句的简单例子：

SQL> CREATE TABLE T1 AS SELECT ROWNUM A,ROWNUM B FROM DBA_SEGMENTS WHERE ROWNUM <=10;
Table created
SQL> CREATE TABLE T2 AS SELECT ROWNUM A,ROWNUM B FROM DBA_SEGMENTS WHERE ROWNUM <=20;
Table created
SQL> ALTER TABLE T1 ADD CONSTRAINT PK_T1_A PRIMARY KEY(A);
Table altered
SQL> INSERT INTO T1 SELECT * FROM T2;
INSERT INTO T1 SELECT * FROM T2
ORA-00001: 违反唯一约束条件 (NREI.PK_T1_A)

可以看到，由于插入的数据违反了唯一性约束，导致了Oracle报错。

下面创建记录DML错误信息的记录表，通过DBMS_ERRLOG包来进行创建，而这个包目前只包括这一个过程：

  procedure create_error_log(dml_table_name      varchar2,
                                 err_log_table_name  varchar2 default NULL,
                                err_log_table_owner varchar2 default NULL,
                                err_log_table_space varchar2 default NULL,
                                skip_unsupported    boolean  default FALSE);

利用CREATE_ERROR_LOG来创建T1表的DML错误记录表：

SQL> EXEC DBMS_ERRLOG.CREATE_ERROR_LOG('T1','ERR_T1','NREI');

PL/SQL procedure successfully completed

可以看到Oracle创建的错误记录表包括错误号码ORA_ERR_NUMBER$，错误信息ORA_ERR_MESG$，记录的ROWID信息ORA_ERR_ROWID$，错误操作类型ORA_ERR_OPTYP$，错误标签ORA_ERR_TAG$，以及表中对应的列。

下面利用包含LOG ERROR语句的INSERT语句再次插入数据：

SQL> INSERT INTO T1 SELECT * FROM T2 LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
10 rows inserted

可以看到，插入成功执行，但是插入记录为10条。从对应的错误信息表中已经包含了插入的信息。而且从错误信息表中还可以看到对应的错误号和详细错误信息，ORA_ERR_OPTYP$为错误操作类型，I表示为Insert

关于LOG ERRORS的语法，INTO语句后面跟随的就是指定的错误记录表的表名。

在INTO语句后面，可以跟随一个表达式('ERR_T1')即是ORA_ERR_TAG$中存储的信息，用来设置本次语句执行的错误在错误记录表中对应的TAG。有了这个语句，就可以很轻易的在错误记录表中找到某次操作所对应的所有的错误，这对于错误记录表中包含了大量数据，且本次语句产生了多条错误信息的情况十分有帮助。只要这个表达式的值可以转化为字符串类型就可以。

而REJECT LIMIT则限制语句出错的数量。

SQL> INSERT INTO T1 SELECT * FROM T2 LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT 1;
INSERT INTO T1 SELECT * FROM T2 LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT 1
ORA-00001: 违反唯一约束条件 (NREI.PK_T1_A)

可以看到，当设置的REJECT LIMIT的值小于出错记录数时，语句会报错，这时LOG ERRORS语句没有起到应有的作用，插入语句仍然以报错结束。而如果将REJECT LIMIT的限制设置大于等于出错的记录数，则插入语句就会执行成功。而所有出错的信息都会存储到LOG ERROR对应的表中。

只要指定了LOG ERRORS语句，不管最终插入语句十分成功的执行完成，在错误记录表中都会记录语句执行过程中遇到的错误。比如第一个插入由于出错数目超过REJECT LIMIT的限制，这时在记录表中会存在REJECT LIMIT + 1条记录数，因此这条记录错误导致了整个SQL语句的报错。

如果不管碰到多少错误，都希望语句能继续执行，则可以设置REJECT LIMIT为UNLIMITED

需要注意的是，   即是做了回滚操作，   ERR_T1   表中的记录并不会减少，因为   Oracle   是利用自治事务的方式插入错误记录表的。  

DBMS_ERRLOG记录DML错误日志（二）

   上一篇简单介绍了DML记录语句的限制，虽然所有的例子都是利用INSERT语句，但是LOG ERRORS语句并没有这个限制，UPDATE、DELETE和MERGE都可以使用这个语句。下面要说的就是这篇的重点，LOG ERRORS语句的限制。

不支持的操作：

违反延迟约束；

直接路径的INSERT或MERGE语句违反了唯一约束或唯一索引；

更新操作违反了唯一约束或唯一索引。

不支持的数据类型:

比如：LONG、LONG RAW、BLOG、CLOB、NCLOB、BFILE以及各种对象类型。Oracle不支持这些类型的原因也很简单，这些特殊的类型不是包含了大量的记录，就是需要通过特殊的方法来读取，因此Oracle没有办法在SQL处理的时候将对应列的信息写到错误记录表中。

1.下面我们来看不支持的操作，首先看一下违反延迟约束，

SQL> ALTER TABLE T1 ADD CONSTRAINT PK_T1_B CHECK (B IS NOT NULL) DEFERRABLE INITIALLY DEFERRED;
Table altered

测试语句：

SQL> INSERT INTO T1 VALUES('21','') LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
1 row inserted
SQL> commit;
commit
ORA-02091: 事务处理已回退
ORA-02290: 违反检查约束条件 (NREI.PK_T1_B)

    由于延迟约束的检查在COMMIT时刻进行，而不是在DML发生的时刻，因此不会利用LOG ERRORS语句将违反结果的记录插入到记录表中，这也是很容易理解的。

下面看看直接路径插入违反唯一约束的情况：

SQL> INSERT /*+ APPEND */ INTO T1 SELECT * FROM T2 LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
INSERT /*+ APPEND */ INTO T1 SELECT * FROM T2 LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED
ORA-00001: 违反唯一约束条件 (NREI.PK_T1_A)

直接路径插入本身就很特殊，在执行过程中会绕过很多常规SQL执行的步骤，因此LOG ERRORS语句对其无效也是可以理解的。

最后来看看更新语句违反唯一约束的情况：

SQL> UPDATE T1 SET A='1' WHERE A='2' LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
UPDATE T1 SET A='1' WHERE A='2' LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED
ORA-00001: 违反唯一约束条件 (NREI.PK_T1_A)  

    可以看到，如果更新操作导致了唯一约束或唯一索引冲突，也是不会记录到错误记录表中的。至于为什么更新操作会产生这种情况，还没有想明白，不过主键的冲突和其他约束冲突有所区别，Oracle在处理的时候很可能会有所考虑。

2.下面我们来看不支持的数据类型

SQL> DROP TABLE ERR_T1 PURGE;
Table dropped

SQL> alter table T1 add c clob;

Table altered
SQL> EXEC DBMS_ERRLOG.CREATE_ERROR_LOG('T1','ERR_T1','NREI');
begin DBMS_ERRLOG.CREATE_ERROR_LOG('T1','ERR_T1','NREI'); end;
ORA-20069: Unsupported column type(s) found: C
ORA-06512: 在 "SYS.DBMS_ERRLOG", line 234
ORA-06512: 在 line 1

可以看到，由于T1表拥有不支持的列，导致创建错误记录表的过程报错，错误提示就是T1表中包含了不支持的列。

如果手工添加CLOB字段到错误记录表：

SQL> alter table T1 DROP (c);
Table altered
SQL> EXEC DBMS_ERRLOG.CREATE_ERROR_LOG('T1','ERR_T1','NREI');
PL/SQL procedure successfully completed
SQL> alter table T1 add c clob;
Table altered
SQL> alter table ERR_T1 add c clob;
Table altered

执行插入语句：

SQL> INSERT INTO T1 VALUES('21','21','TEST') LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
INSERT INTO T1 VALUES('21','21','TEST') LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED
ORA-38904: LOB 列 "C" 不支持 DML 错误事件记录

可以看到，Oracle会直接报错。

SQL> UPDATE T1 SET A='22' WHERE A='2' LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
UPDATE T1 SET A='22' WHERE A='2' LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED
ORA-38904: LOB 列 "C" 不支持 DML 错误事件记录

而Oracle的DML并不包含不支持列的数据，Oracle也会报错，说明Oracle是在执行之前检查了错误记录表的数据类型，而不是在执行的时候才去处理。

SQL> alter table ERR_T1 DROP (c);
Table altered
SQL> INSERT INTO T1 VALUES('1','1','TEST' ) LOG ERRORS INTO ERR_T1('ERR_T1')REJECT LIMIT UNLIMITED;
0 rows inserted

可以看到，删除错误记录语句所不支持的列后，LOG ERRORS语句反而可以顺利执行，而且无论DML语句是否包括哪些不支持列的数据。