更新日期：2024年09月11日
sword GCISessionEnd(
GCISvcCtx *svchp,
GCIError *errhp,
GCISession *usrhp,
ub4 mode
)；
结束GCISessionBegin中连接类句柄与数据库服务之间的连接。
参数
输入
/输出
svchp
输入
指定断开连接的上下文
errhp
输入
错误信息句柄，该接口调用失败时将错误码及错误信息写入
该句柄
usrhp
输入
登录信息句柄
mode
输入
连接模式， 取值如下：
GCI_DEFAULT：缺省模式
GCI_THREADED ：多线程模式
如果执行成功， 返回GCI_SUCCESS，否则返回GCI_ERROR。 注释：
在解除关联之前，如果连接上存在未提交的事务， 则解除连接后将全部回滚。
GBase 8s GCI 接口使用指南
南大通用数据技术股份有限公司 27
SQLColAttributes 返回结果集章列的描述符消息。
它不能用于返回标记列的信息（列 0）。描述符消息作为字符串，32 位描述符相关值或整
数值返回。
下表描述了 SQLColAttributes 的 SQLSTATE 和错误值。
SQLSTATE
错误值
错误消息
01000
-11001
General warning
01004
-11003
Data truncated
24000
-11031
Invalid cursor state
S1000
-11060
General error
S1001
-11061
Memory-allocation failure
S1002
-11062
Invalid column number
S1008
-11065
Operation canceled
S1010
-11067
Function-sequence error
S1090
-11071
Invalid string or buffer length
S1091
-11072
Descriptor type out of range
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 214 -
SQLSTATE
错误值
错误消息
S1C00
-11092
Driver not capable
S1T00
-11094
Time-out expired
SQLColAttributes 可以返回 SQLPrepare 或 SQLExecute 在 SQLPrepare 之后，
SQLExecute 之前调用的任何 SQLSTATE。具体取决于数据源何时评估与 hstmt 关联的
SQL 语句。
当您使用由程序逻辑补充的游标时，您可解决普通的 SQL 不可解决的问题。这些问题之
一就是部件爆炸问题，有时称为材料单处理。此问题的核心是对象之间的递归关系；一个
对象包含其他对象，其又包含其他对象。
通常以制造库存为例来说明该问题。例如，公司制造各种部件。有些部件是分立的，但有
些是其他部件的组合。
在可能称为 contains 的单个表中说明这些关系。列 contains.parent 持有系组合的部件的部件
编号。列 contains.child 具有为父部件的组件的部件的部件编号。如果部件编号 123400 是
九个部件的组合，则存在九行，123400 在第一列中，其他部件编号在第二列中。下图展示
描述部件编号 123400 的多行中的一行。
图: 部件爆炸问题
部件爆炸问题在于：给定一个部件编号，产生为那个部件的组件的所有部件的列表。下列
示例是一种解决方案的概要，如以 GBase 8s ESQL/C 实现的那样：
int part_list[200];
boom(top_part)
int top_part;
{
long this_part, child_part;
int next_to_do = 0, next_free = 1;
part_list[next_to_do] = top_part;
EXEC SQL DECLARE part_scan CURSOR FOR
SELECT child INTO child_part FROM contains
GBase 8s SQL 指南：教程
南大通用数据技术股份有限公司
- 222 -
WHERE parent = this_part;
while(next_to_do < next_free)
{
this_part = part_list[next_to_do];
EXEC SQL OPEN part_scan;
while(SQLCODE == 0)
{
EXEC SQL FETCH part_scan;
if(SQLCODE == 0)
{
part_list[next_free] = child_part;
next_free += 1;
}
}
EXEC SQL CLOSE part_scan;
next_to_do += 1;
}
return (next_free - 1);
}
从技术上讲，contains 表的每一行都是有向无环图，或树，的头结点。该函数执行对该树的
宽度优先搜索，树根是作为它的参数传递的部件编号。该函数使用名为 part_scan 的游标返
回在 parent 列中带有特定的值的所有行。最内层的 while 循环打开 part_scan 游标，在选择
集中访存每一行，并当已检索了每一组件的部件编号时，关闭该游标。
此函数解决部件爆炸问题的核心，但该函数不是完整的解决方案。例如，它不允许组件在
树中出现多个级别。此外，实际的 contains 表还会有列count，给出在每一 parent 中使用
的 child 部件的计数。返回每一组件部件的总计数的程序要复杂得多。
之前描述的迭代方法不是解决部件爆炸问题的唯一方法。如果代的数目有固定的限制，则
您可使用嵌套的外部自连接，以单个 SELECT 语句解决该问题。
如果在一个最高级别部件内，可包含最多四代部件，则下列 SELECT 语句返回所有部件：
SELECT a.parent, a.child, b.child, c.child, d.child
FROM contains a
OUTER (contains b,
OUTER (contains c, outer contains d) )
WHERE a.parent = top_part_number
AND a.child = b.parent
AND b.child = c.parent
GBase 8s SQL 指南：教程
南大通用数据技术股份有限公司
- 223 -
AND c.child = d.parent
此 SELECT 语句为来源于指定为 top_part_number 的祖先的每一行返回一行。对于不存在
的级别，返回 Null 值。
（请使用指示符变量来检测它们。）要将此解决方案扩展到更多级
别，请选择 contains 表的附加的嵌套外部连接。您还可修订此解决方案来返回每一级别上
部件的数目的计数。