pg_dbms_lock

为PG添加对 Oracle DBMS_LOCK 的完整兼容性支持

概览

扩展包名版本分类许可证语言
pg_dbms_lock1.0SIMPostgreSQLSQL
ID扩展名BinLibLoadCreateTrustReloc模式
9250pg_dbms_lockdbms_lock
相关扩展orafce session_variable pg_dbms_metadata pg_dbms_job oracle_fdw pgtt pg_statement_rollback mysql_fdw

版本

类型仓库版本PG 大版本包名依赖
EXTPGDG1.01817161514pg_dbms_lock-
RPMPGDG1.01817161514pg_dbms_lock_$v-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
PGDG 1.0
PGDG 1.0
PGDG 1.0
PGDG 1.0
PGDG 1.0
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_lock 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:

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

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

pig install pg_dbms_lock;          # 当前活跃 PG 版本安装
pig ext install -y pg_dbms_lock -v 18  # PG 18
pig ext install -y pg_dbms_lock -v 17  # PG 17
pig ext install -y pg_dbms_lock -v 16  # PG 16
pig ext install -y pg_dbms_lock -v 15  # PG 15
pig ext install -y pg_dbms_lock -v 14  # PG 14
dnf install -y pg_dbms_lock_18       # PG 18
dnf install -y pg_dbms_lock_17       # PG 17
dnf install -y pg_dbms_lock_16       # PG 16
dnf install -y pg_dbms_lock_15       # PG 15
dnf install -y pg_dbms_lock_14       # PG 14

创建扩展

CREATE EXTENSION pg_dbms_lock;

用法

pg_dbms_lock: 为 PostgreSQL 添加 Oracle DBMS_LOCK 完整兼容的扩展

使用 PostgreSQL 咨询锁模拟 Oracle DBMS_LOCK 行为。

启用

CREATE EXTENSION pg_dbms_lock;

ALLOCATE_UNIQUE

为命名锁分配唯一锁标识符:

DO $$
DECLARE
    lockhandle varchar;
BEGIN
    CALL dbms_lock.allocate_unique(
        lockname => 'printer_lock',
        lockhandle => lockhandle
    );
    RAISE NOTICE 'Handle: %', lockhandle;
END;
$$;

REQUEST

以指定模式请求锁(Exclusive=6,Shared=4):

DO $$
DECLARE
    lock_res int;
BEGIN
    lock_res := dbms_lock.request(
        id => 123,
        lockmode => 6,           -- 排他锁
        timeout => 300,
        release_on_commit => false
    );
    IF lock_res <> 0 THEN
        RAISE EXCEPTION 'Lock request failed: %', lock_res;
    END IF;
END;
$$;

返回值:0=成功,1=超时,3=参数错误,4=已持有锁,5=非法句柄。

RELEASE

显式释放之前获取的锁:

DO $$
DECLARE
    lock_res int;
BEGIN
    lock_res := dbms_lock.release(id => 123);
    IF lock_res <> 0 THEN
        RAISE EXCEPTION 'Release failed: %', lock_res;
    END IF;
END;
$$;

SLEEP

暂停会话指定时长:

CALL dbms_lock.sleep(0.70);  -- 休眠 0.7 秒

完整示例

DO $$
DECLARE
    lock_res int;
    printer_lockhandle varchar;
BEGIN
    CALL dbms_lock.allocate_unique('printer_lock', printer_lockhandle);
    lock_res := dbms_lock.request(lockhandle => printer_lockhandle, lockmode => 6, timeout => 5);
    IF lock_res <> 0 THEN
        RAISE EXCEPTION 'REQUEST failed: %', lock_res;
    END IF;
    -- 在此执行排他操作
    lock_res := dbms_lock.release(lockhandle => printer_lockhandle);
END;
$$;

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