从SQL标识符区域获得信息
功能描述
从SQL描述符区域检索关于查询结果集的信息, 并且将它存储到宿主变量中。在使用该命令将信息传递给宿主语言变量之前 通常使用FETCH或者SELECT 填充标识符区域。
接口原型
EXEC SQL GET DESCRIPTOR descriptor_name :cvariable = descriptor_header_item [, ... ]
EXEC SQL GET DESCRIPTOR descriptor_name VALUE column_number :cvariable = descriptor_item [, ... ]
参数说明
参数名 | 参数说明 |
---|---|
descriptor_name | 描述符名字。 |
descriptor_header_item | 一个标记识别检索的头部信息项。目前仅仅支持COUNT 可以获取结果集中的列数。 |
column_number | 关于被检索的列数信息。计数从1开始。 |
descriptor_item | 一个标记识别检索列的信息项。 |
cvariable | 宿主变量将接收从描述符区域检索的数据。 |
返回值
无。
其他
举例说明使用接口:
检索结果集中列数的例子:
EXEC SQL GET DESCRIPTOR d :d_count = COUNT;
在第一列中检索数据长度的例子:
EXEC SQL GET DESCRIPTOR d VALUE 1 :d_returned_octet_length = RETURNED_OCTET_LENGTH;
检索作为字符串第二列的数据主体的例子:
EXEC SQL GET DESCRIPTOR d VALUE 2 :d_data = DATA;