文档首页/ 云数据库 GaussDB/ 开发指南（分布式_V2.0-10.x）/ 应用程序开发教程/ 基于ecpg开发/ 嵌入式SQL-C程序开发/ 嵌入式SQL语法参考/ SET DESCRIPTOR
更新时间：2026-07-28 GMT+08:00
查看PDF
分享

SET DESCRIPTOR

功能描述

在SQL描述符区域中设置信息，描述符区域通常用于绑定预备查询执行中的参数。该命令有两种功能：
  • 用于描述符头部，它独立于特定的数据。
  • 为由数字标识的特定数据赋值。

语法格式

SET DESCRIPTOR descriptor_name descriptor_header_item = value [, ... ]
SET DESCRIPTOR descriptor_name VALUE number descriptor_item = value [, ...]

参数说明

  • descriptor_name

    描述符名称。

  • descriptor_header_item

    标记识别设置的头部信息项。目前仅支持COUNT设置描述符项数。

  • number

    设置的描述符项数。计数从1开始。

  • descriptor_item

    标记识别在描述符中的项的信息。当前仅支持DATA、TYPE和LENGTH。

  • value

    存储到描述符项中的值。可以是SQl常量或者宿主变量。

示例

EXEC SQL SET DESCRIPTOR indesc COUNT = 1; 
EXEC SQL SET DESCRIPTOR indesc VALUE 1 DATA = 2; 
EXEC SQL SET DESCRIPTOR indesc VALUE 1 DATA = :val1; 
EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :val1, DATA = 'some string'; 
EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :val2null, DATA = :val2;

相关链接

ALLOCATE DESCRIPTOR，DEALLOCATE DESCRIPTOR，GET DESCRIPTOR

相关文档