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

SQLColAttribute
功能描述
返回结果集中一列的描述符信息。
原型
SQLRETURN SQLColAttibute(SQLHSTMT
StatementHandle,
SQLUSMALLINT ColumnNumber,
SQLUSMALLINT
FieldIdentifier,
SQLPOINTER CharacterAtrriburePtr,
SQLSMALLINT
BufferLength,
SQLSMALLINT
*StringLengthPtr,
SQLLEN *NumericAttributePtr);
参数
表8-19 SQLColAttribute 参数
关键字
参数说明
SQLColAttribute
语句句柄。
SQLColAttribute
要检索字段的列号，起始为1，依次递增。
SQLColAttribute
IRD 中ColumnNumber 行的字段。
SQLColAttribute
输出参数：一个缓冲区指针，返回FieldIdentifier 字段值。
SQLColAttribute

如果FieldIdentifier 是一个ODBC 定义的字段，而且
CharacterAttributePtr 指向一个字符串或二进制缓冲区，则
此参数为该缓冲区的长度。

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
255

如果FieldIdentifier 是一个ODBC 定义的字段，而且
CharacterAttributePtr 指向一个整数，则会忽略该字段。
SQLColAttribute
输出参数：缓冲区指针，存放*CharacterAttributePtr 中字符类
型数据的字节总数，
对于非字符类型，
忽略BufferLength 的值。
NumericAttributePt r
输出参数：指向一个整型缓冲区的指针，返回IRD 中
ColumnNumber 行FieldIdentifier 字段的值。
返回值

SQL_SUCCESS：表示调用正确。

SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。

SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。

SQL_INVALID_HANDLE：表示调用无效句柄。其他API 的返回值同理。
注意事项
当SQLColAttribute 返回SQL_ERROR 或SQL_SUCCESS_WITH_INFO 时，通过调用
SQLGetDiagRec 函数，并将HandleType 和Handle 参数设置为SQL_HANDLE_STMT 和
StatementHandle，
可得到一个相关的SQLSTATE 值，
通过SQLSTATE 值可以查出调用此函
数的具体信息。
示例
参见8.2.23 示例。

GBase 8s ODBC Driver 实现 Microsoft™“开放数据库互连”（ODBC）Version 3.0 标准。
GBase 8s ODBC Driver 产品还提供下列特性和功能：
• Data Source Name (DSN) 迁移
• Driver Manager Replacement Module，支持 ODBC 2.x 应用程序与 ODBC 驱动程
序 Version 3.00 之间的兼容性。
• Microsoft Transaction Server (MTS)，允许您开发、运行和管理可伸缩的、基于组
件的 Internet 和 intranet 服务器应用程序的一种环境。MTS 执行下列任务：
o
管理系统资源，
包括进程、
线程和数据库连接，
以便于应用程序可缩放满足
许多并发用户
o
管理服务器组件创建、执行和删除
o
自动地开始和控制事务，实现应用程序的可靠性
o
实现安全性，以便于未获授权的用户不可访问应用程序
o
为配置、管理和部署提供工具
重要： 如果想要以 GBase 8s ODBC Driver 来使用由 MTS 管理的分布式事务，则必
须启用连接池。
• 扩展的数据类型，包括 row 和 collection
• 长标识符
• 对书签的有限支持
• GLS 数据类型
• 广泛的错误检测
• Unicode 支持
• XA 支持
• 对互联网 128 位协议的 Internet Protocol Version 6 支持（要获取更多信息，请参
阅《GBase 8s 管理员指南》。）
支持扩展的数据类型
GBase 8s ODBC Driver 支持扩展的数据类型。
GBase 8s ODBC Driver 支持下列扩展的数据类型：
• 集合（LIST、MULTISET、SET）
• DISTINCT
• OPAQUE（固定的、未命名的）
• row（命名的，未命名的）
• 智能大对象（BLOB、CLOB）
• 支持某些扩展的数据类型的客户机函数
支持 GLS 数据类型
GBase 8s ODBC Driver 支持 GLS 数据类型。
GBase 8s ODBC Driver 支持下列 GLS 数据类型：
• NCHAR

GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 6 -
• NVARCHAR
扩展的错误检测
GBase 8s ODBC Driver 检测 XA 类型错误。

UDT field count was not set in UDTMetaData
应用程序调用了 UDTManager.createUDTClass()，但是之前没有指定定义此不透明类型的内
部数据结构中的字段数。
调用 UDTMetaData.setFieldCount() 指定字段数。