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

sword GCILogon2(
GCIEnv *envhp,
GCIError *errhp,
GCISvcCtx **svchp,
CONST GCIText *username,
ub4 uname_len,
CONST GCIText *password,
ub4 passwd_len,
CONST GCIText *dbname,
ub4 dbname_len,
ub4 mode
)；

根据数据库服务名、用户名和密码，登录到一个指定的数据库服务上，并初始化相关上下
文句柄。可以使用现有连接池中的连接。

参数
输入
/输出


envhp
输入
GCI 环境句柄。对于连接池和会话池，这必须是在其中创建相
应池的池
errhp
输入/输出
错误信息句柄，该接口调用失败时将错误码及错误信息写入该
句柄
svchp
输入/输出
该接口内会自动生成一个当前环境句柄下的上下文句柄，并将
地址保存到该指针
username
输入
登录的用户名
uname_len
输入
登录的用户名的长度
password
输入
登录的口令
passwd_len
输入
登录的口令的长度
dbname
输入
数据库服务名
dbname_len
输入
数据库服务名的长度
mode
输入
连接模式，取值如下：

GCI_DEFAULT:缺省模式

GCI_LOGON2_CPOOL:连接池模式

如果执行成功，返回GCI_SUCCESS，否则返回GCI_ERROR。

删除 dbspace
（SQL 管
理 API）

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

随同 admin() 或 task() 函数，使用 drop dbspace 参数来删除指定的 dbspace。
语法

元素
描述
关键考虑
dbspace
要删除的 dbspace
名。
该 dbspace 必须存在。
在您删除 dbspace之前，
请删除所有您以前在该 dbspace 中
创建的数据库和表。

用法
这个函数等同于 onspaces -d 命令。
示例
下列示例删除名为 dbspace4 的 dbspace：
EXECUTE FUNCTION task("drop dbspace","dbspace4");

函数原型：
sword GCILobLocatorIsInit ( GCIEnv *envhp,
GCIError *errhp,
const GCILobLocator *locp,
boolean *is_initialized );
功能描述：

判断大对象句柄是否初始化过
参数说明：
envhp（输入）
操作所在的环境句柄

errhp（输入）


错误信息句柄，该接口调用失败时，错误信息会存在该句柄上。

locp（输入）


大对象句柄

is_initialized（输出）


初始化是否成功，
大对象句柄内容已经获取到了正确的大对象数据描述信息后，
返
回是初始化成功。
返回值：

如果执行成功，返回GCI_SUCCESS，否则返回GCI_ERROR。