达梦数据库学习报告——INI 参数管理

SF_GET_PARA_VALUE

定义

int
SF_GET_PARA_VALUE (scope int,ini_param_name varchar(256) )

功能说明：

返回 dm.ini 文件中非浮点和字符串类型的参数值

参数说明：

scope： 取值为 1、2 。 1 表示从 dm.ini 文件中读取；2 表示从内存中读
取。当取值为 1，且 dm.ini 文件中该参数值设置为非法值时，若设置值与参
数类型不兼容，则返回默认值；若设置值小于参数取值范围的最小值，则返回
最小值；若设置值大于参数取值范围的最大值，则返回最大值
ini_param_name：dm.ini 文件中的参数名

返回值：

当前 INI 文件中对应的参数值

举例说明：

获得 dm.ini 文件中 BUFFER 参数值

SELECT SF_GET_PARA_VALUE (1, ‘BUFFER’);

SP_SET_PARA_VALUE*

定义：

void
SP_SET_PARA_VALUE (scope int,ini_param_name varchar(256) ,value bigint)

功能说明：

设置 dm.ini 文件中非浮点和字符串类型的参数值

参数说明：

scope：取值为 1、2 。1 表示 dm.ini 文件和内存参数都修改，不需要重
启服务器；2 表示只修改 dm.ini 文件，服务器重启后生效。
ini_param_name：dm.ini 文件中的参数名。
value：设置的值。

返回值：

无

举例说明：

将 dm.ini 文件中 HFS_CACHE_SIZE 参数值设置为 320

SP_SET_PARA_VALUE(1,‘HFS_CACHE_SIZE’,320);

SF_GET_PARA_DOUBLE_VALUE

定义：

double
SF_GET_PARA_DOUBLE_VALUE (scope int,ini_param_name varchar(256))

功能说明：

返回dm.ini文件中参数中浮点型的参数值

参数说明：

scope：取值为1、2 。1表示从dm.ini文件中读取；2表示从内存中读取；
ini_param_name：dm.ini文件中的参数名。

返回值：

当前INI文件中对应的参数值

举例说明：

获得dm.ini中SEL_RATE_EQU参数值

SELECT SF_GET_PARA_DOUBLE_VALUE (1, ‘CKPT_FLUSH_RATE’);
SELECT SF_GET_PARA_DOUBLE_VALUE (2, ‘CKPT_FLUSH_RATE’);

SP_SET_PARA_DOUBLE_VALUE*

定义：

void
SP_SET_PARA_DOUBLE_VALUE (scope int,ini_param_name varchar(256),value double)

功能说明：

设置dm.ini参数中浮点型的参数值

参数说明：

scope：取值为 1、2。1 表示 dm.ini 文件和内存参数都修改，不需要重启
服务器；2 表示只可修改 dm.ini 文件，服务器重启后生效。
ini_param_name：dm.ini文件中的参数名。
value：设置的值。

返回值：

无

举例说明：

将dm.ini文件中SEL_RATE_EQU参数值设置为0.3

SP_SET_PARA_DOUBLE_VALUE(1, ‘SEL_RATE_EQU’, 0.3);

SF_GET_PARA_STRING_VALUE

定义：

char*
SF_GET_PARA_STRING_VALUE (scope int,ini_param_name varchar(256))

功能说明：

返回 dm.ini 文件中字符串类型的参数值

参数说明：

scope： 取值为1、2 。 1表示从dm.ini文件中读取；2表示从内存中读取；
ini_param_name：dm.ini文件中的参数名

返回值：

当前 INI 文件中对应的参数值

举例说明：

获得dm.ini文件中TEMP_PATH参数值

SELECT SF_GET_PARA_STRING_VALUE (1, ‘TEMP_PATH’);

SP_SET_PARA_STRING_VALUE*

定义：

void
SP_SET_PARA_STRING_VALUE (scope int,ini_param_name varchar(256) ,value varchar(8187))

功能说明：

设置 dm.ini 文件中的字符串型参数值

参数说明：

