达梦数据库学习报告——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’);