# DBE_SESSION
#### 接口介绍
高级功能包DBE_SESSION支持的所有接口请参见[表1]。DBE_SESSION作用范围是session级别。
 表1DBE_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函数原型为：
```
DBE_SESSION.SET_CONTEXT(
    namespace text,
    attribute text,
    value text
)returns void;
```
表2DBE_SESSION.SET_CONTEXT接口参数说明 
| 参数        | 描述                                               |
|:---|:---|
| namespace | 需要设置的context名称，当context不存在时，新建context，最长支持128个字符 |
| attribute | 属性名称，最长支持128个字符                                  |
| value     | 要设置的值的名称，最长支持128个字符                              |
   
- DBE_SESSION.CLEAR_CONTEXT
清除指定namespace(context)下，某一属性(attribute)的值(value)。DBE_SESSION.CLEAR_CONTEXT函数原型为：
```
DBE_SESSION.CLEAR_CONTEXT (
    namespace text,
    client_identifier text default 'null',
    attribute text
)returns void ;
```
表3DBE_SESSION.CLEAR_CONTEXT接口参数说明 
| 参数                | 描述                          |
|:---|:---|
| namespace         | 用户指定的context                |
| client_identifier | 客户端认证，默认'null'，通常情况用户无需手动设置 |
| attribute         | 要清除的属性                      |
   
- DBE_SESSION.SEARCH_CONTEXT
查找指定namespace(context)下，某一属性(attribute)的值(value)。DBE_SESSION.SEARCH_CONTEXT函数原型为：
```
DBE_SESSION.SEARCH_CONTEXT (
    namespace text,
    attribute text
)returns text;
```
表4DBE_SESSION.SEARCH_CONTEXT接口参数说明 
| 参数        | 描述           |
|:---|:---|
| namespace | 用户指定的context |
| attribute | 要查找的属性       |
   
#### 示例
```
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;
/
```