宿主变量.doc

宿主变量 宿主变量（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语句都可以访问主变量。 ??? 另外，在定义宿主变量时也可以使用client-library定义的数据类型，如：CS_CHAR。这些定义存放在cspublic.h文件中。如： EXEC SQL BEGIN DECLARE SECTION; CS_CHAR user[30],passwd[30]; EXEC SQL END DECLARE SECTION; ??? client-library定义的数据类型共有：CS_BINARY、CS_BIT、CS_BOOL、CS_CHAR、CS_DATETIME、CS_DATETIME4、CS_DECIMAL、CS_FLOAT、CS_REAL、CS_IMAGE、CS_INT、CS_MONEY、CS_MONEY4、CS_NUMERIC、CS_RETCODE、CS_SMALLINT、CS_TEXT、CS_TINYINT、CS_VARBINARY、CS_VARCHAR、CS_VOID。 ??? 为了便于识别主变量，当嵌入式SQL语句中出现主变量时，必须在变量名称前标上冒号“： ”。冒号的作用是，告诉预编译器，这是个主变量而不是表名或列名。不能在声明时，初始化数组变量。 ??? 由上可知，SYBASE SQL SERVER使用宿主变量传递数据库中的数据和状态信息到应用程序，应用程序也通过宿主变量传递数据到SYBASE数据库。根据上面两种功能，宿主变量分为输出宿主变量和输入宿主变量。在SELECT INTO和FETCH语句之后的宿主变量称作“输出宿主变量”，这是因为从数据库传递列数据到应用程序。如： exec sql begin declare section; CS_CHAR id[5]; exec sql end declare section; exec sql select title_id into :id from titles； where pub_id = 0736 and type = business; 除了SELECT INTO和FETCH语句外的其他SQL语句（如：INSERT、UPDATE等语句）中的宿主变量，称为“输入宿主变量”。这是因为从应用程序向数据库输入值。如： exec sql begin declare section; CS_CHAR id[7]; CS_CHAR publisher[5]; exec sql end declare section; ... exec sql delete from titles where title_id = :id; exec sql update titles set pub_id = :publisher where title_id = :id; ??? 另外，也可以通过宿主变量获得存储过程的执行状态信息。如： exec sql begin declare section; CS_SMALLINT retcode; exec sql end declare section; exec sql begin transaction; exec sql exec :retcode = update_proc; if (retcode != 0) { exec sql rollback transaction; ???也可以通过宿主变量获得存储过程的返回值。如： ??? exec sql exec a_proc :par1 out, :par2 out; ??? 主变量的数据类型 ??? SYBASE SQL SERVER支持的数据类型与程序设计语言支持的数据类型之间有很大差别。这些差别对主变量影响很大。一方面，主变量是一个用程序设计语言的数据类型说明并用程序设计语言处理的程序变量；另一方面，在嵌入SQL语句中用主变量保存数据库数据。所以，在嵌入SQL语句中，必须映射C数据类型为合适的SQL Server数据类型。