pg_dbms_errlog

模仿 Oracle DBMS_ERRLOG 模块来记录特定表的DML错误

概览

扩展包名版本分类许可证语言
pg_dbms_errlog2.2SIMISCC
ID扩展名BinLibLoadCreateTrustReloc模式
9270pg_dbms_errlogdbms_errlog
相关扩展pg_dbms_metadata pg_dbms_lock pg_dbms_job

版本

类型仓库版本PG 大版本包名依赖
EXTPGDG2.21817161514pg_dbms_errlog-
RPMPGDG2.21817161514pg_dbms_errlog_$v-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
PGDG 2.2
PGDG 2.2
PGDG 2.2
PGDG 2.2
PGDG 2.2
d12.x86_64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
d12.aarch64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
d13.x86_64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
d13.aarch64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
u22.x86_64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
u22.aarch64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
u24.x86_64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS
u24.aarch64PGDG MISSPGDG MISSPGDG MISSPGDG MISSPGDG MISS

安装

您可以直接安装 pg_dbms_errlog 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:

pig repo add pgdg -u          # 添加 PGDG 仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pg_dbms_errlog;          # 当前活跃 PG 版本安装
pig ext install -y pg_dbms_errlog -v 18  # PG 18
pig ext install -y pg_dbms_errlog -v 17  # PG 17
pig ext install -y pg_dbms_errlog -v 16  # PG 16
pig ext install -y pg_dbms_errlog -v 15  # PG 15
pig ext install -y pg_dbms_errlog -v 14  # PG 14
dnf install -y pg_dbms_errlog_18       # PG 18
dnf install -y pg_dbms_errlog_17       # PG 17
dnf install -y pg_dbms_errlog_16       # PG 16
dnf install -y pg_dbms_errlog_15       # PG 15
dnf install -y pg_dbms_errlog_14       # PG 14

预加载配置

shared_preload_libraries = 'pg_dbms_errlog';

创建扩展

CREATE EXTENSION pg_dbms_errlog;

用法

pg_dbms_errlog: 模拟 Oracle DBMS_ERRLOG 模块,将 DML 错误记录到专用表中

使 DML 操作在遇到错误后可以继续执行,将失败记录到错误表中,而非中止事务。

启用

postgresql.conf 中添加到 shared_preload_libraries

shared_preload_libraries = 'pg_dbms_errlog'
CREATE EXTENSION pg_dbms_errlog;
LOAD 'pg_dbms_errlog';

创建错误日志表

BEGIN;
CALL dbms_errlog.create_error_log('employees');
END;
-- 创建表 "ERR$_employees",包含错误日志列

-- 使用自定义名称和模式:
BEGIN;
CALL dbms_errlog.create_error_log('hr.employees', '"ERRORS"."ERR$_EMPTABLE"');
END;

配置

SET pg_dbms_errlog.enabled TO true;       -- 启用错误日志
SET pg_dbms_errlog.query_tag TO 'daily_load';  -- 用于标识语句的标签
SET pg_dbms_errlog.reject_limit TO 10;    -- 回滚前的最大错误数(-1=无限)
SET pg_dbms_errlog.synchronous TO 'transaction'; -- 'transaction'、'query' 或 'off'
SET pg_dbms_errlog.no_client_error TO true;      -- 抑制客户端错误消息

与 pg_statement_rollback 配合使用

LOAD 'pg_dbms_errlog';
LOAD 'pg_statement_rollback';

CREATE TABLE hr.raises (emp_id integer, sal integer CHECK(sal > 8000));

BEGIN;
CALL dbms_errlog.create_error_log('hr.raises');
END;

SET pg_dbms_errlog.query_tag TO 'daily_load';
SET pg_dbms_errlog.reject_limit TO 10;
SET pg_dbms_errlog.enabled TO true;

BEGIN;
SET pg_statement_rollback.enabled TO on;
INSERT INTO hr.raises VALUES (145, 15400);  -- 成功
INSERT INTO hr.raises VALUES (161, 7700);   -- 失败(已记录)
ROLLBACK TO SAVEPOINT "PgSLRAutoSvpt";
INSERT INTO hr.raises VALUES (175, 9680);   -- 成功
COMMIT;

查看错误日志

SELECT * FROM "ERR$_raises";
-- pg_err_number$  | 23514
-- pg_err_mesg$    | new row for relation "raises" violates check constraint
-- pg_err_optyp$   | I
-- pg_err_tag$     | daily_load
-- pg_err_query$   | INSERT INTO hr.raises VALUES (161, 7700);

刷新排队错误

SELECT dbms_errlog.publish_queue();

最后修改 2026-03-14: update extension metadata (953cbd0)