GBase 8s 数据库ALLOCATE COLLECTION语句介绍

使用 ALLOCATE COLLECTION 语句为集合数据类型的变量（例如 LIST 、MULTISET 或 SET ）或未归类的集合变量分配内存。 

语法

 

用法
该语句是 SQL ANSI/ISO 标准的扩展。在 ESQL/C 中使用此语句。

ALLOCATE COLLECTION 语句为可以存储 collection 数据类型的值的 ESQL/C  变量分配内存。要为GBase 8s ESQL/C程序创建集合变量：

1. 在 GBase 8s ESQL/C 程序中作为客户机集合变量声明集合变量。
   集合变量可以是已归类或未归类的集合变量。
2. 使用 ALLOCATE COLLECTION 语句为集合变量分配内存。
   如果分配内存成功，ALLOCATE COLLECTION 语句会将 SQLCODE （也就是 sqlca.sqlcode）置
   零（0）；如果失败，会将其设置成一个负数错误码。
   当不再需要集合变量时，您必须使用 DEALLOCATE COLLECTION 语句显示地释放内存。在
   DEALLOCATE COLLECTION 语句执行成功后，您可以重新使用该集合变量。

提示： ALLOCATE COLLECTION 语句仅为 GBase 8s ESQL/C 集合变量分配内存。要为 GBase 8s ESQL/C 行变量分配内存，请使用 ALLOCATE ROW 语句。
示例
以下示例显示如何使用 ALLOCATE COLLECTION 语句为未归类的集合变量 a_set 分配资源：EXEC SQL BEGIN DECLARE SECTION;
client collection a_set;
EXEC SQL END DECLARE SECTION;
. . .
EXEC SQL allocate collection :a_set;
以下示例显示如何使用 ALLOCATE COLLECTION 语句为已归类的集合变量 a_typed_set 分配资源：
EXEC SQL BEGIN DECLARE SECTION;
client collection set(integer not null) a_typed_set;
EXEC SQL END DECLARE SECTION;
. . .
EXEC SQL allocate collection :a_typed_set;