esql编程使用说明.txt

db2 指定某个字符串中的第几个字符的更新

 
 >> ChinaUnix.net > SCO  
 


[转帖]ESQL编程使用说明 （有朋友需要的） 

 
作者：sdccf     发表时间：2002/12/21 07:56am
 
ESQL编程使用说明 

第一章  ESQL介绍 


    本章对ESQL做一概括介绍,主要讨论怎么使用ESQL、ESQL的基本的概念和定义、ESQL程序的各个部分和ESQL 程序中语句的类型.
    SQL语言是非过程化语言,大部分语句的执行与其前面或后面的语句无关,而一些高级编程语言都是基于如循环,条件等结构的过程化语言,尽管SQL语言非常有力,但它却没有过程化能力.若把SQL语言嵌入到过程化的编程语言中,则利用这些结构,程序开发人员就能设计出更加灵活的应用系统,具有SQL语言和高级编程语言的良好特征,它将比单独使用SQL或C语言具有更强的功能和灵活性.
    COBASE RDBMS提供两种工具在主语言中编程来存取COBASE数据库中的数据.即高级语言预编译程序接口(ESQL)和高级语言的函数调用接口(CCI).目前这些工具仅支持C语言.
    COBASE  RDBMS提供的ESQL工具把含有SQL语句的C程序转化为可存取和操纵COBASE数据库中数据的C程序,作为一编译器,ESQL把输入文件中的EXEC SQL 语句在输出文件中转化为适当的CCI函数调用.输出文件则可以正常的C程序的方式被编译、连接和执行.
  

1.1 ESQL中的基本概念 

   ESQL中的基本概念主要有:
   1.嵌入的SQL语句:
     嵌入的SQL语句是指在应用程序中使用的SQL语句.该应用程序称作宿主程序,书写该程序的语言称作宿主语言.嵌入的SQL语句与交互式SQL语句在语法上没有太大的差别,只是嵌入式SQL语句在个别语句上有所扩充.如嵌入式SQL中的SELECT语句增加了INTO子句,以便与宿主语言变量打交道.此外,嵌入式SQL为适合程序设计语言的要求,还增加了许多语句,如游标的定义、打开和关闭语句等等. 
   2.执行性SQL语句和说明性SQL语句:
     嵌入的SQL语句主要有两种类型:执行性SQL语句和说明性SQL语句.执行性SQL语句可用来连接COBASE,定义、查询和操纵COBASE数据库中的数据,每一执行性语句真正对数据库进行操作 ,执行完成后,在USERCA中存放执行信息.说明性语句用来说明通讯域和SQL语句中用到的变量. 说明性语句不生成执行代码,对USERCA不产生影响. 
   3.事务:
     事务是逻辑上相关的一组SQL语句.COBASE把它们视作一个单元.为了保持数据库的一
致性,一事务内的所有操作要么都做,要么都不做. 


1.2 ESQL程序的组成和运行 

    在ESQL程序 中嵌入的SQL语句以EXEC作为起始标识,语句的结束以";"作为标识.在嵌入的SQL语句可以使用主语言(这时是C语言)的程序变量(即主变量),这时主变量名前加冒号(:)作为标志,以区别于字段名.
    ESQL程序包括两部分:程序首部和程序体.程序首部定义变量,为ESQL程序做准备, 程序体包括各种SQL语句来操纵COBASE数据库中的数据. 

    编制并运行ESQL程序比单独使用纯C语言多一个预编译过程,通常具有以下几个步骤: 

    1.编辑ESQL程序(可利用编辑软件如: EDLIN, WS等进行编辑).程序保后缀为.ec.
    2.使用COBASE的预编译器ETE对ESQL源程序进行预处理,该编译器将源程序中嵌入的SQL语言翻译成标准C语言,产生一个C语言编译器能直接进 行编译的文件.其文件的扩展名为.cpp。该cpp文件可以和普通的cpp文件一样被放入一个工程中被C++编译器编译，连接最后运行。 

    对COBASE的预编译器的使用的详细说明见第六章. 



第二章   ESQL 程序的基本结构 


    ESQL程序由两部分组成:程序首部和程序体. 


