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 示例。

本示例中，导出数据中不包含设定的行分隔符，并且将行分隔符设定为十六进制的
字符。
$ ./db2to8a -D'test' -u'db2inst1' -p'db2inst1' -q"select *
from t" -f'data1.txt' -m'3' -e'|' -l"x'62'"
you machine is Little endian!
Connecting to test...
Connected to test.
--- unload [oracle text file] mode ---
--- field="|" ---

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
572
--- record="x'62'" ---
0 rows exported at 2013-10-18 17:21:49
7 rows exported at 2013-10-18 17:21:49
output file ./wzx/data1.txt closed
export:
7 rows.
export:
5 columns.
export time:

参数说明：控制是否以绑核优化模式启动主DN 进程。配置该参数为0，则不进行绑核
优化；否则，进行绑核优化，且物理CPU 片数为2n 个。数据库、cm_agent 重启生效。仅
支持ARM。参数修改请参考表GUC 参数设置方式进行设置。
取值范围：整型，0~2。
默认值：0