gbase数据、南大通用产品文档：GBase8sha set standard 参数：

将 HDR 服务器转换成
为标准服务器（SQL 管理 API）
随同 admin() 或 task() 函数，使用 ha set standard 参数来将“高可用性数据复制”
（HDR）主服务器或辅助服务器转换到标准服务器。
语法

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

用法
在 HDR 主服务器或辅助服务器上运行这个函数来将其转换到标准服务器。
删除主服务器与
辅助服务器之间的连接，且终止复制。不更改 HDR 对中其他服务器的模式。
这个函数等同于 onmode -d standard 命令。
示例
下列示例将 HDR 辅助服务器转换到标准服务器：
EXECUTE FUNCTION task("ha set standard");

gbase_change_user
 摘要：

GBase 8a 程序员手册C API 篇


- 10 -

南大通用数据技术股份有限公司
更改用户，将参数db 的值作为gbase 连接句柄的当前默认数据库。在后续
查询中，对于不包含显式数据库区分符的表引用，该数据库是默认数据库。
如果不能确定已连接的用户或用户不具有使用数据库的权限，
gbase_change_user()将失败。在这种情况下，不会改变用户和数据库。
如果不打算拥有默认数据库，可将db 参数设置为NULL。
该命令总是会执行活动事务的ROLLBACK 操作，关闭所有的临时表，解锁所
有的锁定表，并复位状态，就像进行了新连接那样。即使未更改用户，也会出
现该情况。
 语法：
gs_bool gbase_change_user(GBASE *gbase,
const char *user,
const char *passwd,
const char *db);
 参数：
 返回值：
0 表示成功，非0 值表示出现错误。
 错误：
CR_COMMANDS_OUT_OF_SYNC 以不恰当的顺序执行了命令。
CR_SERVER_GONE_ERROR
GBase 服务器不可用。
CR_SERVER_LOST

在查询过程中丢失了与服务器的连接。
CR_UNKNOWN_ERROR

出现未知错误。
ER_UNKNOWN_COM_ERROR
GBase 服务器未实施该命令
ER_ACCESS_DENIED_ERROR 用户或密码错误。
ER_BAD_DB_ERROR

数据库不存在。



GBase 8a 程序员手册C API 篇
南大通用数据技术股份有限公司

- 11 -
ER_DBACCESS_DENIED_ERROR 用户没有访问数据库的权限。
ER_WRONG_DB_NAME

数据库名称过长。

IFX_NO_SECURITY_CHECK 环境变量允许用户 gbasedbt 或 root 完成对数据库服
务器实例的操作，即使 GBase 8s 实用程序检测到 $GBASEDBTDIR 路径不安全也是如
此。请勿使用此环境变量，除非系统设置确实需要。
IFX_NO_SECURITY_CHECK 的目的是用于以下环境：数据库服务器已启动，但在
运行时检测到运行时路径不再安全。在此情况中，超级用户可能需要停止数据库服务器，
以纠正安全缺陷。使用此环境变量时，用户 gbasedbt 或 root 可以使用 onmode 实用程
序关闭不安全的 GBase 8s 实例，而不使用此环境变量时则无法关闭不安全的实例，因为
当 $GBASEDBTDIR 路径不安全时主要程序不会运行。
使用此环境变量有一些风险，但在一些情况中，可能需要纠正更大的安全性问题。由
于仅用户 gbasedbt 或 root 可以调用 IFX_NO_SECURITY_CHECK，因此非法用户不大
可能能够对其进行运行。
要使用此环境变量，请将其设置为任何非空字符串。

1 运行此环境变量时在此处输入的任何值都会禁用 onsecurity 实用程序。
重要： 完成安全性问题的故障诊断之后，关闭此环境变量。