scope：取值为 1、2 。1 表示 dm.ini 文件和内存参数都修改，不需要重
启服务器；2 表示只修改 dm.ini 文件，服务器重启后生效。
ini_param_name：dm.ini 文件中的参数名。
value：设置的字符串的值。

返回值：

无

举例说明：

将 dm.ini 文件中 SQL_TRACE_MASK 参数值设置为 1

SP_SET_PARA_STRING_VALUE(1, ‘SQL_TRACE_MASK’,‘1’);

SF_SET_SESSION_PARA_VALUE*

定义：

void
SF_SET_SESSION_PARA_VALUE (paraname varchar(8187),value bigint)

功能说明：

设置会话级 INI 参数的值

参数说明：

paraname： 会话级 INI 参数的参数名
value：要设置的新值

返回值：

无

举例说明：

设置会话级 ini 参数 JOIN_HASH_SIZE 的值为 2000

SF_SET_SESSION_PARA_VALUE (‘JOIN_HASH_SIZE’, 2000);

SP_RESET_SESSION_PARA_VALUE*

定义：

void
SP_RESET_SESSION_PARA_VALUE (paraname varchar(8187) )

功能说明：

重置会话级 INI 参数的值，使得参数的值和系统级一致。

参数说明：

paraname：会话级 INI 参数的参数名。

返回值：

无

举例说明：

重置会话级 INI 参数 JOIN_HASH_SIZE 的值

SP_RESET_SESSION_PARA_VALUE (‘JOIN_HASH_SIZE’);

SF_GET_SESSION_PARA_VALUE

定义：

int
SF_GET_SESSION_PARA_VALUE (paraname varchar(8187) )

功能说明：

获得整数类型的会话级 INI 参数的值。

参数说明：

paraname：会话级 INI 参数的参数名。

返回值：

整数类型的会话级 INI 参数的值

举例说明：

获取会话级 INI 参数 JOIN_HASH_SIZE 的值：

SELECT SF_GET_SESSION_PARA_VALUE (‘JOIN_HASH_SIZE’);

SF_GET_SESSION_PARA_DOUBLE_VALUE

定义：

double
SF_GET_SESSION_PARA_DOUBLE_VALUE (paraname varchar(8187) )

功能说明：

获得浮点型的会话级 INI 参数的值。

参数说明：

paraname：会话级 INI 参数的参数名。

返回值：

浮点型会话级 INI 参数的值

举例说明：

获取会话级 INI 参数 SEL_RATE_SINGLE 的值：

SELECT SF_GET_SESSION_PARA_DOUBLE_VALUE (‘SEL_RATE_SINGLE’);

SF_SET_SYSTEM_PARA_VALUE*

定义：

void
SF_SET_SYSTEM_PARA_VALUE (paraname varchar(256), value bigint\double\varchar(256), deferred int, scope int)

功能说明：

修改系统整型、double、varchar 的静态配置参数或动态配置参数。

参数说明：

paraname：ini 参数的参数名。
value：要设置的新值。
deferred：是否立即生效。为 0 表示当前 session 修改的参数立即生效；
1 表示当前 session 不生效，后续再生效。默认为 0。
scope：取值为 0、1、2 。0 表示修改内存中的动态的配置参数值；1 表示
修改内存和 INI 文件中动态的配置参数值；2 表示修改 INI 文件中的静态配置参
数值和动态配置参数值。

返回值：

无

举例说明：

修改 INI 参数 JOIN_HASH_SIZE 的值：

SF_SET_SYSTEM_PARA_VALUE (‘JOIN_HASH_SIZE’,50,1,1);

SF_SET_SQL_LOG

定义：

INT
SF_SET_SQL_LOG (svrlog int,svrmsk varchar(1000))

功能说明：

设置服务器日志相关 INI 参数 SVR_LOG 和 SQL_TRACE_MASK

参数说明：

svrlog：INI 参数 SVR_LOG 的设置值
svrmsk：INI 参数 SQL_TRACE_MASK 的设置值

返回值：

是否成功

举例说明：

设置服务器日志相关 INI 参数

SELECT SF_SET_SQL_LOG(1, ‘3:5:7’);