本文档讲述数据库嵌入式
SQL/C语言程序从ESQLC向PROC移植过程中所进行的分析、移植过程，并讲述如何编写可通用的嵌入式SQL/C语言程序。
作者：余军，
2007年5月9日
第一部分：ESQLC，PROC差异性分析
一．基本语法
1．语法字符
ESQLC中既支持‘
$’数据库语法，同时也支持“EXEC SQL”，‘:’数据库语法
PROC中只支持“
EXEC SQL”，‘:’数据库语法
2．数据库变量定义
ESQLC中支持
3种表达方法
方法
1，
$int nValue;
$char strValue[20];
方法
2（会有警告，但不影响编译及运行结果），
EXEC SQL int nValue;
EXEC SQL char strValue[20];
方法
3，
EXEC SQL BEGIN DECLARE SECTION;
int nValue;
char strValue[20];
EXEC SQL END DECLARE SECTION;
PROC中支持
2种表达方法
方法
1，不加任何修饰，即与非数据库变量的定义相同
方法
2，
EXEC SQL BEGIN DECLARE SECTION;
int nValue;
char strValue[20];
EXEC SQL END DECLARE SECTION;
3．数据库变量的使用
ESQLC中对‘
$’，‘:’均能支持
PROC中只能用‘
:’
4．基本的SQL语句（查询、插入、删除、修改）
ESQLC，
sql语句中可以用数据库变量，也可以用常量，如where name= '张三'
PROC，
sql语句中只能用数据库变量，如where name= :m_name
二．高级SQL操作（游标等）
1．数据库打开、关闭操作
ESQLC中打开数据库使用
database 数据库名，关闭数据库使用database close
PROC中打开数据库使用
CONNECT :username IDENTIFIED BY :password，不用关闭
2．事务操作
ESQLC中语法
打开事务，
begin work;
提交事务，
commit work;
回滚事务，
rollback work;
PROC中语法
打开事务，不写
提交事务，
commit work;
回滚事务，
rollback;
3．游标操作
游标基本语法
定义游标，
declare cur名称 cursor for sql语句
打开游标，
open cur_1或open cur_1 using :con1,:con2
Fetch游标，
fetch cur_1或fetch cur_1 into :val1,:val2
关闭游标，
close cur_1
释放游标，
free cur_1
两平台区别：
sql语句区别同基本
sql语句，PROC中不能用用常值（where name= '张三'），只能用数据库变量（where name= :m_name）。
PROC中不能释放游标，而
ESQLC中要求释放游标。
三．数据库操作运行结果
1．表达符
ESQLC中一般采用
SQLCODE，也可采用sqlca.sqlcode
PROC中只能用
sqlca.sqlcode。
2．常用数值含义
开发阶段
含义
Informix，
ESQL/C
Oracle，
PROC
插入时列数不匹配
-236
（待查）
字段不存在
-217
（待查）
运行阶段
含义
Informix，
ESQL/C
Oracle，
PROC
找到数据
0
0
找不到数据
100
1403
插入时重复
-239
-1
找到记录不唯一
（待查）
（待查）
范围超限
（待查）
1480
找到值为
NULL
（待查）
-1405
其他（待续）
四．程序的编译及链接
1．基本命令
ESQLC预编译命令
esql
PROC预编译命令
proc
2．编译语法
ESQLC中
makefile的一般写法
CC=cc
ECC=$(INFORMIXDIR)/bin/esql
.SUFFIXES:.ec
.SUFFIXES:.c
.ec.o:
$(ECC) -c $*.ec
rm -f $*.c
.c.o:
$(CC) -c $*.c
PROC中
makefile的一般写法
CC=cc
PROC=proc userid=用户名
/密码 sqlcheck=full char_map=string
INCLUDE=头文件目录
CFLAGS=编译参数
.SUFFIXES:.c
.SUFFIXES:.pc
.pc.o:
$(PROC) $(INCLUDE) iname=$*.pc oname=$*.c
$(CC) -I$(INCLUDE) $(CFLAGS) -c -o $*.o $*.c
rm -f $*.c
rm -f $*.lis
.c.o:
$(CC) -I$(INCLUDE) $(CFLAGS) -c -o $*.o $*.c
3．链接语法
ESQLC中，
$(ECC) -o 可执行文件 链接文件1 连接文件2 …
PROC中，
$(CC) -o 可执行文件 链接文件1 连接文件2 …
其中链接文件，可以事
obj文件，静态库文件，源文件等。
第二部分：移植步骤
不同风格的
ESQLC程序，采用不同的移法，总之越接近PROC，则越容易移植，这里讲述与PROC风格相差最大的ESQLC程序（采用‘$’作为数据库操作标识符）的移植方法。
一．程序移植
编辑工具采用
UltraEdit，应用多文件替换操作。
1．程序修改
步骤
1，先修改操作语句，即将‘$’修改“EXEC SQL ”
Informix，
ESQL/C
Oracle，
PROC
"$select "
"EXEC SQL select "
"$insert "
"EXEC SQL insert "
"$update "
"EXEC SQL update "
"$delete "
"EXEC SQL delete "
"$prepare "
"EXEC SQL prepare "
"$declare "
"EXEC SQL declare "
"$open "
"EXEC SQL open "
"$fetch "
"EXEC SQL fetch "
"$close "
"EXEC SQL close "
"$free "
"EXEC SQL free "或
"free_cursor()"
"$begin work"
"EXEC SQL begin work"或
"begin_work()"
"$commit work"
"EXEC SQL commit work"
"$rollback work"
"EXEC SQL rollback"或
"rollback_work()"
"$database "
"EXEC SQL database "或
"open_database()"
步骤
2，将剩下的‘$’全部替换成‘:’
步骤
3，手工修改各数据库变量定义部分
步骤
4，将打开数据库语句更新成open_database()
步骤
5，编写相应的函数open_database(),free_cursor(),begin_work(),rollback_work()等，函数实体程序根据相应数据库平台的语法即可。
步骤
6，在公共头文件中宏定义#define SQLCODE sqlca.sqlcode
步骤
7，用PROC的makefile文件，进行重新编译，再细微调整错误的地方。
2．Makefile文件的编写
步骤
1，更改相应的编译变量
$(CC)也改成相应环境下的
C编译器
$(ECC)=xxx改成
$(PROC)=xxx
步骤
2，修改.ec到.o的编译方法
.ec.o:
$(PROC) $(INCLUDE) iname=$*.ec oname=$*.c
$(CC) -I$(INCLUDE) $(CFLAGS) -c -o $*.o $*.c
rm -f $*.c
rm -f $*.lis
步骤
3，修改连接方法
将
$(ECC)修改成$(CC)。
二．数据库移植
1．表结构的移植
软件工具
powdesinger
步骤
1，利用反向工程，从原来的INFORMIX数据库中生成PDM图表文件
步骤
2，更改当前数据库连接，新的连接为ORACLE数据库
步骤
3，生成SQL语句。
步骤
4，将该SQL语句在ORACLE环境中执行即可。
2．数据的移植
不同的数据库之间，采用文本文件移植较为安全
步骤
1，从INFORMIX库中导出所有表，可以用dbexport，也可以用shell文件执行unload to xx.txt select * from xx表
步骤
2，将文本文件传到可以导入ORACLE的位置。
步骤
3，编写ORACLE的sqlldr控制文件，执行即可。
第三部分：如何编写两个平台通用的C程序
在项目实施过程中，一个产品往往流程完全一致，但不同的客户可能数据库平台有区别，作为软件开发商或供应商，如果同时提供两个版本，很容易造成版本不统一，加大了维护成本，所以必须找到一个方法使两个版本程序能尽可能的复用。经过本人的实践，最后做出只需要修改一个宏定义，就可以实现程序在两个平台间的共用。
1．程序文件名的统一
ESQLC中只支持扩展名
=ec的ESQLC程序，而PROC中可支持任意扩展名的PROC程序，所以我们将程序名称统一成xxx.ec
2．数据库公共宏定义
/*
#define DB_IS_INFORMIX
*/
#define DB_IS_ORACLE
#ifdef DB_IS_INFORMIX
#define SQL_DATA_FIND 0
#define SQL_NO_DATA_FIND 100
#else
#define SQL_DATA_FIND 0
#define SQL_NO_DATA_FIND 1403
#endif
3．部分数据库公共操作函数
EXEC SQL include sqlca;
//打开数据库
int open_database()
{
EXEC SQL BEGIN DECLARE SECTION;
char username[50];
char password[50];
EXEC SQL END DECLARE SECTION;
memset(username, 0, sizeof(username));
memset(password, 0, sizeof(password));
strcpy(username, "数据库用户名");
strcpy(password, "数据库用户密码");
#ifdef DB_IS_INFORMIX
EXEC SQL database 数据库库名;
#else
EXEC SQL connect :username identified by :password;
#endif
}
//开始事务
int begin_work()
{
#ifdef DB_IS_INFORMIX
EXEC SQL begin work;
if(sqlca.sqlcode){
printf("begin_work error:%d/n", sqlca.sqlcode);
return -1;
} else{
return 0;
}
#else
return 0;
#endif
}
//回滚事务
int rollback_work()
{
#ifdef DB_IS_INFORMIX
EXEC SQL rollback work;
#else
EXEC SQL rollback;
#endif
if(sqlca.sqlcode){
printf("rollback_work error:%d/n", sqlca.sqlcode);
return -1;
} else{
return 0;
}
}
结束！
