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

特殊场景下屏蔽ODBC 负载均衡方式
...............
84


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

- 1 -
前言
手册简介
GBase
8a 程序员手册从程序员进行数据库开发的角度对GBase
8a 进行详细
介绍。
本手册介绍供客户端连接GBase 8a 服务器用的GBase 8a ODBC 接口驱动程
序。
GBase 对ODBC3.X 标准提供支持。
本部分告诉用户如何安装和使用GBase
8a
ODBC 驱动。
这里也有关于能与ODBC 一起工作的程序的信息，
并回答了一些最常
见的关于ODBC 的问题。
公约
下面的文本约定用于本文档：
约 定
说 明
加粗字体
表示文档标题
大写英文（SELECT）
表示GBase 8a 关键字
等宽字体
表示代码示例
…
表示被省略的内容。


GBase 8a 程序员手册ODBC 篇


- 2 -

南大通用数据技术股份有限公司
1 ODBC 概述

GBA-02EX-0005
错误码
错误标识
错误信息
GBA-02EX-0005
ER_EXECUTOR_QU
ERY
Failed to query in gnode: %s
错误出现原因
在gnode 端执行的SQL 返回的错误
分析与建议
查看集群节点状态是否正常，查看集群发起节点的express.log

单query 索引推荐
单query 索引推荐功能支持用户在数据库中直接进行操作，
本功能基于查询语句的语义
信息和数据库的统计信息，
对用户输入的单条查询语句生成推荐的索引。
本功能涉及的函数
接口如下。
表11- 9 单query 索引推荐功能的接口
函数名
参数
功能
gs_index_advise
SQL 语句字符串
针对单条查询语句生成推荐索引

本功能仅支持单条SELECT 类型的语句，不支持其他类型的SQL 语句。

本功能暂不支持列存表、段页式表、普通视图、物化视图、全局临时表以及密态数
据库。
使用方法
使用上述函数，
获取针对该query 生成的推荐索引，
推荐结果由索引的表名和列名组成。
例如：
gsql=> select "table", "column" from gs_index_advise('SELECT c_discount from
bmsql_customer where c_w_id = 10');
table
|
column
----------------+----------
bmsql_customer | c_w_id
(1 row)
上述结果表明：应当在bmsql_customer 的c_w_id 列上创建索引，例如可以通过下述
SQL 语句创建索引：
CREATE INDEX idx on bmsql_customer(c_w_id);
某些SQL 语句，也可能被推荐创建联合索引，例如：
gsql=# select "table", "column" from gs_index_advise('select name, age, sex from t1 where
age >= 18 and age < 35 and sex = ''f'';');

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
385
table | column
-------+------------
t1
| age, sex
(1 row)
则上述语句表明应该在表t1 上创建一个联合索引(age, sex)，则可以通过下述命令创
建：
CREATE INDEX idx1 on t1(age, sex);
针对分区表可推荐具体索引类型，例如：
gsql=# select "table", "column", "indextype" from gs_index_advise('select name, age, sex from
range_table where age = 20;');
table | column | indextype
-------+--------+-----------
t1
| age
| global
(1 row)
系统函数gs_index_advise()的参数是文本型，
如果参数中存在如单引号
（'）
等特殊字符，
可以使用单引号（'）进行转义，可参考上述示例。