更新时间:2026-10-21 GMT+08:00
分享

自治事务特性函数

  • gs_autonomous_transaction_detail()

    描述:查看当前用户所属的自治事务会话及其父子事务关系。具备MONADMIN权限或者SYSADMIN权限的用户,可以查看所有自治事务会话及其父子事务关系。

    参数:无。

    返回值类型:setof record

    返回值说明:如表1所示。

    表1 gs_autonomous_transaction_detail函数返回值说明

    名称

    类型

    描述

    autonomous_transaction_session_id

    bigint

    自治事务会话ID。

    autonomous_transaction_thread_id

    bigint

    自治事务线程ID。

    parent_autonomous_transaction_session_id

    bigint

    自治事务父会话ID。

    示例:

    gaussdb=# 
    CREATE OR REPLACE PROCEDURE proc_test()  AS 
    DECLARE 
    PRAGMA AUTONOMOUS_TRANSACTION;
    BEGIN
    pg_sleep(60);
    END;
    /
    gaussdb=# CALL proc_test();
    
    -- 需要新建一个会话进行查询 --
    gaussdb=# SELECT * FROM pg_catalog.gs_autonomous_transaction_detail() AS
    gaussdb-#     (autonomous_transaction_session_id bigint, autonomous_transaction_thread_id bigint, parent_autonomous_transaction_session_id bigint);
     autonomous_transaction_session_id | autonomous_transaction_thread_id | parent_autonomous_transaction_session_id
    -----------------------------------+----------------------------------+------------------------------------------
                       139778155607808 |                  139778155607808 |                          139777830549248
    (1 row)

  • gs_get_autonomous_transaction_count()

    描述:查询当前自治事务计数。

    参数:无。

    返回值类型:integer

    返回值说明:如表2所示。

    表2 gs_get_autonomous_transaction_count函数返回值说明

    名称

    类型

    描述

    gs_get_autonomous_transaction_count

    integer

    当前自治事务计数。

    示例:

    gaussdb=# 
    CREATE OR REPLACE PROCEDURE proc_test()  AS 
    DECLARE 
    PRAGMA AUTONOMOUS_TRANSACTION;
    BEGIN
    pg_sleep(60);
    END;
    /
    gaussdb=# CALL proc_test();
    
    -- 需要新建一个会话进行查询 --
    gaussdb=# SELECT gs_get_autonomous_transaction_count();
     gs_get_autonomous_transaction_count
    -------------------------------------
                                       1
    (1 row)

  • gs_reset_autonomous_transaction_count()

    描述:将当前自治事务计数恢复至正确值,并返回当前正确的自治事务计数值。调用该函数必须有MONADMIN权限或者SYSADMIN权限。

    参数:无。

    返回值类型:integer

    返回值说明:如表3所示。

    表3 gs_reset_autonomous_transaction_count函数返回值说明

    名称

    类型

    描述

    gs_reset_autonomous_transaction_count

    integer

    恢复后正确的自治事务计数值。

    示例:

    gaussdb=# SELECT gs_reset_autonomous_transaction_count();
     gs_reset_autonomous_transaction_count
    ---------------------------------------
                                         0
    (1 row)
    
    gaussdb=# 
    CREATE OR REPLACE PROCEDURE proc_test()  AS 
    DECLARE 
    PRAGMA AUTONOMOUS_TRANSACTION;
    BEGIN
    pg_sleep(60);
    END;
    /
    gaussdb=# CALL proc_test();
    
    -- 需要新建一个会话进行查询 --
    gaussdb=# SELECT gs_reset_autonomous_transaction_count();
     gs_reset_autonomous_transaction_count
    ---------------------------------------
                                         1
    (1 row)

相关文档