pro*c宿主变量和指示变量

宿主变量

(1)在SQL 应用程序中，一个嵌入的SQL语句引用的变量；

(2)在RPG语言中，同field;

(3)在COBOL语言中，同data item。

宿主变量（host variable）就是在嵌入式SQL语句中引用主语言说明的程序变量（如例中的user[31]变量）。如：

EXEC SQL BEGIN DECLARE SECTION;

char user[31],passwd[31];

EXEC SQL END DECLARE SECTION;

exec sql connect :user identified by :passwd;

在嵌入式SQL语句中使用主变量前，必须采用BEGIN DECLARE SECTION 和END DECLARE SECTION之间给主变量说明。这两条语句不是可执行语句，而是预编译程序的说明。主变量是标准的C程序变量。嵌入SQL语句使用主变量来输入数据和输出数据。C程序和嵌入SQL语句都可以访问主变量。

指示变量

• 指示器变量是与宿主变量相关联的一类SQL变量，它被用来监督和管理与其相关联的宿主变量，每一个宿主变量都可以定义一个指示器变量。指示器变量的具体作用如下：

（1） 向数据库表列输入NULL值

（2） 检查从数据库表列中选取的数据是否是NULL值，或是否发生截断问题

• 指示变量必须被定义为2 个字节的整数类型（short）

• 在SQL 语句中，如果没有指定INDICATOR 关键字，指示变量必须紧跟在与其关联的宿主变量后

• 如果使用DECLARE SECTION 声明宿主变量，则相关指示变量也必须用DECLARE SECTION 进行声明

• 在SQL 语句中指示变量前也需要加入“:”指示符

:host_variable INDICATOR :indicator_variable

等效于

:host_variable:indicator_variable

• 指示变量的值，及其代表的含义如下：

Ø 0 操作成功

Ø -1 该指示变量对应的宿主变量返回了或插入、更新成了NULL 值

Ø -2 从数据库存放数据到对应的宿主变量时，数据超长，并且不能推断出截断了多少字节的长度

Ø >0 在FETHC 或SELECT 语句时，因数据超长而被截断存放在了对应的宿主变量中，指示变量存放对应列的长度

• 如果不用指示变量在SELECT或FETCH语句中将一个NULL值赋给宿主变量时，Oracle会报1405 错误。为了避免这种情况，可以采用两种解决方法：

Ø 使用指示变量

Ø 调整Pro*C/C++预编译程序proc 的命令行参数，设定MODE=ORACLE，UNSAFE_NULL=YES

指示器变量的引用:

在SQL语句中，指示器变量名字前应加冒号，而且必须在其相关联的宿主变量之后。在C语言中，指示器变量如同C变量一样独立使用，不须前缀冒号，也不须跟在相关宿主变量之后。例如：

EXEC SQL SELECT EMPN()

INTO::emp_number：ind_num

FROM EMP

WHERE ENAME = :emp_name；

If （ind_num = -1）

{

Printf（“employlee number is NULL！”）；

}

为了增进可读性，可以再宿主变量及其指示器变量之间加INDICATOR关键词。如：

EXEC SQL SELECT EMPNO

INTO:emp_number INDICATOR:ind_num

FROM EMP

WHERE ENAME = :emp_name；

指示器变量的应用举例：

例1：向数据库表列中插入NULL值

Printf（“enter department number and name”）；

Scanf（“%d%s”， &dept_number， dept_name）；

If （dept_number = 0）

{

Ind_num = -1；

}

else

{

Ind_num = 0;

}

EXEC SQL INSERT INTO DEPT(DEPTNO,DNAME)VALUES(:dept_number:ind_num, :dept_name)

其中ind_num是dept_number的指示器变量，当输入的dept_number的值是0的时候，则向DEPT表的DEPTNO列插入NULL值

例2：检查从数据库表列中检索的值是否为NULL

EXEC SQL BEGIN DECLARE SECTION;

int emp_number;

float salary, commission;

short ind_comm; /* 指示变量 */

EXEC SQL END DECLARE SECTION;

EXEC SQL SELECT SAL, COMM

INTO :salary, :commission:ind_comm

FROM EMP

WHERE EMPNO = :emp_number;

if( -1 == ind_comm ) /* commission变量是NULL */

pay = salary;

else

pay = salary + commission;

顶