SYS_CONTEXT

语法图

SYS_CONTEXT 函数返回当前时刻与 namespace 关联的 parameter 值。

函数的返回值类型为 VARCHAR，默认长度为 256 字节。

namespace

该参数须为 YashanDB 内置的命名空间 USERENV，不区分大小写，输入其他值时函数返回 NULL。

parameter

指定参数，须为字符型，或可转换为字符型的其他类型（LOB、XMLTYPE 类型支持隐式转换）。大小写不敏感。指定的 parameter 须与 namespace 相关联，若为非法 parameter，将报错。

length

指定返回值的长度。须为数值型或可隐式转换为数值型的其他类型，且必须处于 INT 类型的值域范围内，否则报错。

系统对 length 的值按整数处理，对于非整数将进行小数部分截断，保留整数部分。

本函数接受的 length 合法值在[1,4000]区间，对于不在此范围的其他整数将按默认值 256 处理。

下表列示 USERENV 预定义的 parameter：

示例

SELECT SYS_CONTEXT('USERENV', 'SESSION_USER') res FROM DUAL;
RES----------------------------------------------------------------SYS
SELECT SYS_CONTEXT('USERENV', 'DB_NAME') res FROM DUAL;
RES----------------------------------------------------------------yas

代码

SYS_CONTEXT::= SYS_CONTEXT "(" namespace "," parameter ["," length] ")"

SYS_CONTEXT 函数返回当前时刻与 namespace 关联的 parameter 值。

函数的返回值类型为 VARCHAR，默认长度为 256 字节。

namespace

该参数须为 YashanDB 内置的命名空间 USERENV，不区分大小写，输入其他值时函数返回 NULL。

parameter

指定参数，须为字符型，或可转换为字符型的其他类型（LOB、XMLTYPE 类型支持隐式转换）。大小写不敏感。指定的 parameter 须与 namespace 相关联，若为非法 parameter，将报错。

length

指定返回值的长度。须为数值型或可隐式转换为数值型的其他类型，且必须处于 INT 类型的值域范围内，否则报错。

系统对 length 的值按整数处理，对于非整数将进行小数部分截断，保留整数部分。

本函数接受的 length 合法值在[1,4000]区间，对于不在此范围的其他整数将按默认值 256 处理。

下表列示 USERENV 预定义的 parameter：

示例

SELECT SYS_CONTEXT('USERENV', 'SESSION_USER') res FROM DUAL;
RES----------------------------------------------------------------SYS
SELECT SYS_CONTEXT('USERENV', 'DB_NAME') res FROM DUAL;
RES----------------------------------------------------------------yas