2.1 程序首部 

   每一个ESQL程序的开始,就是程序的首部,它包括以下三部分:
    1.DECLARE部分:
      说明特殊的主变量,这些变量区别于纯C语言程序中的变量,COBASE使用这些变量与程序之间相互作用. 
    2.INCLUDE USERCA语句: 说明一个SQL语句的通讯域(USERCA),它提供了错误处理,其功能等价于代替C语言中的#INCLUDE语句. 
   3.CONNECT语句: 建立程序与COBASE之间的连接. 


2.1.1DECLARE部分:(描述部分) 

    在DECLARE SECTION (描述部分),定义所有在SQL语句中用到的主变量,定义部分是以: 

         EXEC  SQL   BEGIN DECLARE  SECTION; 

      和  EXEC  SQL  END  DECLARE  SECTION;
     开始和结束的.
    在这两个语句中,只可以定义 SQL 语句中用到的主变量,每个预编译单元只允许一个BEGIN/END  DECLARE SECTION  (描述部分),但是一个程序可以包含许多独立的预编译单元。若一个主变量或指示变量在ESQL程序中的SQL语句中引用,但它没有在 描述部分中定义,则程序在预编译时就会出现错误信息.
    在这两个语 句中可以定义的变量有六种类型:INT,SHORT,CHAR,FLOAT,NUMBER,DATE.其中CHAR型允许定义二维数组,其它类型只允许定义一维数组,不允许有指针类型 ,在此处变量可以赋值.
   例如:
      EXEC  SQL BEGIN  DECLARE  SECTION;
      int  sno;
      char  sname[11];
      short  snameid;
    EXEC SQL END  DECLARE  SECTION;          
     (1)主变量:
    就是用在SQL语句中的主语言变量.主要用于程序变量和数据库内部交换数据之用,它们的数据类型必须是在主语言中描述部分里定义过的,而且它们的数据类型必须和COBASE数据库中已定义的表中的数据类型相匹配.
   例如:
        SELECT  姓名, 等级
        FROM  供应商
        INTO  :sname, :status
        WHERE  供应商号=:sno;
     该语句表示,从供应商表中在供应商号与主变量sno一致的地方选择供应商姓名和供应商等级,COBASE把结果传送到主变量sname,status中.
    主变量使用规则:
      1.必须在描述部分明确定义.
      2.必须使用与其定义相同的大小写格式.
      3.在SQL语句中使用主变量时必须在主变量前写一个冒号":",在纯C语言 语句中则不要在主变量前写冒号.
      4.不能是SQL命令的保 留字.
      5.在一条语句中只能使用一次.
   
2.1.2  SQL通讯域 

     每个COBASE应用程序必须提供对错误 的处理,为了说明SQL通讯域(USERCA),必须在每个COBASE预编译程序中写上: 

     EXEC SQL  INCLUDE  USERCA; 

     USERCA是一结构,每一嵌入的执行性SQL语言的执行情况在其执行完成后写入USERCA结构中的各变量中, 根据USERCA中的内容可以获得每一嵌入SQL语句执行后的信息,编制程序时就可以做适当的处理.对其的详细说明见第五章. 


2.1.3  连接COBASE 

    在 存取COBASE数据之前,每一个预编译程序必须与COBASE连接.连接时,程序必须提供用户名和口令,由COBASE进行校验,若口令和用户名正确,方可登录COBASE,获得使用权,否则,COBASE拒绝登录,则程序就不能使用数据库.缺省的用户名为“cobase”，口令为“cobase”。
    连接COBASE的格式如下: 

           EXEC SQL CONNECT <用户名>:<用户口令>. 
  CONNECT语句必须是ESQL程序中第一条可执行的SQL语句. 


2.2  程序体 

   程序体可以包含许多SQL语句,以查询或处理存储在COBASE数据库中的数据.
   在应用程序中所包含的SQL语句,可以查询或操纵存储在COBASE中的数据,这些语句叫
