返回首页

gbase数据、南大通用产品文档:GBase8sGCIHandleFree

更新日期:2024年09月11日




sword GCIHandleFree(
dvoid *hndlp,
CONST ub4 type
);

释放已分配的各类句柄, 用于结束当前会话、断开数据库连接后的句柄清理。

GBase 8s GCI 接口使用指南

南大通用数据技术股份有限公司 24


参数
输入
/输出


hndlp
输入
需要释放的句柄
type
输入
释放句柄的句柄类型。取值参见GCIHandleAlloc函数中type参数
的取值,环境句柄如下:
GCI_HTYPE_ENV:释放环境句柄
GCI_HTYPE_SVCCTX:释放上下文句柄
GCI_HTYPE_SERVER:释放服务句柄
GCI_HTYPE_SESSION:释放会话句柄
GCI_HTYPE_ERROR:释放错误句柄
GCI_HTYPE_STMT:释放语句句柄
GCI_HTYPE_DIRPATH_CTX:释放dirpath上下文句柄
GCI_HTYPE_DIRPATH_COLUMN_ARRAY:释放dirpath类
数组句柄
GCI_HTYPE_DIRPATH_STREAM:释放dirpath流句柄
GCI_HTYPE_DESCRIBE:释放描述符句柄

如果释放成功, 则返回GCI_SUCCESS,释放失败,则返回GCI_ERROR。 注释:

该函书需要配合GCIHandleAlloc或GCIEnvCreate使用。

使用 SHMTOTAL 配置参数来指定数据库服务器用于所有内存分配的共享内存的总量(常驻
部分、虚拟部分、通信部分和虚拟扩展部分)。onconfig.std 值 0 暗指约定对内存分配
不设限。
onconfig.std 值
SHMTOTAL 0

0 = (无特定限制)或者大于或等于 1 的任何整数
单位
KB
生效
编辑 onconfig 文件并重启数据库服务器。
用法
您可使用 SHMTOTAL 配置参数来限制对数据库服务器可在系统上放置的内存的需求。
然而,
如果数据库服务器需要的内存多于 SHMTOTAL 强制的限度,则应用可能失败。 当发生这种
情况时,数据库服务器将下列消息写到消息日志中:
size of resident + virtual segments xx + yy > zz total allowed by configuration parameter
SHMTOTAL
这个消息包括下列值。

描述
xx
常驻段的当前大小
yy
虚拟段的当前大小
zz
需要的共享内存合计

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 142 -

如果您启用 LOW_MEMORY_MGR 配置参数,且正在配置服务器来使用 SHMTOTAL 配置参数值
的百分率作为自动低内存管理起始和终止阈值,
则 SHMTOTAL 配置参数必须不设置为 0
(不
限制)。
注意: 更改 SHMTOTAL 配置参数值可导致自动低内存管理的配置成为无效,强制数据库服
务器使用缺省设置。
仅限于 UNIX:
对于最大共享内存段大小,通常是 SHMMAX、SHMSIZE 或 SHMALL,请设置操作系统参数为
数据库服务器配置需要大小的合计。要了解关于操作系统允许的共享内存量的信息,请参
阅 machine notes。
如果您有比 machine notes 中指定的值更多的物理内存,且将由 GBase 8s 使用该内存,
则您可增加 SHMALL 参数的值,直到计算机指定的物理内存的 90%。建议您不要达到或超
过可用的 RAM。

log_min_error_statement
参数说明:控制在服务器日志中记录错误的SQL 语句。
该参数属于SUSET 类型参数,请参考表15-1 中对应设置方法进行设置。
取值范围:枚举类型,有效值有debug、debug5、debug4、debug3、debug2、debug1、
info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表15-1。
说明:
- 设置为error,表示导致错误、日志消息、致命错误、panic 的语句都将被记录。
- 设置为panic,表示关闭此特性。
默认值:error