gbase数据、南大通用产品文档：GBase8cCLOSE

功能描述
CLOSE 释放和一个游标关联的所有资源。
注意事项

不允许对一个已关闭的游标再做任何操作。

一个不再使用的游标应该尽早关闭。

当创建游标的事务用COMMIT 或ROLLBACK 终止之后，每个不可保持的已打开游标
都隐含关闭。

当创建游标的事务通过ROLLBACK 退出之后，每个可以保持的游标都将隐含关闭。

当创建游标的事务成功提交，可保持的游标将保持打开，直到执行一个明确的CLOSE
或者客户端断开。

GBase 8c 没有明确打开游标的OPEN 语句，
因为一个游标在使用CURSOR 命令定义的
时候就打开了。可以通过查询系统视图pg_cursors 看到所有可用的游标。
语法格式
CLOSE { cursor_name | ALL } ;
参数说明

cursor_name

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
812
一个待关闭的游标名称。

ALL
关闭所有已打开的游标。
示例
请参考FETCH 的示例。
相关命令
FETCH，MOVE

 摘要：
在线程里使用GBase
CAPI 时，
需要首先调用该函数，
然后再调用其它GBase
CAPI 函数。
 语法：
gs_bool gbase_thread_init()
 参数：
 返回值：

0 表示成功，非0 值表示出现错误。

GBase 8a 程序员手册C API 篇


- 48 -

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

ifx_getcur_conn_name() 函数返回当前连接的名称。
语法
char *ifx_getcur_conn_name(void);

用法
当前的连接是活动的数据库服务器连接，当前，其正在将 SQL 请求发送至数据库服
务器，并可能正在从数据库服务器接收数据。在 callback 函数中，当前的连接是当随同对
sqlbreakcallback() 函数的调用注册了 callback 的那个时刻的当前连接。当前连接的名称是
当前连接的显式的名称。如果建立连接的 CONNECT 语句未包括 AS 子句，则该连接没

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 712 -

有显式的名称。

返回代码
当前连接的名称
成功地取得当前连接名称
空指针
不能取得当前连接名称，或当前连接没有显式的名称