做数据操纵语言(DML),应用程序体也可以包含DDL语句,用来建立或定义数据结构,如表、视图或索引.在用户程序中写入的任何有效的SQL语句都可以被执行，只需要把完整的SQL语句按嵌入式的要求写入C语言的合适位置即可.嵌入在C语言中的SQL语句以EXEC SQL 开始,以";"为结束标志.SQL语句中可以嵌入主变量,主变量前应有":"标志.如下面例子都 是嵌入式SQL语句: 

          EXEC SQL  UPDATE  供应商  
                    SET  姓名='李 红'
                    WHERE  供应商号='S1';
           /* 把供应商号是S1的供应商姓名改为 '李 红'*/ 

          EXEC SQL  INSERT  INTO 供应商(供应商号,姓名,等级,城市)
                    VALUES((:sno,:sname,:status,:city));
           /* 根据宿主变量值插入供应商表中 */
 
          EXEC SQL   DELETE FROM 供应商
                     WHERE   等级 IS NULL; 

           /*删除供应商等级是空值的供应商*/ 

   从上面例可以看出,静态的增,删,改语句与交互方式没有太大的差别,对于查询语句就没有那么简单,查询语句在下一章中介绍. 

   现用几个例题程序加以说明. 

例题程序1    (建立一表并向表中插入数据) 


/*==============================================================================
          This is a sample program which include SQL sentence about 
          CREATE ,INSERT a table.
==============================================================================*/ 

EXEC SQL BEGIN DECLARE SECTION ;
  CHAR  sno[10],sname[10],city[10];
  INT   status;
EXEC SQL END DECLARE SECTION ;
EXEC SQL INCLUDE USERCA; 

main()
{
int i;
EXEC SQL CONNECT "cobase:cobase" ; 

EXEC SQL  CREATE TABLE S_TEST        /* Create a table named S_TEST */
         (SNO  CHAR (9),
          SNAME CHAR (20),
          STATUS INT ,CITY CHAR(10)); 

printf(" create table success,insert?");
printf("     0 ---- no  ");
printf("     1 ---- yes  ");
printf("   choice:");
scanf("%d",&i);
while(i)
{
printf("input sno:");
scanf("%s",sno);
printf("input sname:");
scanf("%s",sname);
printf("input status:");
scanf("%d",&status);
printf("input city:");
scanf("%s",city);
EXEC  SQL INSERT INTO S_TEST(SNO,SNAME,STATUS,CITY)
                   VALUES ((:sno,:sname,:status,:city));
printf("continue?");
printf("     0 ----terminate    ");
printf("     1 ----continue    ");
printf("   choice:");
scanf("%d",&i); 

}
EXEC SQL COMMIT;
EXEC SQL DISCONNECT;   /*log off database*/
exit(0);
} 


例题程序2    (修改和删除表中的数据) 

/*=============================================================================
          This is a sample program which include SQL sentence about 
          UPDATE,DELETE  a table.
==============================================================================*/ 

EXEC SQL BEGIN DECLARE SECTION ;
  CHAR sno[10],sname[10],city[10];
  INT status;
EXEC SQL END DECLARE SECTION ;
EXEC SQL INCLUDE  USERCA; 

main()
{
int i;
printf("Now exec connect ...");
EXEC SQL CONNECT "COBASE:COBASE" ;

printf(" update?");
printf("     0 ---- no   ");
printf("     1 ---- yes   ");
printf("   choice:");
scanf("%d",&i);
while(i)
{
printf("input sno:");
scanf("%s",sno);
printf("input sname:");
scanf("%s",sname);
printf("input status:");
scanf("%d",&status);
printf("input city:");
scanf("%s",city); 

EXEC SQL UPDATE S_TEST  SET  sname=:sname,city=:city ,status=:status
        WHERE sno=:sno; 

printf(" continue?");
printf("     0 ----no    ");
printf("     1 ----yes    ");
printf("   choice:");
scanf("%d",&i);
}
printf(" delete?");
printf("     0 ---- no   ");
printf("     1 ---- yes   ");
printf("   choice:");
scanf("%d",&i);
while(i)
{
printf("input sno:");
scanf("%s",sno); 

EXEC SQL  DELETE FROM  S_TEST WHERE  sno=:sno; 

printf(" continue?");
printf("     0 ----no    ");
printf("     1 ----yes    ");
printf("   chioce:");
scanf("%d",&i); 

} 

EXEC SQL  COMMIT;
EXEC SQL  DISCONNECT;
exit(0);
}