DBE_SESSION
接口介绍
高级功能包DBE_SESSION支持的所有接口请参见表1。DBE_SESSION作用范围是session级别。
接口名称 |
描述 |
---|---|
设置指定context下,某一属性(attribute)的值(value)。 |
|
清除指定context下,某一属性(attribute)的值(value)。 |
|
查找指定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; |