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

GCIServerSession
函数原型：
sword
GCIServerSession(
void *hndlp,
GCIError *errhp,
sb1 *bufp,
ub4 bufsz,
ub1 hndltype
)；



功能描述：
得到服务器当前的连接数
参数说明：
hndlp（输入）
当前连接的上下文句柄
errhp（输入）
错误信息句柄，该接口调用失败时将错误码和错误信息写入该句柄
bufp（输入）
返回结果集的缓冲区地址
bufsz（输入）
返回结果集的缓冲区大小
hndltype（输入）
保留参数，目前不使用（仅用于和Oracle 保持兼容）
返回值：
如果执行成功，则返回GCI_SUCCESS，否则返回GCI_ERROR

使用GBase 8a ODBC 连接GBase 8a 数据库有两种方式，分别是：配置并使
用数据源名称和使用连接字符串。
在windows 平台下配置数据源名称时，需要在“服务器名称”一栏中填写
GBase 8a 数据库所有节点的IP 地址，并使用“;”分割符将其分割开来（如下
图所示）
，并选择“连接”选项卡中的“高可用性”选项。GBase 8a ODBC 的集
群IP 自动路由功能就会开启。
除非数据库集群的所有节点都不可用，
否则GBase
8a ODBC 总会将连接路由到数据库群集中的一个可用的节点上。

GBase 8a 程序员手册ODBC 篇


- 26 -

南大通用数据技术股份有限公司

图 4-1 GBase 8a ODBC IP 路由配置
在linux 平台上配置数据源名称时，修改odbc.ini 文件中“SERVER”变量
的值为GBase
8a 数据库所有节点的IP 地址，使用“;”分割符将其分割，并增
加IP_ROUTE=1 选项。GBase 8a ODBC 的高可用功能就会开启。
[ODBC Data Sources]
test = GBase 8a ODBC

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

- 27 -
[test]
Driver

= GBase 8a ODBC 8.3 Driver
DATABASE

= test
DESCRIPTION = GBase 8a ODBC 8.3 Driver test
SERVER

= 192.168.7.172;192.168.7.173;192.168.7.174
UID


= root
PASSWORD

= 1
使用GBase 8a ODBC 连接字符串时，需要将数据库集群所有节点IP 列在
SERVER=之后的大括号中，并使用“;”分割开，并增加IP_ROUTE=1;。
"DRIVER={GBase 8a ODBC 8.3 Driver};"
"SERVER={192.168.5.65;192.168.5.64};"
"UID=root;PWD=1;DATABASE=test;PORT=5258;IP_ROUTE=1;"
在linux 下使用GBase 8a ODBC 连接字符串连接时需要在odbcinst.ini 文
件中写入如下信息：
[GBase 8a ODBC 8.3 Driver]
Description = GBase 8a ODBC
Driver = /usr/lib/libgsodbc8.so
Setup =
FileUsage =1
Threading =0
DontDLClose =1

GBase 8a 程序员手册ODBC 篇


- 28 -

南大通用数据技术股份有限公司
5 GBase 8a ODBC 负载均衡功能

gbase_close
 摘要：
关闭前面打开的连接。如果句柄是由gbase_init()或gbase_connect()自
动分配的，gbase_close()还将解除分配由gbase 指向的连接句柄。
 语法：
void gbase_close(GBASE *sock);
 参数：
 返回值：
无