命名SQL描述符区域

一个命名SQL描述符区域由一个头部以及一个或多个条目描述符区域构成。头部包含与整个描述区域相关的信息，而条目描述符区域则描述结果行中的某一列。

• 在使用SQL描述符区域之前，需要分配一个SQL描述符区域：

  EXEC SQL ALLOCATE DESCRIPTOR identifier;

• 当不再需要这个描述符区域时，应及时释放：

  EXEC SQL DEALLOCATE DESCRIPTOR identifier;

• 要使用一个描述符区域，需要使用INTO子句声明：

  EXEC SQL FETCH NEXT FROM mycursor INTO SQL DESCRIPTOR mydesc;

  如果结果集为空，该描述符区域仍会包含查询的元数据。

• 对于还没有执行的预备查询，可以使用DESCRIBE得到其结果集的元数据：

  EXEC SQL BEGIN DECLARE SECTION; 
      char *sql_stmt = "SELECT * FROM table1"; 
  EXEC SQL END DECLARE SECTION;  
  
      EXEC SQL PREPARE stmt1 FROM :sql_stmt; 
      EXEC SQL DESCRIBE stmt1 INTO SQL DESCRIPTOR mydesc;

  在DESCRIBE和FETCH语句中，INTO和USING关键词的使用相似：它们产生结果集以及一个描述符区域的元数据。

• 从头部检索一个描述符区域的值并且将其存储到一个宿主变量中：

  EXEC SQL GET DESCRIPTOR name :hostvar = field;

• 当前只定义了一个头部描述符区域COUNT，它存放描述符区域的条目（即结果集中包含多少列），宿主变量为一个整数类型，需从条目描述符区域中得到一个具体值：

  EXEC SQL GET DESCRIPTOR name VALUE num :hostvar = field;

  num可以是一个字符整数或者一个包含整数的宿主变量。可能的类型如下：

  • CARDINALITY（整数）：结果集中的行数
  • DATA：实际的数据项（这个范围的实际数据类型取决于查询）
  • DATETIME_INTERVAL_CODE（整数）：当TYPE是9时，DATETIME_INTERVAL_CODE将具有以下值之一：1表示DATE，2表示TIME，3表示TIMESTAMP，4表示TIME WITH TIME ZONE，5表示TIMESTAMP WITH TIME ZONE。
  • INDICATOR（整数）：指示符（表示一个空值或者一个值截断）
  • LENGTH（整数）：以字符计的数据长度
  • NAME(string)：列名
  • OCTET_LENGTH（整数）：以字节计的数据字符表达的长度
  • PRECISION（整数）：精度（用于类型numeric）
  • RETURNED_LENGTH（整数）：以字符计的数据长度
  • RETURNED_OCTET_LENGTH（整数）：以字节计的数据字符表达的长度
  • SCALE（整数）：比例（用于类型numeric）
  • TYPE（整数）：列的数据类型的数字编码
• 要检索字段数值并且把它存储到一个宿主变量里，使用如下命令：

  EXEC SQL GET DESCRIPTOR mydesc  VALUE num :hostvar = field

  num可以是一个字符整数或者一个包含整数的宿主变量。可能的字段有:

  • DATA
  • 实际数据项（这个字段的数据类型依赖于这个查询）
  • NAME(string)
  • 字段名称
• 手动建立一个描述符区域为一个查询或游标提供输入参数，使用如下命令：

  EXEC SQL SET DESCRIPTOR name VALUE numfield = :hostvar;

• 在一个FETCH语句中检索多行记录且用数组类型的宿主变量来存储数据，示例如下：

  EXEC SQL BEGIN DECLARE SECTION; 
      int id[5]; 
  EXEC SQL END DECLARE SECTION;  
      EXEC SQL FETCH 5 FROM mycursor INTO SQL DESCRIPTOR mydesc;  
      EXEC SQL GET DESCRIPTOR mydesc VALUE 1 :id = DATA;