本节总结了ODBC 程序,按照功能对它们进行了分类。
对于完整的ODBC
API 参考,请参考微软公司技术支持网站中“ODBC 程序员
参考”相关内容。
一个应用程序可以调用SQLGetInfo 函数来获取关于GBase 8a ODBC 的一致
信息。要获取关于在驱动中支持的特定函数的信息,应用程序可以调用
SQLGetFunctions。
注意:对于向后兼容的功能上,GBase 8a ODBC Driver 驱动支持所有不推
荐的函数。下面我们将按照功能分类列出常用的GBase 8a ODBC API 函数。
连接到一个数据源,如下表格所示:
GBase 8a 程序员手册ODBC 篇
南大通用数据技术股份有限公司
- 39 -
函数名
GBase
一致性
目 的
ODBC
SQLAllocHandle
是
ISO 92
获得一个环境、连接、语句、或者描
述符句柄。
SQLConnect
是
ISO 92
通过数据源名、用户ID 和密码连接到
一个指定的驱动。
SQLDriverConnect 是
ODBC
通过连接字符串,或者驱动管理器和
用户使用的驱动显示连接对话框的请
求来连接到指定驱动。
SQLAllocEnv
是
不推荐
获得一个从驱动分配的环境句柄。
SQLAllocConnect
是
不推荐
获得一个连接句柄。
获得关于驱动和数据源的信息,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLDataSources
否
ISO 92
返回可用的的数据源列表,
由驱动管理
器执行。
SQLDrivers
否
ODBC
返回已经安装的驱动和它们的属性,
由
驱动管理器执行。
SQLGetInfo
是
ISO 92
返回指定驱动和数据源的信息。
SQLGetFunctions
是
ISO 92
返回支持的驱动函数。
SQLGetTypeInfo
是
ISO 92
返回支持的数据类型信息。
设置和获得驱动属性,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLSetConnectAttr
是
ISO 92
设置一个连接的属性。
SQLGetConnectAttr
是
ISO 92
返回一个连接的属性值。
SQLSetConnectOption 是
不推荐
设置一个连接选项。
SQLGetConnectOption 是
不推荐
返回一个连接的选项值。
SQLSetEnvAttr
是
ISO 92
设置环境属性。
SQLGetEnvAttr
是
ISO 92
返回环境属性的值。
SQLSetStmtAttr
是
ISO 92
设置一个语句属性。
GBase 8a 程序员手册ODBC 篇
- 40 -
南大通用数据技术股份有限公司
函数名
GBase
一致性
目 的
SQLGetStmtAttr
是
ISO 92
返回语句属性的值。
SQLSetStmtOption
是
不推荐
设置一个语句选项。
SQLGetStmtOption
是
不推荐
返回一个语句选项的值。
预处理SQL 请求,如下表所示:
函数名
GBase
一致性
目 的
ODBC
SQLAllocStmt
是
不推荐
分配一个语句句柄。
SQLPrepare
是
ISO 92
为稍后的执行预处理一个SQL 语
句。
SQLBindParameter
是
ODBC
为一个SQL 语句中的参数分配存储
空间。
SQLGetCursorName
是
ISO 92
返回连接到语句句柄的游标名。
SQLSetCursorName
是
ISO 92
指定一个游标名。
SQLSetScrollOptions 是
ODBC
设置控制游标行为的选项。
提交请求,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLExecute
是
ISO 92
执行一个预处理语句。
SQLExecDirect
是
ISO 92
执行一个语句。
SQLNativeSql
是
ODBC
返回一个由驱动翻译的SQL 语句文本。
SQLDescribeParam 是
ODBC
返回一个语句中指定参数的描述。
SQLNumParams
是
ISO 92
返回一个语句中的参数个数。
SQLParamData
是
ISO 92
和SQLPutData 一起使用来在执行时用
来提供参数数据(用于长数据值)
。
SQLPutData
是
ISO 92
发送一个数值的部分或者全部到参数
中(用于长数据值)
。
GBase 8a 程序员手册ODBC 篇
南大通用数据技术股份有限公司
- 41 -
接收结果和关于结果的信息,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLRowCount
是
ISO 92
返回受插入、更新、或者删除请求影
响的行数。
SQLNumResultCols
是
ISO 92
返回结果集中的列数。
SQLDescribeCol
是
ISO 92
描述结果集中的一个列。
SQLColAttribute
是
ISO 92
描述结果集中一个列的属性。
SQLColAttributes
是
不推荐
描述结果集中一个列的属性。
SQLFetch
是
ISO 92
返回多行结果。
SQLFetchScroll
是
ISO 92
返回可卷动的结果行。
SQLExtendedFetch
是
不推荐
返回可卷动的结果行。
SQLSetPos
是
ODBC
在取得的块中定位一个游标,并允许
一个应用程序刷新结果集中的数据,
或者更新、删除结果集中的数据。
SQLBulkOperations 是
ODBC
执行批量的插入和批量的书签操作,
包含通过书签进行更新、删除、和获
取数据。
返回错误或者诊断信息,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLError
是
不推荐
返回额外错误或者状态信息。
SQLGetDiagField
是
ISO 92
返回额外的诊断信息
(一个单域的诊断
信息数据结构)
。
SQLGetDiagRec
是
ISO 92
返回额外的诊断信息
(一个多域的诊断
信息数据结构)
。
GBase 8a 程序员手册ODBC 篇
- 42 -
南大通用数据技术股份有限公司
获得关于数据源系统表(分类函数)项目的信息:
函数名
GBase
一致性
目 的
ODBC
SQLTransact
是
不推荐
提交或者回滚一个事务。
SQLEndTran
是
ISO 92
提交或者回滚一个事务。
执行事务,如下表所示:
函数名
GBase
一致性
目 的
ODBC
SQLTransact
是
不推荐
提交或者回滚一个事务。
SQLEndTran
是
ISO 92
提交或者回滚一个事务。
终止一个语句,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLFreeStmt
是
ISO 92
结束语句进程,
丢弃未确认的结果,
另
外可选的释放所有和语句句柄相关的
资源。
SQLCloseCursor
是
ISO 92
关闭一个在处理语句时打开的游标。
SQLCancel
是
ISO 92
取消一个SQL 语句。
终止一个连接,如下表格所示:
函数名
GBase
一致性
目 的
ODBC
SQLDisconnect
是
ISO 92
关闭连接。
SQLFreeHandle
是
ISO 92
释放一个环境、
连接、
语句或者描述符
句柄。
SQLFreeConnect
是
不推荐
释放连接句柄。
SQLFreeEnv
是
不推荐
释放一个环境句柄。
GBase 8a 程序员手册ODBC 篇
南大通用数据技术股份有限公司
- 43 -