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

 摘要：
执行由“NULL 终结的字符串”查询指向的SQL 查询。正常情况下，字符串
必须包含1 条SQL 语句，而且不应为语句添加终结分号（
‘;’
）或“\g”
。如果
允许多语句执行，字符串可包含多条由分号隔开的语句。
gbase_query()不能用于包含二进制数据的查询，应使用
gbase_real_query()取而代之
（二进制数据可能包含字符
‘\0’
，
gbase_query()
会将该字符解释为查询字符串结束）
。
 语法：
int gbase_query(GBASE *gbase, const char *q);
 参数：
 返回值：
如果查询成功，返回0。如果出现错误，返回非0 值。

GBase 8a 程序员手册C API 篇


- 34 -

南大通用数据技术股份有限公司
 错误：
CR_COMMANDS_OUT_OF_SYNC
以不恰当的顺序执行了命令。
CR_SERVER_GONE_ERROR

GBase 服务器不可用。
CR_SERVER_LOST


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


出现未知错误。

部署前的准备工作
首先需要在远程导出客户端服务器上创建DBA(以gbase 用户为例）用户。

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1253
部署远程导出客户端步骤
部署方式参考章节3.2.5 安装客户端
远程客户端登录集群服务
示例：以gbase 用户身份，登陆集群节点192.168.10.115。
$ gccli -ugbase -pgbase -h192.168.10.115
表5- 162 参数说明
字段名称
含义说明
-u
登录用户名。
-p
登录用户密码。
-h
登录得集群节点IP。

语法
COALESCE(value,...)
函数说明
返回值为列表当中的第一个非NULL 值，在全部为NULL 值的情况下返回值为
NULL。
示例
示例1：其中一个参数值为NULL。
gbase> SELECT COALESCE(NULL,1) FROM dual;
+------------------+
| COALESCE(NULL,1) |
+------------------+
|
1 |
+------------------+
1 row in set

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
653
示例2：每个参数值都为NULL。
gbase> SELECT COALESCE(NULL,NULL,NULL) FROM dual;
+--------------------------+
| COALESCE(NULL,NULL,NULL) |
+--------------------------+
|
NULL |
+--------------------------+
1 row in set