pg_dbms_errlog
模仿 Oracle DBMS_ERRLOG 模块来记录特定表的DML错误
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_dbms_errlog | 2.2 | SIM | ISC | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 9270 | pg_dbms_errlog | 否 | 是 | 是 | 是 | 否 | 否 | dbms_errlog |
| 相关扩展 | pg_dbms_metadata pg_dbms_lock pg_dbms_job |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 2.2 | 1817161514 | pg_dbms_errlog | - |
| RPM | PGDG | 2.2 | 1817161514 | pg_dbms_errlog_$v | - |
| OS / PG | PG18 | PG17 | PG16 | PG15 | PG14 |
|---|---|---|---|---|---|
| el8.x86_64 | PGDG 2.2 el8.x86_64.pg18 : pg_dbms_errlog_18 pg_dbms_errlog_18-2.2-1PGDG.rhel8.x86_64.rpm
| PGDG 2.2 el8.x86_64.pg17 : pg_dbms_errlog_17 pg_dbms_errlog_17-2.2-1PGDG.rhel8.x86_64.rpm
| PGDG 2.2 el8.x86_64.pg16 : pg_dbms_errlog_16 pg_dbms_errlog_16-2.2-1PGDG.rhel8.x86_64.rpm
| PGDG 2.2 el8.x86_64.pg15 : pg_dbms_errlog_15 pg_dbms_errlog_15-2.2-1PGDG.rhel8.x86_64.rpm
| PGDG 2.2 el8.x86_64.pg14 : pg_dbms_errlog_14 pg_dbms_errlog_14-2.2-1PGDG.rhel8.x86_64.rpm
|
| el8.aarch64 | PGDG 2.2 el8.aarch64.pg18 : pg_dbms_errlog_18 pg_dbms_errlog_18-2.2-1PGDG.rhel8.aarch64.rpm
| PGDG 2.2 el8.aarch64.pg17 : pg_dbms_errlog_17 pg_dbms_errlog_17-2.2-1PGDG.rhel8.aarch64.rpm
| PGDG 2.2 el8.aarch64.pg16 : pg_dbms_errlog_16 pg_dbms_errlog_16-2.2-1PGDG.rhel8.aarch64.rpm
| PGDG 2.2 el8.aarch64.pg15 : pg_dbms_errlog_15 pg_dbms_errlog_15-2.2-1PGDG.rhel8.aarch64.rpm
| PGDG 2.2 el8.aarch64.pg14 : pg_dbms_errlog_14 pg_dbms_errlog_14-2.2-1PGDG.rhel8.aarch64.rpm
|
| el9.x86_64 | PGDG 2.2 el9.x86_64.pg18 : pg_dbms_errlog_18 pg_dbms_errlog_18-2.2-1PGDG.rhel9.x86_64.rpm
| PGDG 2.2 el9.x86_64.pg17 : pg_dbms_errlog_17 pg_dbms_errlog_17-2.2-1PGDG.rhel9.x86_64.rpm
| PGDG 2.2 el9.x86_64.pg16 : pg_dbms_errlog_16 pg_dbms_errlog_16-2.2-1PGDG.rhel9.x86_64.rpm
| PGDG 2.2 el9.x86_64.pg15 : pg_dbms_errlog_15 pg_dbms_errlog_15-2.2-1PGDG.rhel9.x86_64.rpm
| PGDG 2.2 el9.x86_64.pg14 : pg_dbms_errlog_14 pg_dbms_errlog_14-2.2-1PGDG.rhel9.x86_64.rpm
|
| el9.aarch64 | PGDG 2.2 el9.aarch64.pg18 : pg_dbms_errlog_18 pg_dbms_errlog_18-2.2-1PGDG.rhel9.aarch64.rpm
| PGDG 2.2 el9.aarch64.pg17 : pg_dbms_errlog_17 pg_dbms_errlog_17-2.2-1PGDG.rhel9.aarch64.rpm
| PGDG 2.2 el9.aarch64.pg16 : pg_dbms_errlog_16 pg_dbms_errlog_16-2.2-1PGDG.rhel9.aarch64.rpm
| PGDG 2.2 el9.aarch64.pg15 : pg_dbms_errlog_15 pg_dbms_errlog_15-2.2-1PGDG.rhel9.aarch64.rpm
| PGDG 2.2 el9.aarch64.pg14 : pg_dbms_errlog_14 pg_dbms_errlog_14-2.2-1PGDG.rhel9.aarch64.rpm
|
| el10.x86_64 | PGDG 2.2 el10.x86_64.pg18 : pg_dbms_errlog_18 pg_dbms_errlog_18-2.2-1PGDG.rhel10.x86_64.rpm
| PGDG 2.2 el10.x86_64.pg17 : pg_dbms_errlog_17 pg_dbms_errlog_17-2.2-1PGDG.rhel10.x86_64.rpm
| PGDG 2.2 el10.x86_64.pg16 : pg_dbms_errlog_16 pg_dbms_errlog_16-2.2-1PGDG.rhel10.x86_64.rpm
| PGDG 2.2 el10.x86_64.pg15 : pg_dbms_errlog_15 pg_dbms_errlog_15-2.2-1PGDG.rhel10.x86_64.rpm
| PGDG 2.2 el10.x86_64.pg14 : pg_dbms_errlog_14 pg_dbms_errlog_14-2.2-1PGDG.rhel10.x86_64.rpm
|
| el10.aarch64 | PGDG 2.2 el10.aarch64.pg18 : pg_dbms_errlog_18 pg_dbms_errlog_18-2.2-1PGDG.rhel10.aarch64.rpm
| PGDG 2.2 el10.aarch64.pg17 : pg_dbms_errlog_17 pg_dbms_errlog_17-2.2-1PGDG.rhel10.aarch64.rpm
| PGDG 2.2 el10.aarch64.pg16 : pg_dbms_errlog_16 pg_dbms_errlog_16-2.2-1PGDG.rhel10.aarch64.rpm
| PGDG 2.2 el10.aarch64.pg15 : pg_dbms_errlog_15 pg_dbms_errlog_15-2.2-1PGDG.rhel10.aarch64.rpm
| PGDG 2.2 el10.aarch64.pg14 : pg_dbms_errlog_14 pg_dbms_errlog_14-2.2-1PGDG.rhel10.aarch64.rpm
|
| d12.x86_64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| d12.aarch64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| d13.x86_64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| d13.aarch64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| u22.x86_64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| u22.aarch64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| u24.x86_64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS |
| u24.aarch64 | PGDG MISS | PGDG MISS | PGDG MISS | PGDG MISS | PGDG 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;
用法
使 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();