更新时间:2024-11-01 GMT+08:00
分享

DBE_SESSION

接口介绍

高级功能包DBE_SESSION支持的所有接口请参见表1。DBE_SESSION作用范围是session级别。

表1 DBE_SESSION

接口名称

描述

DBE_SESSION.SET_CONTEXT

设置指定context下,某一属性(attribute)的值(value)。

DBE_SESSION.CLEAR_CONTEXT

清除指定context下,某一属性(attribute)的值(value)。

DBE_SESSION.SEARCH_CONTEXT

查找指定context下,某一属性(attribute)的值(value)。

  • DBE_SESSION.SET_CONTEXT

    向指定namespace(context)下,设置某一属性(attribute)的值(value)。DBE_SESSION.SET_CONTEXT函数原型为:

    1
    2
    3
    4
    5
    DBE_SESSION.SET_CONTEXT(
        namespace text,
        attribute text,
        value text
    )returns void;
    
    表2 DBE_SESSION.SET_CONTEXT接口参数说明

    参数

    描述

    namespace

    需要设置的context名称,当context不存在时,新建context,最长支持128个字符。

    attribute

    属性名称,最长支持128个字符。

    value

    要设置的值的名称,最长支持128个字符。

  • DBE_SESSION.CLEAR_CONTEXT

    清除指定namespace(context)下,某一属性(attribute)的值(value)。DBE_SESSION.CLEAR_CONTEXT函数原型为:

    1
    2
    3
    4
    5
    DBE_SESSION.CLEAR_CONTEXT (
        namespace text,
        client_identifier text default 'null',
        attribute text
    )returns void ;
    
    表3 DBE_SESSION.CLEAR_CONTEXT接口参数说明

    参数

    描述

    namespace

    用户指定的context。

    client_identifier

    客户端认证,默认'null',通常情况用户无需手动设置。

    attribute

    要清除的属性。

  • DBE_SESSION.SEARCH_CONTEXT

    查找指定namespace(context)下,某一属性(attribute)的值(value)。DBE_SESSION.SEARCH_CONTEXT函数原型为:

    1
    2
    3
    4
    DBE_SESSION.SEARCH_CONTEXT (
        namespace text,
        attribute text
    )returns text;
    
    表4 DBE_SESSION.SEARCH_CONTEXT接口参数说明

    参数

    描述

    namespace

    用户指定的context。

    attribute

    要查找的属性。

示例

1
2
3
4
5
BEGIN
    select DBE_SESSION.set_context('test', 'gaussdb', 'one');   --设置名为test的context下属性为gaussdb的值为one
    select DBE_SESSION.search_context('test', 'gaussdb');
    select DBE_SESSION.clear_context('test', 'test','gaussdb');
END;

相关文档