# 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;
```