原文链接：https://www.gbase.cn/community/post/4319
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。
在企业级数据库应用开发中，高效访问和操作数据库是提升应用性能的关键。南大通用GBase 8s数据库系统提供了GCI（GBase Client Interface）编程接口，允许开发者通过C语言方便地访问和操作数据库。本文将详细介绍GCI的使用，包括环境设置、程序编译、以及如何运行GCI程序，帮助开发者快速掌握GBase 8s数据库的客户端开发。
一、IDS和GCI的安装位置介绍。
1、安装ids、csdk(本文默认ids和csdk是安装在一起的）如：/home/gbase
2、解压GCI包（位置无特殊要求）如：/home/gci
3、进入etc目录下修改client.ksh
cd /home/gci/etc
vim client.ksh
GCICLIENTDIR=/home/gci (gci路径)
GBASEDBTCSDK=/home/gbase (csdk路径)
GBASEDBTSERVER=ol_gbasedbt (实例名)
二、编译GCI程序需要设定的环境变量及含义。
1、export DBUSER=gbasedbt export DBPWD=Big4ifmx
连接数据库的用户名密码，若代码中未使用DBUSER和DBPWD则不需要配置
2、GBASEDBTDIR= /home/gbase (csdk的安装路径)
其他可能会用到的环境变量（按需选用）
1、export DBDATE=Y4MD- 设置日期格式
2、设置字符格式
export DB_LOCALE=ZH_CN.UTF8
export CLIENT_LOCALE=ZH_CN.UTF8
3、设置编译所需链接库的路径
export LD_LIBRARY_PATH=${GBASEDBTDIR}/lib:${GBASEDBTDIR}/lib/esql:${GBASEDBTDIR}/lib/cli
三、CMakelist配置。
仅介绍在gci的demo目录下增加用例需要修改CMakeList, 如增加用例为test.c
cd /home/gci/demo
vim CMakeList.txt
在CMakeList.txt中增加如下内容
#编译源文件test.c生成可执行文件testADD_EXECUTABLE(test test.c)# 指定这个可执行文件test需要链接的库
TARGET_LINK_LIBRARIES(test ${LIB_CLN_NAME})
四、Demo源码分析
提供了一个GCI程序的示例代码，包括数据库登录、执行SQL语句等，并解释了关键代码段的功能。
1、调用接口及流程如下图所示
2、demo示例
#include “gci.h” //gci 接口定义文件GCIEnv *envhp = NULL;
GCISvcCtx *svchp = NULL;
GCIError *errhp = NULL;
GCIStmt *stmtp = NULL;//登陆数据库int logdb(){
GCItext *dbname = (GCItext *)”testdb”; //数据库名 根据需要修改（需保证实例中有该数据库）GCItext *user= (GCItext *)”root”; //用户名 根据需要修改GCItext *pswd= (GCItext *)”111111”; //密码 根据需要修改if (GCIEnvCreate(&envhp, GCI_THREADED|GCI_OBJECT,(dvoid *)0,0,0,0,0,(dvoid **)0) != GCI_SUCCESS)
{
printf(“GCIEnvCreate: create env handle failed!\n”);
}if (GCIHandleAlloc((dvoid *)envhp, (dvoid **)&svchp,GCI_HTYPE_SVCCTX,0,(dvoid **)0) != GCI_SUCCESS)
{
printf(“GCIHandleAlloc: allocate svcctx handle failed!\n”);
}if (GCIHandleAlloc((dvoid *)envhp, (dvoid **)&errhp,GCI_HTYPE_ERROR,0,(dvoid **)0) != GCI_SUCCESS)
{
printf(“GCIHandleAlloc: allocate error handle failed!\n”);
}//调用登陆接口连接数据库if (GCILogon(envhp, errhp, &svchp, user, strlen((char *)user), pswd, strlen((char *)pswd), dbname, strlen((char *)dbname) != GCI_SUCCESS)
{
printf(“logon database failed!\n”);
}
}//执行sql语句{
GCIText sql[256] = {0};//分配语句句柄if (GCIHandleAlloc((dvoid *)envhp, (dvoid **)&stmtp,GCI_HTYPE_STMT,0,(dvoid **)0) != GCI_SUCCESS)
{
printf(“GCIHandleAlloc: allocate stmt handle failed!\n”);
}//准备sql语句strcpy((char *)sql, “create table t_table(idint)”);
GCIStmtPrepare(stmtp, errhp, sql, strlen((char *)sql), 0 ,0);//执行prepare的sql语句GCIStmtExecute(svchp, stmtp, errhp, 1,0, NULL, NULL, GCI_COMMIT_ON_SUCCESS);
}
五、编译和运行GCI程序
1、设定环境变量
cd /home/gci/demo
source /home/gci/etc/client.ksh
若需要，则设置用户名和密码 export DBUSER DBPWD
2、执行脚本文件clean.sh build_linux_debug_shared.sh 然后执行make
./clean.sh
./build_linux_debug_shared.sh
make
3、source ids安装目录（如/home/gbase)下的profile文件或者ksh文件(ol_gbasedbt.ksh)
source ol_gbasedbt.ksh
4、执行可执行文件如： ./test
通过本文的详细介绍，您应能全面了解如何在南大通用GBase 8s数据库中使用GCI进行数据库编程。GCI提供了一种高效、灵活的数据库访问方式，能够帮助开发者提升数据库应用的开发效率和性能。我们希望本文能成为您在使用GBase 8s进行数据库开发的得力助手。
原文链接：https://www.gbase.cn/community/post/4319
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。
