gbase数据、南大通用产品文档：GBase8s对 JDBC API 的其他 GBase 8s 扩展

本部分描述在此指南中尚未讨论的对 JDBC API 的特定于 GBase 8s 的扩展。
这些扩展处理
特定于 GBase 8s 数据库的信息。
在 处理错误 中，全面地描述另一 GBase 8s 扩展，com.gbasedbt.jdbc.Message 类。

GCIStmtFetch
函数原型：
sword
GCIStmtFetch(
GCIStmt *stmtp,
GCIError *errhp,
ub4 nrows,
ub2 orientation,
ub4 mode
)；
功能描述：
获取SQL 生成的结果集中的行集。当执行一条查询以后，可以多次调用该函数来提取
结果集中的数据行，直到该函数返回GCI_NO_DATA，说明结果集中的数据行已全部获得。
参数说明：
stmtp（输入）
用来提取结果集的语句句柄
errhp（输入）
错误信息句柄，该接口调用失败时将错误码和错误信息写入该句柄
nrows（输入）
一次操作需要获取的行数
orientation（输入）
行集提取的方式，可以有以下几种方式：


GCI_FETCH_NEXT：从当前游标位置向下进行提取操作


GCI_FETCH_FIRST：
（仅用于和Oracle 保持兼容）
GCI_FETCH_LAST：
（仅用于和Oracle 保持兼容）
GCI_FETCH_PRIOR：
（仅用于和Oracle 保持兼容）
mode（输入）
提取模式，取值如下：


GCI_DEFAULT：缺省模式


GCI_THREADED：多线程模式
返回值：
如果执行成功，但在提取结果集时出现警告性错误（如字符串截断等）
，则返回
GCI_SUCCESS_WITH_INFO，如果执行成功，但结果集返回的行数小于iters 参数指定的行数，
则返回GCI_NO_DATA，执行正常返回GCI_SUCCESS，执行出错返回GCI_ERROR

创建演示数据库
（SQL 管理 API）
随同 admin() 或 task() 函数，使用 create
dbaccessdemo 参数来创建 stores_demo 演
示数据库。
语法


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

元素
描述
关键考虑
database_name
要创建的数据库名称。
缺省数据库名是 stores_demo。
dbspace
要在其中创建数据库
的 dbspace 名称。
缺省 dbspace 是 root dbspace。

用法
运行这个函数来创建 stores_demo 数据库。
使用 -log 选项来启用演示数据库的事务日志记录。
使用 -nots 选项来防止在演示数据库中创建带时间序列数据的表。
示例
下列命令在 root dbspace 中创建 stores_demo 数据库：
EXECUTE FUNCTION task("create dbaccessdemo");
下列命令在名为 dbs1 的 dbspace 中创建名为 demo2 的演示数据库。：
EXECUTE FUNCTION task("create dbaccessdemo","demo2","dbs1");
下列命令在名为 dbs1 的 dbspace 中创建带有事务日志记录的 stores_demo 数据库：
EXECUTE FUNCTION task("create dbaccessdemo","stores_demo","dbs1","-log");