使用 SET DESCRIPTOR 来在系统描述符区域（SDA）中设置值。
随同 GBase 8s ESQL/C 使用此语句。
语法
元素
描述
限制
语法
descriptor
标识指定其值的 SDA
的字符串
先前必须分配了系
统描述符区域
（SDA）
引用字符
串
descriptor_var
存储 descriptor 的主
变量
与 descriptor 相
同的限制
特定于语
言
item_num
指定 SDA 中项描述符
的次序位置的无符号整
数
0 < item_num ≤
（当分配 SDA 时指
定的项描述符的数
目）
精确数值
item_num_var
存储 item_num 的主变
量
与 item_num 相同
的限制
特定于语
言
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 991
元素
描述
限制
语法
total_items
指定 SDA 描述的项的
数量的无符号整数
与 item_num 相同
的限制
精确数值
total_items_var
存储 total_items 的
主变量
与 total_items 的
限制相同
特定于语
言
用法
在您以 DESCRIBE ... USING SQL DESCRIPTOR 语句已描述了 SELECT、
EXECUTE FUNCTION、EXECUTE PROCEDURE、ALLOCATE DESCRIPTOR 或
INSERT 语句之后，可使用 SET DESCRIPTOR 语句。
SET DESCRIPTOR 可在这些情况下给系统描述符区域指定值：
设置系统描述符区域的 COUNT 字段来匹配您正在系统描述符区域中提
供描述的项的数目。
为您正在系统描述符区域中提供描述的每一值设置项描述符
修改项描述符字段的内容
如果在给任何标识的系统描述符字段赋值期间发生错误，则将所有标识了的字段
的内容设置为 0 或 NULL，这依赖于该变量的数据类型。
使用 COUNT 子句
使用 COUNT 子句来设置要在系统描述符区域中被使用的项的数目。如果您分配
给系统描述符区域的项比您正在使用的项更多，则您需要将 COUNT 字段设置为您
实际正在使用的项的数目。下列示例展示 GBase 8s ESQL/C 程序的片段：
EXEC SQL BEGIN DECLARE SECTION;
int count;
EXEC SQL END DECLARE SECTION;
EXEC SQL allocate descriptor 'desc_100'; /*为 100 项分配*/
count = 2;
EXEC SQL set descriptor 'desc_100' count = :count;
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 992
使用 VALUE 子句
使用 VALUE 子句来从主变量赋值到系统描述符区域的字段内。您可为您正在为
其提供描述的项赋值（诸如在 WHERE 子句中的参数），或您可在为 UPDATE
或 INSERT 语句使用 DESCRIBE 语句来填充字段之后修改值。
项描述符
使用 SET DESCRIPTOR 语句的“项描述符”部分来为系统描述符中单个字段设置
值。
项描述符
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 993
元素
描述
限制
语法
input_var
为指定的项描述符字
段存储数据的主变量
必须适合于指定的字
段
特定于语
言
literal_int
赋值给指定的项描述
符字段的整数值（>
0）
依赖于 = 符号左边
的关键字的限制
精确数值
literal_int_var
有 literal_int 值
的变量
与 literal_int 的
相同
特定于语
言
要获取更多关于 TYPE 或 ITYPE 字段的有效代码以及它们的含义的信息，请参
阅 设置 TYPE 或 ITYPE 字段。
要获取适用于其他字段类型的限制，请参阅 使用 VALUE 子句 之下单个字段类
型的的标题。
设置 TYPE 或 ITYPE 字段
使用整数值来为每一项设置 TYPE 或 ITYPE 的值。
SQL 数据类型
整数值
X-Open
整数值
SQL 数据类型
整数值
X-Open
整数值
CHAR
0
1
MONEY
8
–
SMALLINT
1
4
DATETIME
10
–
INTEGER
2
5
BYTE
11
–
FLOAT
3
6
TEXT
12
–
SMALLFLOAT
4
–
VARCHAR
13
–
DECIMAL
5
3
INTERVAL
14
–
SERIAL
6
–
NCHAR
15
–
DATE
7
–
NVARCHAR
16
–
下表罗列以 GBase 8s 表示可用的附加的数据类型的整数值。
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 994
SQL 数据类型
整数值
SQL 数据类型
整数值
INT8
17
固定长度 OPAQUE 类型
41
SERIAL8
18
LVARCHAR（仅限于客户端侧）
43
SET
19
BOOLEAN
45
MULTISET
20
BIGINT
52
LIST
21
BIGSERIAL
53
ROW（未命名的）
22
IDSSECURITYLABEL
2061
COLLECTION
23
ROW（命名的）
4118
可变长 OPAQUE 类
型
40
在系统目录中，相同的 TYPE 常量还可出现在 syscolumns.coltype 列中。请参
阅 GBase 8s SQL 参考指南。
对于更易于维护的代码，请使用为这些 SQL 数据类型预定义的常量，而不是它
们的实际整数值。在 $GBASEDBT/incl/public/sqltypes.h 头文件中定义这些常
量。然而，您不可在 SET DESCRIPTOR 语句中使用实际的常量名称。相反，将
该常量赋值给整数主变量，并在 SET DESCRIPTOR 语句文件中指定该主变量。
下列示例展示您可在 GBase 8s ESQL/C 中如何设置 TYPE 字段：
main()
{
EXEC SQL BEGIN DECLARE SECTION;
int itemno, type;
EXEC SQL END DECLARE SECTION;
...
EXEC SQL allocate descriptor 'desc1' with max 5;
...
type = SQLINT; itemno = 3;
EXEC SQL set descriptor 'desc1' value :itemno type = :type;
}
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 995
对于 ITYPE，此信息时唯一的。当您创建不符合 X/Open 标准的动态的程序时，
请使用 ITYPE。
不带 -xopen 选项的编译
如果您不带 -xopen 选项编译，则将正常的 GBase 8s SQL 代码赋值为 TYPE。
您必须小心莫将正常的模式与 X/Open 模式搞混，因为可导致错误。例如，如果
数据类型未在 X/Open 模式之下定义，但在正常的模式之下定义，则执行 SET
DESCRIPTOR 语句可导致错误。
在 X/Open 程序中设置 TYPE 字段
在 X/Open 模式中，您必须在 TYPE 字段中使用该数据类型的整数代码的
X/Open 集。
如果您在 SET DESCRIPTOR 语句中使用 ILENGTH、IDATA 或 ITYPE 字
段，则出现警告消息。该警告表示这些字段不是系统描述符区域的标准 X/Open
字段。
对于比较容易维护的代码，请使用这些 X/Open SQL 数据类型的预定义的常量，
而不是它们的实际整数值。在 $GBASEDBT/incl/public/sqlxtype.h 头文件中定义
这些常量。
使用 DECIMAL 或 MONEY 数据类型
如果您为 DECIMAL 或 MONEY 数据类型设置 TYPE 字段，且您想要使用标
度或精度而不是缺省的值，则请设置 SCALE 和 PRECISION 字段。 您不需要
为 DECIMAL 或 MONEY 项设置 LENGTH 字段；相应地从 SCALE 和
PRECISION 字段设置 LENGTH 字段。
使用 DATETIME 或 INTERVAL 数据类型
如果您为 DATETIME 或 INTERVAL 值设置 TYPE 字段，则 DATA 字段可为
DATETIME 或 INTERVAL 文字或字符串。如果您使用字符串，则必须把
LENGTH 字段编码为限定符值。
要为 DATETIME 或 INTERVAL 字符串确定编码的限定符，请在 datetime.h 头
文件中使用 datetime 和 interval 宏。
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 996
如果您将 DATA 设置为 DATETIME 或 INTERVAL 的主变量，则不需要显式
地将 LENGTH 设置为编码的限定符整数。
设置 DATA 或 IDATA 字段
当您设置 DATA 或 IDATA 字段时，请使用数据的适当的类型（对于 CHAR
或 VARCHAR 使用字符串，对于 INTEGER 使用整数，等等）。
如果设置任何 DATA 之外的内容，则不定义 DATA 的值。您不可为项设置
DATA 或 IDATA 字段而不为那个项设置 TYPE。 如果您为一项将 TYPE 字
段设置为字符类型，则您还必须设置 LENGTH 字段。如果您未为字符项设置
LENGTH 字段，则会收到错误。
设置 LENGTH 或 ILENGTH 字段
如果您的 DATA 或 IDATA 字段包含字符串，则您必须指定 LENGTH 的值。
如果您指定 LENGTH=0，则自动地将 LENGTH 设置为字符串的最大长度。
DATA 或 IDATA 字段可包含最多 368 字节的文字字符串，或从 CHAR 或
VARCHAR 数据类型的字符变量派生的字符串。这提供了一种自动地确定 DATA
或 IDATA 字段中字符串长度的方法。
如果 DESCRIBE 语句在 SET DESCRIPTOR 语句之前，则自动地将 LENGTH
设置为在您的表中指定的字符字段的最大长度。
此信息对于 ILENGTH 是相同的。当您创建不符合 X/Open 标准的动态的程序
时，请使用 ILENGTH。
设置 INDICATOR 字段
如果您想要将 NULL 值放到系统描述符区域之内，请将 INDICATOR 字段设置
为 -1，且不设置 DATA 字段。
如果您将 INDICATOR 字段设置 0 来表示该数据不为 NULL，则必须设置
DATA 字段。
设置 Opaque 类型字段
下列项描述符字段提供关于以 opaque 类型作为其数据类型的列的信息：
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 997
EXTYPEID 字段存储 opaque 类型的扩展的标识符。此整数值必须对应
于 sysxtdtypes 系统目录表的 extended_id 列中的值。
EXTYPENAME 字段存储 opaque 类型的名称。此字符值必须对应于
sysxtdtypes 系统目录表中带有与 extended_id 值相匹配的行的 name 列
中的值。
EXTYPELENGTH 字段存储 opaque 类型名称的长度。此整数值是
EXTYPENAME 字段中字符串的长度，以字节为单位。
EXTYPEOWNERNAME 字段存储 opaque 类型所有者的名称。此字符
值必须对应于 sysxtdtypes 系统目录表中与 extended_id 值相匹配的行的
owner 列中的值。
EXTYPEOWNERLENGTH 字段存储 EXTTYPEOWNERNAME 字段
中值的长度。此整数是 EXTYPEOWNERNAME 字段中字符串的长度，
以字节为单位。
要获取更多关于 sysxtdtypes 系统目录表的信息，请参阅 GBase 8s SQL 参考指
南。
设置 Distinct 类型字段
下列项描述符字段提供关于以 distinct 类型为其数据类型的列的信息：
SOURCEID 字段存储源数据类型的扩展的标识符。
如果该 distinct 类型的源类型是 opaque 数据类型，则设置此字段。此整
数值必须对应于 sysxtdtypes 系统目录表中其 extended_id 值与您正在设
置的 distinct 类型相匹配的行的 source 列中的值。
SOURCETYPE 字段存储源数据类型的数据类型常量。
此值是该 distinct 类型的源类型的内建的数据类型的数据类型常量。
SOURCETYPE 字段的代码与 TYPE 字段的代码相同（设置 TYPE 或
ITYPE 字段页）。此整数值必须对应于 sysxtdtypes 系统目录表中其
extended_id 值与您正在设置的 distinct 类型相匹配的行的 type 列中的
值。
要获取更多关于 sysxtdtypes 系统目录表的信息，请参阅 GBase 8s SQL 参考指
南。
GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 998
修改由 DESCRIBE 语句设置的值
您可使用 DESCRIBE 语句来修改系统描述符区域的内容，在它被设置之后。
您在 SELECT 或 INSERT 语句上使用 DESCRIBE 之后，必须检查以确定将
TYPE 字段设置为 11 还是 12 来表示 TEXT 或 BYTE 数据类型。如果
TYPE 包含 11 或 12，则您必须使用 SET DESCRIPTOR 语句来将 TYPE 重
置为 116，来表示 FILE 类型。