ecpg-sql-set-descriptor.md

## 设置描述符

SET DESCRIPTOR — 在 SQL 描述符区域中设置信息

## 概要

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

## 描述

`设置描述符`用值填充 SQL 描述符区域。然后，描述符区域通常用于在准备好的查询执行中绑定参数。

该命令有两种形式： 第一种形式适用于描述符“标题”，它独立于特定数据。第二种形式将值分配给由数字标识的特定基准。

## 参数

*`描述符名称`*

描述符名称。

*`描述符标题项`*

标识要设置哪个标头信息项的标记。仅有的`数数`, 设置描述符项的数量，目前支持。

*`数字`*

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

*`描述符项`*

标识要在描述符中设置的信息项的标记。看[第 36.7.1 节](ecpg-descriptors.html#ECPG-NAMED-DESCRIPTORS)获取支持的项目列表。

*`价值`*

要存储到描述符项中的值。这可以是 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;
```

## 兼容性

`设置描述符`在 SQL 标准中指定。

## 也可以看看

[分配描述符](ecpg-sql-allocate-descriptor.html),[获取描述符](ecpg-sql-get-descriptor.html)