人大金仓数据库KingbaseES ODBC连接之后的增删查改

1. 关键字：

ODBC、人大金仓、KingbaseES

1. 概述

使用ODBC执行SQL语句实现数据库的“增删查改”是建立在与数据库建立连接的基础之上才可实现，并且其实现方式有两种一种是通过不使用prepare语句直接执行，另一种是使用prepare语句预编译SQL语句后再执行。在本文中，将介绍第一种不适用prepare的方式直接执行SQL语句。

1. “增删查改”
   1. 申请语句句柄

在ODBC中，与数据库服务端建立连接之后会返回一个连接句柄，而我们在实现“增删查改”的功能时还需一个记录有SQL语句的语句句柄。因此我们的第一步便是利用连接句柄来申请语句句柄。在申请语句句柄时会使用到的函数为SQLAllocHandle，初次外该函数还可分配环境、连接和描述符句柄。其语法为：

SQLRETURN SQLAllocHandle(

SQLSMALLINT HandleType,

SQLHANDLE InputHandle,

SQLHANDLE * OutputHandlePtr);

其中，HandleType为要由 SQLAllocHandle 分配的句柄的类型（语句句柄对应的值为“SQL_HANDLE_STMT”）。InputHandle 要分配新句柄的上下文中的输入句柄既在本文中为已建立连接的连接句柄。OutputHandlePtr为指向要返回新分配的数据结构的句柄的缓冲区的指针，也就是我们所申请的语句句柄的地址。至此，语句句柄便申请成功。

• 1. 执行SQL语句

在申请成功语句句柄后，便可开始执行SQL语句以实现数据库的“增删查改”在ODBC中，SQLExecDirect提交 SQL 语句以进行一次性执行的最快方法。SQLExecDirect函数语法为：

SQLRETURN SQLExecDirect(

SQLHSTMT StatementHandle

SQLCHAR * StatementText,

SQLINTEGER TextLength);

其中，StatementHandle为前文我们所创建的语句句柄，StatementText为要执行的 SQL 语句，TextLength为StatementText字符形式的长度。

SQLExecDirect函数不是直接执行SQL语句的，而是将SQL语句发送到数据库服务端执行，在此过程中ODBC驱动程序会修改SQL的语句形式以满足服务器端的使用形式。根据执行SQL语句后是否有数据返回而将“增删查改”分为“查”与“增删改”。对于“查”也就是“select”语句，如果我们在后续中有调用SQLSetCursorName函数将游标与语句关联，则ODBC驱动程序使用指定的游标，否则，ODBC驱动程序会生成默认游标名。而对于“增删改”也就是“insert、delete、update”语句，将返回SQL_NO_DATA。

对于“查”的SQL语句，在使用SQLExecDirect函数执行语句后，服务器端会将查询到的结果作为结果集返回。因此，我们还需调用SQLNumResultCols、SQLFetch、SQLGetData三个函数来按照我们的需要而获取结果集中的数据。SQLNumResultCols 返回结果集中的列数，SQLFetch 从结果集中提取下一行数据集，并返回所有绑定列的数据，SQLGetData 在结果集中检索单个列的数据。

• 1. 释放语句句柄

在执行完SQL语句不会再使用的到语句句柄时，便需要我们释放语句句柄以回收资源。再次过程中会用到的函数为SQLFreeHandle。SQLFreeHandle 释放与特定环境、连接、语句或描述符句柄关联的资源。其语法为：

SQLRETURN SQLFreeHandle(

SQLSMALLINT HandleType,

SQLHANDLE Handle);

其中，HandleType 要由 SQLFreeHandle 释放的句柄的类型，我们要释放的语句句柄对应的值为SQL_HANDLE_STMT，Handle 要释放的句柄也就是2.1章节中所创建的语句句柄。在我们日常的开发中，SQLAllocHandle与SQLFreeHandle常是成对存在的，在句柄使用完成后均需释放所申请的资源。

1. 参考用例

以下用例中为使用例看起更加的简介故省略了对执行结果的判断。

• 1. “增”

如下，向表“ORDERS（int id，text name）”中插入一条（id=100， name=‘lihua’）的数据：

• 1. “改”

如下，更新表“ORDERS”中id=100时name=‘liming’：

• 1. “查”

如下，查询表“ORDERS”中id=100的记录：

• 1. “删”

如下，删除表“ORDERS”中id=100的记录：

参考资料

提供该题目相关内容在产品手册中可以系统学习的位置，例如：

《KingbaseES客户端编程接口指南-ODBC》